O serviço avançado Agenda permite que você use a API Google Calendar pública no Apps Script. Assim como o serviço Google Agenda integrado do Apps Script, essa API permite que os scripts acessem e modifiquem o Google Agenda do usuário, incluindo agendas adicionais em que o usuário 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 do plano de fundo para eventos individuais.
Referência
Para informações detalhadas sobre esse serviço, consulte a documentação de referência da API Google Calendar pública. Assim como todos os serviços avançados no Apps Script, o serviço avançado do Agenda usa os mesmos objetos, métodos e parâmetros que a API pública. Para saber mais, consulte Como as assinaturas de método são determinadas.
Para relatar problemas e encontrar suporte, consulte o guia de suporte do Google Agenda.
Cabeçalhos de solicitação HTTP
O serviço avançado do Agenda pode aceitar os cabeçalhos de solicitação HTTP If-Match
e If-None-Match
. Para ver detalhes, consulte a documentação de referência.
Exemplo de código
O exemplo de código abaixo usa a versão 3 da API.
Criar eventos
O exemplo a seguir demonstra como criar um evento na agenda padrão do usuário.
Como listar agendas
O exemplo a seguir demonstra como recuperar detalhes sobre as agendas mostradas na lista de agendas do usuário.
Como listar eventos
O exemplo a seguir demonstra 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 do Agenda usando o cabeçalho If-Match
. O script cria um evento, aguarda 30 segundos e atualiza o evento somente se nenhum detalhe do evento foi alterado desde que ele foi criado.
Como recuperar condicionalmente um evento
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 consulta as alterações 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 de serviço avançado do Agenda, a resposta resultante inclui apenas itens que foram alterados desde que esse token foi gerado, permitindo um processamento mais eficiente. Consulte Sincronizar recursos de maneira eficiente para ver mais detalhes sobre o processo de sincronização.
O exemplo a seguir usa o mesmo método getRelativeDate(daysOffset, hour)
definido nos exemplos acima.