Mit dem erweiterten Kalenderdienst können Sie die öffentliche Google Calendar API in Apps Script verwenden. Ähnlich wie beim integrierten Kalenderdienst von Apps Script können Skripts mit dieser API auf den Google Kalender des Nutzers zugreifen und diesen ändern, einschließlich zusätzlicher Kalender, die der Nutzer abonniert hat. In den meisten Fällen ist der integrierte Dienst einfacher zu nutzen. Dieser erweiterte Dienst bietet jedoch einige zusätzliche Funktionen, z. B. das Festlegen der Hintergrundfarbe für einzelne Ereignisse.
Referenz
Ausführliche Informationen zu diesem Dienst finden Sie in der Referenzdokumentation zur öffentlichen Google Calendar API. Wie alle erweiterten Dienste in Apps Script verwendet auch der erweiterte Kalender dieselben Objekte, Methoden und Parameter wie die öffentliche API. Weitere Informationen finden Sie unter Wie Methodensignaturen bestimmt werden.
Informationen dazu, wie Sie Probleme melden und weitere Unterstützung erhalten, finden Sie im Support für Google Kalender.
HTTP-Anfrageheader
Der erweiterte Kalenderdienst akzeptiert die HTTP-Anfrageheader If-Match
und If-None-Match
. Weitere Informationen finden Sie in der Referenzdokumentation.
Beispielcode
Im Beispielcode unten wird Version 3 der API verwendet.
Ereignisse erstellen
Im folgenden Beispiel wird gezeigt, wie Sie einen Termin im Standardkalender des Nutzers erstellen.
Kalender auflisten
Das folgende Beispiel zeigt, wie Details zu den in der Kalenderliste des Nutzers angezeigten Kalendern abgerufen werden.
Ereignisse auflisten
Das folgende Beispiel zeigt, wie die nächsten zehn anstehenden Termine im Standardkalender des Nutzers aufgelistet werden.
Bedingte Änderung eines Ereignisses
Das folgende Beispiel zeigt, wie Sie einen Kalendertermin mithilfe des Headers If-Match
bedingt aktualisieren. Das Skript erstellt ein neues Ereignis, wartet 30 Sekunden und aktualisiert es dann nur, wenn sich seit der Erstellung des Ereignisses keine Details geändert haben.
Bedingtes Abrufen eines Ereignisses
Das folgende Beispiel zeigt, wie ein Kalendertermin mithilfe des Headers If-None-Match
bedingt abgerufen wird. Das Skript erstellt ein neues Ereignis und fragt dann 30 Sekunden lang Änderungen ab. Jedes Mal, wenn sich das Ereignis ändert, wird die neue Version abgerufen.
Termine synchronisieren
Das folgende Beispiel zeigt, wie Ereignisse mithilfe von Synchronisierungstokens abgerufen werden. Wenn Sie einer erweiterten Dienstanfrage von Google Kalender ein Synchronisierungstoken hinzufügen, enthält die resultierende Antwort nur Elemente, die sich seit der Generierung des Tokens geändert haben. Das ermöglicht eine effizientere Verarbeitung. Weitere Informationen zum Synchronisierungsprozess finden Sie unter Ressourcen effizient synchronisieren.
Im folgenden Beispiel wird dieselbe getRelativeDate(daysOffset, hour)
-Methode verwendet, die in den obigen Beispielen definiert wurde.