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 percorso | ||
calendarId |
string |
Identificatore di calendario. Per recuperare gli ID calendario, chiama il metodo calendarList.list. Se vuoi accedere al calendario principale dell'utente che ha eseguito l'accesso, usa "primary " parola chiave.
|
Parametri di query facoltativi | ||
eventTypes |
string |
Tipi di eventi delle risorse da osservare. (Facoltativo) Questo parametro può essere ripetuto più volte per visualizzare risorse di tipo diverso. Se il criterio non viene configurato, restituisce tutti i tipi di eventi.
I valori accettati sono:
|
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 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 su 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 le richieste HTTP vengono utilizzate per recapitare i messaggi. |
|
address |
string |
L'indirizzo a cui vengono recapitate le notifiche per questo canale. | |
params |
object |
Parametri aggiuntivi che controllano il comportamento del canale di pubblicazione. (Facoltativo) | |
params.ttl |
string |
La durata 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 come un canale di notifica utilizzato per controllare le modifiche a una risorsa, "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 su diverse versioni dell'API. | |
resourceUri |
string |
Un identificatore specifico della versione per la risorsa controllata. | |
token |
string |
Una stringa arbitraria inviata all'indirizzo di destinazione con ogni notifica inviata su questo canale. (Facoltativo) | |
expiration |
long |
Data e ora di scadenza del canale di notifica, espresse come timestamp Unix, in millisecondi. (Facoltativo) |