Events: watch

śledzić zmiany w zasobach Zdarzenia.

Żądanie

Żądanie HTTP

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

Parametry

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”.
Opcjonalne parametry zapytania
eventTypes string Typy zdarzeń dotyczących zasobów do obejrzenia. Opcjonalnie: Ten parametr można powtarzać wiele razy, aby obserwować zasoby różnego typu. 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.

Autoryzacja

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

Więcej informacji znajdziesz na stronie Uwierzytelnianie i autoryzacja.

Treść żądania

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 Uwagi
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 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 wysyłane są powiadomienia z tego kanału.
params object Dodatkowe parametry kontrolujące zachowanie kanału wyświetlania. Opcjonalnie:
params.ttl string Czas życia w sekundach kanału powiadomień. Wartość domyślna to 60 4800 sekund.

Odpowiedź

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 Uwagi
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 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: