Settings: watch

Monitora le modifiche alle risorse Impostazioni.

Richiesta

Richiesta HTTP

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

Parametri

Nome parametro Valore Descrizione

Autorizzazione

Questa richiesta richiede 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.settings.readonly
https://www.googleapis.com/auth/calendar.settings

Per saperne di più, 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 pubblicazione utilizzato per questo canale. I valori validi sono "web_hook" (o "webhook"). Entrambi i valori fanno riferimento a un canale in cui vengono utilizzate richieste HTTP 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 distribuzione. Facoltativo.
params.ttl string La durata (TTL) in secondi del canale di notifica. Il valore predefinito è 604.800 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 canale come un canale di notifica utilizzato per controllare 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 monitorata su questo canale. Stabile tra le 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 tramite questo canale. Facoltativo.
expiration long Data e ora di scadenza del canale di notifica, espresse come timestamp Unix, in millisecondi. Facoltativo.