O serviço avançado Agenda permite que você use a API Google Calendar pública no Apps Script. Assim como o serviço integrado Agenda do Apps Script, essa API permite que os scripts acessem e modifiquem o Google Agenda do usuário, incluindo outras agendas em que o usuário se inscreveu. 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 configuraçã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 mais informações, consulte Como as assinaturas de método são determinadas.
Para relatar problemas e encontrar ajuda, consulte o Guia de suporte do Google Agenda.
Cabeçalhos da solicitação HTTP
O serviço avançado do Google 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.
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 novo evento, aguarda 30 segundos e atualiza o evento somente se nenhum detalhe do evento tiver sido alterado desde que ele foi criado.
Como recuperar um evento condicionalmente
O exemplo a seguir mostra como buscar condicionalmente um evento da Agenda usando o cabeçalho If-None-Match
. O script cria um novo evento e pesquisa as alterações por 30 segundos. Sempre que o evento é alterado, a nova versão é buscada.
Como 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 Google Agenda, a resposta resultante inclui apenas itens que foram alterados desde que o token foi gerado, permitindo um processamento mais eficiente. Consulte Sincronizar recursos com eficiência 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.