Events: watch

Behalten Sie Änderungen an den Ressourcen für Google Kalender im Auge.

Anfrage

HTTP-Anfrage

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/watch

Parameter

Parametername Wert Beschreibung
Pfadparameter
calendarId string Kalender-ID. Rufen Sie die Methode calendarList.list auf, um Kalender-IDs abzurufen. Wenn Sie auf den primären Kalender des aktuell angemeldeten Nutzers zugreifen möchten, verwenden Sie das Keyword „primary“.
Optionale Suchparameter
eventTypes string Ereignistypen der zu beobachtenden Ressourcen. Optional. Dieser Parameter kann mehrmals wiederholt werden, um Ressourcen verschiedener Typen zu beobachten. Wenn nicht festgelegt, werden alle Ereignistypen zurückgegeben.

Zulässige Werte sind:
  • „birthday“: Besondere ganztägige Ereignisse, die jährlich wiederkehren.
  • „default“: Regelmäßig stattfindende Ereignisse.
  • „focusTime“: Fokuszeittermine.
  • „fromGmail“: Termine aus Gmail
  • „outOfOffice“: Außer-Haus-Termine.
  • „workingLocation“: Ereignisse für den Arbeitsort

Autorisierung

Diese Anfrage ermöglicht die Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

Umfang
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events.readonly
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.freebusy
https://www.googleapis.com/auth/calendar.events.owned
https://www.googleapis.com/auth/calendar.events.owned.readonly
https://www.googleapis.com/auth/calendar.events.public.readonly

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Geben Sie im Anfragetext Daten mit der folgenden Struktur ein:

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}
Name der Eigenschaft Wert Beschreibung Hinweise
id string Eine UUID oder ein ähnlicher eindeutiger String, der diesen Kanal identifiziert.
token string Ein beliebiger String, der mit jeder Benachrichtigung über diesen Kanal an die Zieladresse gesendet wird. Optional.
type string Der für diesen Kanal verwendete Übermittlungsmechanismus. Gültige Werte sind „web_hook“ (oder „webhook“). Beide Werte beziehen sich auf einen Kanal, bei dem Nachrichten per HTTP-Anfrage gesendet werden.
address string Die Adresse, an die Benachrichtigungen für diesen Kanal gesendet werden.
params object Zusätzliche Parameter, die das Verhalten des Übermittlungskanals steuern. Optional.
params.ttl string Die Gültigkeitsdauer in Sekunden für den Benachrichtigungskanal. Standardeinstellung: 60.4800 Sekunden.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}
Name der Eigenschaft Wert Beschreibung Hinweise
kind string Hiermit wird angegeben, dass es sich um einen Benachrichtigungskanal handelt, der für Änderungen an einer Ressource verwendet wird, nämlich „api#channel“.
id string Eine UUID oder ein ähnlicher eindeutiger String, der diesen Kanal identifiziert.
resourceId string Eine intransparente ID, die die Ressource identifiziert, die auf diesem Kanal angesehen wird. Sie sind für verschiedene API-Versionen stabil.
resourceUri string Eine versionsspezifische Kennung für die beobachtete Ressource.
token string Ein beliebiger String, der mit jeder Benachrichtigung über diesen Kanal an die Zieladresse gesendet wird. Optional.
expiration long Datum und Uhrzeit des Ablaufs des Benachrichtigungskanals als Unix-Zeitstempel in Millisekunden. Optional.