Events: watch

Tieni d'occhio le modifiche alle risorse Eventi.

Richiesta

Richiesta HTTP

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

Parametri

Nome del parametro Valore Descrizione
Parametri del percorso
calendarId string Identificatore del calendario. Per recuperare gli ID calendario, chiama il metodo calendarList.list. Se vuoi accedere al calendario principale dell'utente che ha eseguito l'accesso, utilizza la parola chiave "primary".
Parametri di query facoltativi
eventTypes string Tipi di eventi delle risorse da monitorare. Facoltativo. Questo parametro può essere ripetuto più volte per guardare risorse di tipi diversi. Se non impostato, restituisce tutti i tipi di eventi.

I valori accettati sono:
  • "birthday": eventi speciali che durano tutto il giorno con una ricorrenza annuale.
  • "default": eventi regolari.
  • "focusTime": eventi di momento di concentrazione.
  • "fromGmail": eventi da Gmail.
  • "outOfOffice": eventi fuori sede.
  • "workingLocation": eventi relativi alla sede di lavoro.

Autorizzazione

Questa richiesta consente l'autorizzazione con almeno uno dei seguenti ambiti:

Ambito
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

Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.

Corpo della richiesta

Nel corpo della richiesta, fornisci i dati con la seguente struttura:

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}
Nome proprietà Valore Descrizione Note
id string Un UUID o una stringa univoca simile che identifica questo canale.
token string Una stringa arbitraria inviata all'indirizzo di destinazione con ogni notifica inviata tramite questo canale. Facoltativo.
type string Il tipo di meccanismo di importazione utilizzato per questo canale. I valori validi sono "web_hook" (o "webhook"). Entrambi i valori fanno riferimento a un canale in cui vengono utilizzate le richieste HTTP per inviare i messaggi.
address string L'indirizzo a cui vengono inviate le notifiche per questo canale.
params object Parametri aggiuntivi che controllano il comportamento del canale di importazione. Facoltativo.
params.ttl string Il tempo di vita in secondi per il canale di notifica. Il valore predefinito è 604800 secondi.

Risposta

In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}
Nome proprietà Valore Descrizione Note
kind string Identifica questo come un canale di notifica utilizzato per rilevare le modifiche a una risorsa, ovvero "api#channel".
id string Un UUID o una stringa univoca simile che identifica questo canale.
resourceId string Un ID opaco che identifica la risorsa guardata su questo canale. Stabile nelle diverse versioni dell'API.
resourceUri string Un identificatore specifico per la versione della risorsa guardata.
token string Una stringa arbitraria inviata all'indirizzo di destinazione con ogni notifica inviata tramite questo canale. Facoltativo.
expiration long Data e ora di scadenza del canale di notifica, espresse come timestamp Unix, in millisecondi. Facoltativo.