Events: watch

Achten Sie auf Änderungen an Ereignisressourcen.

Anfragen

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 Hauptkalender des aktuell angemeldeten Nutzers zugreifen möchten, verwenden Sie das Keyword „primary“.
Optionale Suchparameter
eventTypes string Der Ereignistyp wird für die Methode „watch“ ignoriert.

Autorisierung

Diese Anfrage ermöglicht die Autorisierung mit mindestens einem der folgenden Bereiche:

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

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
  }
}
Attributname Wert Beschreibung Hinweise
id string Eine UUID oder ein ähnlicher eindeutiger String, der diesen Kanal identifiziert.
token string Ein beliebiger String, der an die Zieladresse gesendet wird, wobei jede Benachrichtigung über diesen Kanal gesendet wird. Optional.
type string Die Art der Auslieferungsmethode, die für diesen Kanal verwendet wird. Gültige Werte sind „web_hook“ (oder „webhook“). Beide Werte beziehen sich auf einen Kanal, auf dem HTTP-Anfragen für die Zustellung von Nachrichten verwendet werden.
address string Die Adresse, an die Benachrichtigungen für diesen Kanal gesendet werden.
params object Zusätzliche Parameter, die das Verhalten des Bereitstellungskanals steuern. Optional.
params.ttl string Die Gültigkeitsdauer des Benachrichtigungskanals in Sekunden. Der Standardwert ist 604.800 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 Kennzeichnet dies als Benachrichtigungskanal, über den nach Änderungen an einer Ressource gesucht wird (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 beobachtet wird. Stabile API-Versionen
resourceUri string Eine versionsspezifische Kennung für die beobachtete Ressource.
token string Ein beliebiger String, der an die Zieladresse gesendet wird, wobei jede Benachrichtigung über diesen Kanal gesendet wird. Optional.
expiration long Datum und Uhrzeit des Ablaufs des Benachrichtigungskanals, ausgedrückt als Unix-Zeitstempel in Millisekunden. Optional.