Il servizio avanzato di Calendar consente di utilizzare l'API pubblica di 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 dell'utente in Google Calendar, inclusi i calendari aggiuntivi a cui l'utente è iscritto. Nella maggior parte dei casi, il servizio integrato è più facile da usare, 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 la documentazione di riferimento per l'API pubblica di Google Calendar. Come tutti i servizi avanzati in Apps Script, il servizio avanzato di Calendar utilizza gli stessi oggetti, metodi e parametri dell'API pubblica. Per ulteriori informazioni, consulta la sezione Come vengono determinate le firme dei metodi.
Per segnalare problemi e trovare ulteriore assistenza, consulta la 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 la documentazione di riferimento.
Codice campione
Il codice campione riportato di seguito utilizza la versione 3 dell'API.
Creare eventi
L'esempio seguente mostra come creare un evento nel calendario predefinito dell'utente.
Elenco dei calendari
L'esempio seguente mostra come recuperare i dettagli sui calendari visualizzati nell'elenco di calendari dell'utente.
Eventi scheda
L'esempio seguente mostra come elencare i prossimi 10 eventi imminenti nel calendario predefinito dell'utente.
Modificare in modo condizionale un evento
L'esempio seguente mostra come aggiornare in modo condizionale un evento di Calendar utilizzando l'intestazione If-Match
. Lo script crea un nuovo evento, attende 30 secondi, quindi
aggiorna l'evento solo se non sono stati modificati i dettagli dell'evento dopo la sua
creazione.
Recupero condizionale di un evento
L'esempio seguente mostra come recuperare in modo condizionale un evento di Calendar utilizzando l'intestazione If-None-Match
. Lo script crea un nuovo evento, quindi
esegue il polling dell'evento per 30 secondi. Ogni volta che l'evento cambia, viene recuperata la nuova versione.
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 stati modificati da quando è stato generato il token, consentendo un'elaborazione più efficiente. Consulta Sincronizzare le risorse in modo efficiente per maggiori dettagli sul processo di sincronizzazione.
L'esempio seguente utilizza lo stesso metodo getRelativeDate(daysOffset, hour)
definito negli esempi precedenti.