Questa pagina è stata tradotta dall'API Cloud Translation.

Events: watch

Tieni d'occhio le modifiche alle risorse Eventi.

Richiesta

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

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.

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.

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.