O serviço avançado do Google Agenda permite usar a API Google Calendar pública no Apps Script. Assim como o serviço integrado do Google Agenda do Apps Script, essa API permite que os scripts acessem e modifiquem o Google Agenda do usuário, incluindo outras agendas a que ele está inscrito. Na maioria dos casos, o serviço integrado é mais fácil de usar, mas esse serviço avançado oferece alguns recursos extras, incluindo a definição da cor de fundo para eventos individuais.
Referência
Para informações detalhadas sobre esse serviço, consulte a documentação de referência da API pública Google Agenda. Assim como todos os serviços avançados no Apps Script, o serviço avançado do Google Agenda usa os mesmos objetos, métodos e parâmetros que a API pública. Para mais informações, consulte Como as assinaturas de método são determinadas.
Para denunciar problemas e encontrar outras opções de suporte, consulte o guia de suporte do Google Agenda.
Cabeçalhos da solicitação HTTP
O serviço avançado da Agenda pode aceitar os cabeçalhos de solicitação HTTP
If-Match
e If-None-Match
. Para mais detalhes, consulte a
documentação de referência.
Código de amostra
O exemplo de código abaixo usa a versão 3 da API.
Criar eventos
O exemplo a seguir mostra como criar um evento no calendário padrão do usuário.
Como listar agendas
O exemplo a seguir demonstra como recuperar detalhes sobre os calendários mostrados na lista de calendários do usuário.
Listar eventos
O exemplo a seguir mostra como listar os próximos 10 eventos na agenda padrão do usuário.
Modificar um evento condicionalmente
O exemplo a seguir mostra como atualizar condicionalmente um evento da Agenda usando
o cabeçalho If-Match
. O script cria um evento, espera 30 segundos e atualiza o evento somente se nenhum detalhe tiver mudado desde a criação.
Recuperar um evento condicionalmente
O exemplo a seguir mostra como buscar condicionalmente um evento do Google Agenda usando
o cabeçalho If-None-Match
. O script cria um novo evento e pesquisa mudanças nele por 30 segundos. Sempre que o evento muda, a nova versão é buscada.
Sincronizar eventos
O exemplo a seguir demonstra como recuperar eventos usando tokens de sincronização. Quando você inclui um token de sincronização em uma solicitação do serviço avançado do Google Agenda, a resposta resultante inclui apenas itens que mudaram desde que o token foi gerado, permitindo um processamento mais eficiente. Consulte Sincronizar recursos de maneira eficiente para mais detalhes sobre o processo de sincronização.
O exemplo a seguir usa o mesmo método getRelativeDate(daysOffset, hour)
definido nos exemplos acima.