API do Google Calendar: eventos, disponibilidade e agendas com agentes de IA
A API do Google Calendar permite ler e gerenciar agendas, eventos e convidados, além de consultar horários livres e ocupados. É usada por ferramentas de agendamento, CRMs e sistemas internos. O acesso é por OAuth do usuário ou por conta de serviço com delegação no Google Workspace.
Os grandes recursos da API, em português claro.
Criar, atualizar, mover e cancelar eventos, com local, descrição e anexos.
Listar e gerenciar agendas de usuários, salas e recursos compartilhados.
Adicionar participantes e acompanhar quem aceitou ou recusou.
Consultar janelas livres de várias pessoas para propor horários.
Assinar canais para saber quando eventos de uma agenda mudam.
Criar o evento já com link de reunião do Google Meet.
Como se acessa a API do Google Calendar.
- Com credencial da sua empresaOAuth 2.0 com projeto no Google Cloud; em empresas, é comum usar conta de serviço com delegação em todo o domínio, autorizada pelo administrador do Workspace.
- Documentação oficialdevelopers.google.com/calendar
- Use o escopo mais restrito possível, como somente leitura quando o agente só consulta horários.
- Delegação em todo o domínio dá acesso amplo; limite a quais usuários o agente atende.
- Atenção a fuso horário e eventos recorrentes ao criar ou mover reuniões.
- api google calendar
- api do google calendar
- google calendar api eventos
- integração google calendar api
- google agenda api
- google calendar api disponibilidade
O que um agente do iTeam faz com a API do Google Calendar.
O agente SDR propõe horários livres do vendedor ao lead por WhatsApp e cria o evento com link do Meet quando o lead escolhe.
Quando alguém cancela, o agente busca a próxima janela comum, sugere aos participantes e atualiza o convite.
Uma hora antes, o agente monta um resumo do cliente a partir do CRM e envia ao responsável pelo evento.
O agente reserva salas conforme a lotação e libera reservas de reuniões canceladas.
Da credencial ao agente trabalhando, com aprovação.
Criar o projeto no Google Cloud
Ative a API do Calendar e crie as credenciais OAuth ou a conta de serviço, com os escopos mínimos de agenda.
Guardar a credencial no cofre do iTeam
Defina quais agentes podem só consultar disponibilidade e quais podem criar ou alterar eventos, e em quais agendas.
Testar com uma agenda piloto
Comece com poucas agendas e aprovação para convites externos; cada ação fica auditada.
Dúvidas sobre a API do Google Calendar.
A API do Google Calendar é gratuita?
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.
Preciso programar para usar a API do Google Calendar com o iTeam?
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ê.
Dá para ver a disponibilidade de várias pessoas pela API do Google Calendar?
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.