Mit dem erweiterten Kalenderdienst können Sie die öffentliche Google Calendar API in Apps Script verwenden. Ähnlich wie der integrierte Kalenderdienst von Apps Script ermöglicht diese API Skripts den Zugriff auf den Google Kalender eines Nutzers und dessen Änderung, einschließlich zusätzlicher Kalender, die der Nutzer abonniert hat. In den meisten Fällen ist der integrierte Dienst einfacher zu verwenden. Dieser erweiterte Dienst bietet jedoch einige zusätzliche Funktionen, einschließlich der Einstellung der Hintergrundfarbe für einzelne Ereignisse.
Referenz
Weitere Informationen zu diesem Dienst finden Sie in der Referenzdokumentation für die öffentliche Google Calendar API. Wie alle erweiterten Dienste in Apps Script verwendet der erweiterte Kalenderdienst dieselben Objekte, Methoden und Parameter wie die öffentliche API. Weitere Informationen finden Sie unter So werden Methodensignaturen ermittelt.
Im Google Kalender-Supportleitfaden können Sie nachlesen, wie Sie Probleme melden und weiteren Support erhalten.
HTTP-Anfrageheader
Der erweiterte Dienst Google Kalender akzeptiert die HTTP-Anfrageheader If-Match
und If-None-Match
. Weitere Informationen finden Sie in der Referenzdokumentation.
Beispielcode
Im folgenden Beispielcode wird Version 3 der API verwendet.
Ereignisse erstellen
Das folgende Beispiel zeigt, wie ein Termin im Standardkalender des Nutzers erstellt wird.
Kalender auflisten
Das folgende Beispiel zeigt, wie Details zu den Kalendern abgerufen werden, die in der Kalenderliste des Nutzers angezeigt werden.
Ereignisse auflisten
Das folgende Beispiel zeigt, wie die nächsten zehn anstehenden Termine im Standardkalender des Nutzers aufgelistet werden.
Ereignisse bedingt ändern
Das folgende Beispiel zeigt, wie Sie einen Kalendertermin mit dem Header 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.
Ereignis unter bestimmten Bedingungen abrufen
Das folgende Beispiel zeigt, wie ein Kalendertermin mithilfe des If-None-Match
-Headers bedingt abgerufen wird. Das Skript erstellt ein neues Ereignis und fragt dann 30 Sekunden lang das Ereignis auf Ä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 Kalenderdienstanfrage ein Synchronisierungstoken hinzufügen, enthält die resultierende Antwort nur Elemente, die sich seit der Generierung des Tokens geändert haben. Dies ermöglicht eine effizientere Verarbeitung. Weitere Informationen zum Synchronisierungsvorgang finden Sie unter Ressourcen effizient synchronisieren.
Im folgenden Beispiel wird dieselbe getRelativeDate(daysOffset, hour)
-Methode verwendet, die in den obigen Beispielen definiert wurde.