Diese Seite wurde von der Cloud Translation API übersetzt.

Events: watch

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

Anfrage

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

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

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.

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
`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.

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
`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.