Mit dem erweiterten Kalenderdienst können Sie die öffentliche Google Calendar API in Apps Script verwenden. Diese API ähnelt dem integrierten Kalenderdienst von Apps Script ermöglicht Skripts, auf den Google-Kalender des Nutzers zuzugreifen und ihn zu ändern, einschließlich zusätzliche Kalender, die der Nutzer abonniert hat. In den meisten Fällen werden die ist einfacher zu nutzen. Dieser erweiterte Dienst bietet jedoch ein paar zusätzliche z. B. die Hintergrundfarbe für einzelne Termine festlegen.
Referenz
Ausführliche Informationen zu diesem Dienst finden Sie in der Referenzdokumentation für die öffentliche Google Kalender API. Wie bei allen erweiterten Diensten in Apps Script ist auch die erweiterte Der Kalenderdienst verwendet dieselben Objekte, Methoden und Parameter wie die öffentliche Version der API erstellen. Weitere Informationen finden Sie unter Wie Methodensignaturen bestimmt werden.
Informationen zum Melden von Problemen und zum Support erhalten Sie in der Support-Leitfaden für Google Kalender
HTTP-Anfrageheader
Der erweiterte Kalenderdienst kann die HTTP-Anfrageheader If-Match
und If-None-Match
akzeptieren. Weitere Informationen finden Sie in der
Referenzdokumentation nachlesen.
Beispielcode
Im Beispielcode unten wird Version 3 von die API verwenden.
Ereignisse erstellen
Im folgenden Beispiel wird gezeigt, wie Sie ein Ereignis im Standardeinstellung des Nutzers erstellen. Kalender.
Kalender auflisten
Im folgenden Beispiel wird gezeigt, wie Sie Details zu den Kalendern abrufen, die in der Kalenderliste des Nutzers angezeigt werden.
Ereignisse auflisten
Das folgende Beispiel zeigt, wie die nächsten zehn anstehenden Ereignisse in Standardkalender des Nutzers.
Bedingte Änderung eines Ereignisses
Das folgende Beispiel zeigt, wie Sie einen Kalendertermin mithilfe von Bedingungen aktualisieren:
den If-Match
-Header. Das Script erstellt ein neues Ereignis, wartet 30 Sekunden und aktualisiert das Ereignis nur, wenn sich die Ereignisdetails seit der Erstellung nicht geändert haben.
Bedingtes Abrufen eines Ereignisses
Das folgende Beispiel zeigt, wie ein Kalendertermin mithilfe von Bedingungen abgerufen wird:
den If-None-Match
-Header. Das Skript erstellt ein neues Ereignis und fragt den
30 Sekunden lang für Änderungen an. 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, Die resultierende Antwort enthält nur Elemente, die sich seit diesem Token geändert haben generiert wurde, was eine effizientere Verarbeitung ermöglicht. Weitere Informationen finden Sie unter Unter Ressourcen effizient synchronisieren finden Sie weitere Informationen zu um den Synchronisierungsprozess zu starten.
Im folgenden Beispiel wird dieselbe getRelativeDate(daysOffset, hour)
wie in den Beispielen oben definiert.