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

Events: watch

śledzić zmiany w zasobach Zdarzenia.

Żą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 głównego kalendarza aktualnie zalogowanego użytkownika, użyj słowa kluczowego „`primary`”.
Parametry opcjonalne zapytania
`eventTypes`	`string`	Typy zdarzeń dotyczących zasobów do obejrzenia Opcjonalnie: Ten parametr można powtarzać wielokrotnie, aby obserwować zasoby różnych typów. Jeśli nie zostanie ustawiony, zwraca wszystkie typy zdarzeń. Akceptowane wartości: „`birthday`”: specjalne całodniowe wydarzenia powtarzające się co roku. „`default`”: zwykłe zdarzenia. „`focusTime`”: zdarzenia czasu skupienia. „`fromGmail`”: wydarzenia z Gmaila. „`outOfOffice`”: wydarzenia poza biurem. „`workingLocation`”: zdarzenia dotyczące lokalizacji miejsca pracy.

Ta prośba umożliwia 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`
`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`

Więcej informacji znajdziesz na stronie Uwierzytelnianie i autoryzacja.

Dane w treści żądania muszą mieć poniższy format:

{
  "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 wysyłanym przez ten kanał. Opcjonalnie:
`type`	`string`	Typ mechanizmu wyświetlania używanego na tym kanale. Prawidłowe wartości to „`web_hook`” (lub „`webhook`”). Obie wartości odnoszą się do kanału, w którym do przesyłania wiadomości używane są żądania HTTP.
`address`	`string`	Adres, na który wysyłane są powiadomienia z tego kanału.
`params`	`object`	Dodatkowe parametry kontrolujące działanie kanału dostawczego. Opcjonalnie:
`params.ttl`	`string`	Czas życia w sekundach dla kanału powiadomień. Wartość domyślna to 60 4800 sekund.

Jeśli operacja się powiedzie, metoda zwróci odpowiedź o tej strukturze:

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

Nazwa usługi	Wartość	Opis
`kind`	`string`	Określa ten kanał powiadomień jako kanał używany do sprawdzania zmian w zasobach (wartość „`api#channel`”).
`id`	`string`	Identyfikator UUID lub podobny unikalny ciąg znaków identyfikujący ten kanał.
`resourceId`	`string`	Nieczytelny identyfikator identyfikujący zasób odtwarzany na tym kanale. stabilny w różnych wersjach interfejsu API;
`resourceUri`	`string`	Identyfikator wersji zasobu monitorowanego.
`token`	`string`	dowolny ciąg znaków dostarczany na adres docelowy wraz z każdym powiadomieniem wysył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: