Settings: watch

Czekaj na zmiany w zasobach dotyczących ustawień.

Prośba

Żądanie HTTP

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

Parametry

Nazwa parametru Wartość Opis

Upoważnienie

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

Więcej informacji znajdziesz na stronie uwierzytelniania i autoryzacji.

Treść żądania

Dane w treści żądania muszą mieć taką strukturę:

{
  "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 wysyłany na adres docelowy wraz z każdym powiadomieniem przesłanym na ten kanał. Opcjonalnie.
type string Typ mechanizmu przesyłania używany w tym kanale. 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 dotyczące tego kanału.
params object Dodatkowe parametry kontrolujące zachowanie kanału wyświetlania. Opcjonalnie.
params.ttl string Wyrażony w sekundach czas życia danych dla kanału powiadomień. Wartość domyślna to 604 800 sekund.

Odpowiedź

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

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}
nazwa usługi, Wartość Opis Uwagi
kind string Określa go jako kanał powiadomień używany do monitorowania zmian w zasobie „api#channel”.
id string Identyfikator UUID lub podobny unikalny ciąg znaków, który identyfikuje ten kanał.
resourceId string Nieprzejrzysty identyfikator identyfikujący zasób, który chcesz oglądać na tym kanale. Stabilna w różnych wersjach interfejsu API.
resourceUri string Identyfikator wersji obserwowanego zasobu.
token string Dowolny ciąg znaków wysyłany na adres docelowy wraz z każdym powiadomieniem przesłanym na ten kanał. Opcjonalnie.
expiration long Data i godzina wygaśnięcia kanału powiadomień w milisekundach, w postaci sygnatury czasowej uniksowej. Opcjonalnie.