Questa pagina è stata tradotta dall'API Cloud Translation.

CalendarList: watch

Tieni d'occhio le modifiche alle risorse CalendarList.

Richiesta

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

Nome del parametro	Valore	Descrizione

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.calendarlist`
`https://www.googleapis.com/auth/calendar.calendarlist.readonly`

Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.

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

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