Ta strona została przetłumaczona przez Cloud Translation API.

Events: watch

Obserwuj zmiany w zasobach wydarzeń.

Żądanie

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

Nazwa parametru	Wartość	Opis
Parametry ścieżki
`calendarId`	`string`	Identyfikator kalendarza. Aby pobrać identyfikatory kalendarzy, wywołaj metodę calendarList.list. Jeśli chcesz uzyskać dostęp do kalendarza głównego obecnie zalogowanego użytkownika, użyj narzędzia „`primary`” słowa kluczowego.
Opcjonalne parametry zapytania
`eventTypes`	`string`	Typy zdarzeń dotyczące zasobów do obserwowania. Opcjonalnie: Ten parametr można powtarzać wiele razy, aby obserwować zasoby różnego typu. Jeśli zasada jest nieskonfigurowana, zwraca wszystkie typy zdarzeń. Akceptowane wartości to: „`default`”: zwykłe wydarzenia. „`focusTime`”: wydarzenia typu czas skupienia. „`fromGmail`”: wydarzenia z Gmaila. „`outOfOffice`”: wydarzenia poza biurem. „`workingLocation`”: zdarzenia dotyczące lokalizacji miejsca pracy.

To żądanie zezwala na autoryzację z co najmniej jednym z tych zakresów:

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

Więcej informacji znajdziesz na stronie dotyczącej uwierzytelniania i autoryzacji.

Dane w treści żądania podaj w następującej strukturze:

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}

Nazwa usługi	Wartość	Opis
`id`	`string`	identyfikator UUID lub podobny, unikalny ciąg znaków identyfikujący ten kanał;
`token`	`string`	Dowolny ciąg znaków dostarczany na adres docelowy wraz z każdym powiadomieniem przesłanym przez ten kanał. Opcjonalnie:
`type`	`string`	Typ mechanizmu wyświetlania stosowanego w przypadku tego kanału. Prawidłowe wartości to „`web_hook`” (lub „`webhook`”). Obie wartości odnoszą się do kanału, w którym żądania HTTP są używane do dostarczania wiadomości.
`address`	`string`	Adres, na który są dostarczane powiadomienia z tego kanału.
`params`	`object`	Dodatkowe parametry kontrolujące zachowanie kanału wyświetlania. Opcjonalnie:
`params.ttl`	`string`	Czas życia w sekundach dla kanału powiadomień. Wartość domyślna to 60 4 800 sekund.

Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}

Nazwa usługi	Wartość	Opis
`kind`	`string`	Identyfikuje go jako kanał powiadomień używany do obserwowania zmian w zasobie, czyli „`api#channel`”.
`id`	`string`	identyfikator UUID lub podobny, unikalny ciąg znaków identyfikujący ten kanał;
`resourceId`	`string`	Nieprzejrzysty identyfikator określający zasób oglądany na tym kanale. Stabilny w różnych wersjach interfejsu API.
`resourceUri`	`string`	Identyfikator wersji monitorowanego zasobu.
`token`	`string`	Dowolny ciąg znaków dostarczany na adres docelowy wraz z każdym powiadomieniem przesłanym przez ten kanał. Opcjonalnie:
`expiration`	`long`	Data i godzina wygaśnięcia kanału powiadomień wyrażona jako sygnatura czasowa systemu Unix w milisekundach. Opcjonalnie: