Settings: watch

Obserwuj zmiany w zasobach ustawień.

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/calendar/v3/users/me/settings/watch

Parametry

Nazwa parametru Wartość Opis

Autoryzacja

To żądanie wymaga autoryzacji 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.settings.readonly
https://www.googleapis.com/auth/calendar.settings

Więcej informacji znajdziesz na stronie poświęconej uwierzytelnianiu i autoryzacji.

Treść żądania

W treści żądania podaj dane o następującej strukturze:

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}
Nazwa usługi Wartość Opis Uwagi
id string Identyfikator UUID lub podobny unikalny ciąg znaków, który identyfikuje ten kanał.
token string Dowolny ciąg znaków dostarczany na adres docelowy z każdym powiadomieniem dostarczanym przez ten kanał. Opcjonalnie:
type string Typ mechanizmu dostarczania używanego w tym kanale. Prawidłowe wartości to „web_hook” (lub „webhook”). Obie wartości odnoszą się do kanału, w którym do dostarczania wiadomości używane są żądania HTTP.
address string Adres, na który są dostarczane powiadomienia dla tego kanału.
params object Dodatkowe parametry kontrolujące zachowanie kanału dostarczania. Opcjonalnie:
params.ttl string Czas życia kanału powiadomień w sekundach. Wartość domyślna to 604 800 sekund.

Odpowiedź

Jeśli operacja się powiedzie, ta metoda zwróci treść odpowiedzi o tej strukturze:

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}
Nazwa usługi Wartość Opis Uwagi
kind string Identyfikuje ten kanał jako kanał powiadomień używany do obserwowania zmian w zasobie, czyli „api#channel”.
id string Identyfikator UUID lub podobny unikalny ciąg znaków, który identyfikuje ten kanał.
resourceId string Nieczytelny identyfikator zasobu obserwowanego na tym kanale. Stabilność w różnych wersjach interfejsu API.
resourceUri string Identyfikator konkretnej wersji obserwowanego zasobu.
token string Dowolny ciąg znaków dostarczany na adres docelowy z każdym powiadomieniem dostarczanym 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: