Il servizio avanzato di Calendar consente di usare API Google Calendar in Apps Script. Proprio come il servizio Calendar integrato di Apps Script, questa API consente agli script di accedere e modificare il calendario di Google Calendar dell'utente, ad esempio: altri calendari a cui l'utente è iscritto. Nella maggior parte dei casi, il servizio integrato è più facile da utilizzare, ma questo servizio avanzato offre alcune funzionalità aggiuntive, tra cui l'impostazione del colore di sfondo per i singoli eventi.
Riferimento
Per informazioni dettagliate su questo servizio, consulta documentazione di riferimento per il pubblico API Google Calendar. Come tutti i servizi avanzati di Apps Script, Il servizio Calendar utilizza gli stessi oggetti, metodi e parametri del servizio pubblico tramite Google Cloud CLI o tramite l'API Compute Engine. Per ulteriori informazioni, consulta la sezione Come vengono determinate le firme dei metodi.
Per segnalare problemi e ricevere ulteriore assistenza, consulta le Guida di assistenza di Calendar.
Intestazioni delle richieste HTTP
Il servizio avanzato di Calendar può accettare le intestazioni delle richieste HTTP
If-Match
e If-None-Match
. Per maggiori dettagli, consulta
documentazione di riferimento.
Codice di esempio
Il codice di esempio riportato di seguito utilizza la versione 3 di l'API.
Creare eventi
L'esempio seguente mostra come creare un evento nel valore predefinito dell'utente calendario.
Elenco dei calendari
L'esempio seguente mostra come recuperare i dettagli dei calendari visualizzati nell'elenco dei calendari dell'utente.
Eventi scheda
L'esempio seguente mostra come elencare i prossimi 10 eventi nel calendario predefinito dell'utente.
Modificare in modo condizionale un evento
L'esempio seguente mostra come aggiornare un evento di calendario in modo condizionale utilizzando l'intestazione If-Match
. Lo script crea un nuovo evento, attende 30 secondi, quindi
aggiorna l'evento solo se i dettagli dell'evento non sono stati modificati dopo che è stato
è stato creato.
Recupero condizionale di un evento
L'esempio seguente mostra come recuperare un evento di Calendario in modo condizionale utilizzando
l'intestazione If-None-Match
. Lo script crea un nuovo evento, quindi esegue il polling per verificare se sono presenti modifiche per 30 secondi. Ogni volta che l'evento cambia, la nuova versione
viene recuperato.
Sincronizzazione degli eventi
L'esempio seguente mostra come recuperare gli eventi utilizzando i token di sincronizzazione. Quando includi un token di sincronizzazione in una richiesta di servizio avanzato di Calendar, la risposta risultante include solo gli elementi che sono cambiati dal token per un'elaborazione più efficiente. Consulta Sincronizza le risorse in modo efficiente per maggiori dettagli su durante il processo di sincronizzazione.
L'esempio seguente utilizza lo stesso getRelativeDate(daysOffset, hour)
definito negli esempi precedenti.