Events: watch

Controlla 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 effettuato l'accesso, utilizza la parola chiave "primary".
Parametri di query facoltativi
eventTypes string Tipi di eventi di risorse da osservare. Campo facoltativo. Questo parametro può essere ripetuto più volte per monitorare risorse di tipi diversi. Se il criterio non viene configurato, restituisce tutti i tipi di eventi.

I valori accettati sono:
  • "default": eventi regolari.
  • "focusTime": eventi di momento di concentrazione.
  • "outOfOffice": eventi fuori sede.
  • "workingLocation": eventi relativi al luogo 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

Per ulteriori informazioni, consulta la pagina relativa a 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 il canale.
token string Una stringa arbitraria inviata all'indirizzo di destinazione con ogni notifica inviata attraverso questo canale. Campo facoltativo.
type string Il tipo di meccanismo di pubblicazione utilizzato per questo canale. I valori validi sono "web_hook" (o "webhook"). Entrambi i valori fanno riferimento a un canale in cui le richieste HTTP vengono utilizzate per recapitare 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 pubblicazione. Campo facoltativo.
params.ttl string La durata in secondi del canale di notifica. Il valore predefinito è 604.800 secondi.

Risposta

Se l'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 canale come canale di notifica utilizzato per controllare le modifiche apportate a una risorsa, ovvero "api#channel".
id string Un UUID o una stringa univoca simile che identifica il canale.
resourceId string Un ID opaco che identifica la risorsa visitata su questo canale. Stabile in diverse versioni dell'API.
resourceUri string Un identificatore specifico della versione per la risorsa monitorata.
token string Una stringa arbitraria inviata all'indirizzo di destinazione con ogni notifica inviata attraverso questo canale. Campo facoltativo.
expiration long Data e ora di scadenza del canale di notifica, espresse come timestamp Unix, in millisecondi. Campo facoltativo.