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”.
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.

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
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.

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 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.

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