API do Google Calendar: eventos, disponibilidade e agendas com agentes de IA

Sim, de forma geral a API do Google Calendar não tem cobrança por uso, mas está sujeita a cotas. A conta do Google Workspace ou Gmail continua com seu plano normal.

Não necessariamente. A ferramenta HTTP do iTeam lê a documentação da API e aprende os endpoints, e o time de implantação configura credenciais, permissões e testes com você.

Sim. A consulta de livre/ocupado retorna os horários ocupados de várias agendas, o que permite ao agente propor horários comuns sem ver o conteúdo dos eventos.

O agente consulta a disponibilidade pelo recurso de horários livres e ocupados, escolhe um horário comum e cria o evento com convidados. Se o cliente pede para remarcar, ele propõe novas janelas e atualiza o mesmo evento. Em vendas, isso encurta a troca de mensagens. No iTeam, o agente de SDR pode agendar a demonstração direto na agenda do vendedor.

O caminho comum é uma conta de serviço com delegação de domínio, autorizada pelo administrador do Workspace, que permite agir nas agendas dos usuários listados. Alternativamente, cada pessoa concede acesso por OAuth 2.0. Na delegação, restrinja os escopos ao calendário e os usuários ao necessário, porque a permissão cobre todo o domínio se for mal configurada.

Não existe sandbox separado; a API do Calendar é a mesma de produção. Para testar, crie um projeto do Google Cloud de desenvolvimento e use agendas de teste, com eventos que você pode apagar. Com a tela de consentimento em modo de teste, só os usuários cadastrados como testadores conseguem autorizar. Evite ensaiar em uma agenda de diretoria.

Consegue: a consulta de livre e ocupado devolve apenas os intervalos, sem título nem participantes. Isso basta para achar um horário sem expor assunto de reunião. Se o agente precisar dos detalhes, é preciso permissão de leitura da agenda, e vale limitar a quem realmente precisa. Compartilhamento de agenda é configurado pela própria pessoa ou pelo administrador.

Com notificações push por canal de observação: você registra um endereço HTTPS e o Google avisa quando um calendário muda. O agente então busca o que alterou, usando um marcador de sincronização. Esses canais expiram, então é preciso renová-los, e o aviso não traz o conteúdo do evento, só a sinalização de que algo mudou.

Para a primeira conexão, ajuda: criar o projeto no Google Cloud, ativar a API do Calendar e configurar a conta de serviço ou o consentimento OAuth. Depois, o uso é de configuração. O trabalho mais pesado é definir regras, como horário comercial, duração padrão e quem pode ser convidado. Uma plataforma de agentes traz o conector pronto e deixa só a autorização.

Pode tecnicamente, mas cancelar mexe com a expectativa de outras pessoas. Deixe o agente remarcar dentro de regras claras, como mesma semana e mesmo participante, e peça confirmação humana para cancelamentos e para reuniões com a diretoria. Todo evento alterado deve avisar os convidados com uma mensagem coerente, e o registro de quem pediu a mudança fica guardado.

A documentação do Google não cobra pelo uso da API, que tem cotas por projeto e por usuário, e o erro de cota vem como resposta específica. O custo real está na licença do Workspace e no modelo de IA do agente. Em lotes grandes, espace as criações de eventos, porque o Calendar pode limitar a criação em rajada.