Aggiorna un evento. Questo metodo supporta la semantica delle patch. Tieni presente che ogni richiesta di patch consuma tre unità di quota. Ti consigliamo di utilizzare un get seguito da un update. I valori dei campi che specifichi sostituiscono quelli esistenti. I campi non specificati nella richiesta rimangono invariati. I campi array, se specificati, sovrascrivono gli array esistenti, eliminando tutti gli elementi dell'array precedenti.
Prova subito.
Richiesta
Richiesta HTTP
PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
Parametri
| Nome 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 attualmente connesso, utilizza la parola chiave "primary".
|
eventId |
string |
Identificatore evento. |
| Parametri di query facoltativi | ||
alwaysIncludeEmail |
boolean |
Deprecato e ignorato. Nel campo email verrà sempre restituito un valore per l'organizzatore, il creatore e i partecipanti, anche se non è disponibile un indirizzo email reale (ovvero verrà fornito un valore generato e non funzionante).
|
conferenceDataVersion |
integer |
Numero di versione dei dati della conferenza supportati dal client API. La versione 0 non supporta i dati della conferenza e li ignora nel corpo dell'evento. La versione 1 consente di copiare ConferenceData e di creare nuove conferenze utilizzando il campo createRequest di conferenceData. Il valore predefinito è 0.
I valori accettabili sono compresi tra 0 e 1 inclusi.
|
eventLabelVersion |
integer |
Numero di versione della funzionalità Etichetta evento supportata dal client API. La versione 0 non prevede il supporto delle etichette evento ed elabora il campo colorId per la gestione del colore. La versione 1 abilita il supporto delle etichette evento ed elabora eventLabelId nel corpo dell'evento. In questo caso, il campo colorId viene ignorato. Il valore predefinito è 0.
I valori accettabili sono compresi tra 0 e 1 inclusi.
|
maxAttendees |
integer |
Il numero massimo di partecipanti da includere nella risposta. Se il numero di partecipanti è superiore a quello specificato, viene restituito solo il partecipante. Facoltativo. |
sendNotifications |
boolean |
Deprecato. Utilizza invece sendUpdates. Indica se inviare notifiche relative all'aggiornamento dell'evento (ad esempio, modifiche alla descrizione e così via). Tieni presente che alcune email potrebbero comunque essere inviate anche se imposti il valore su false. Il valore predefinito è false.
|
sendUpdates |
string |
Gli invitati che devono ricevere notifiche sull'aggiornamento dell'evento (ad esempio modifiche al titolo e così via).
I valori accettati sono:
|
supportsAttachments |
boolean |
Indica se il client API che esegue l'operazione supporta gli allegati agli eventi. Facoltativo. Il valore predefinito è False. |
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti:
| Ambito |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.events.owned |
Per saperne di più, consulta la pagina Autenticazione e autorizzazione.
Corpo della richiesta
Nel corpo della richiesta, fornisci le parti pertinenti di una risorsa Events, in base alle regole della semantica delle patch.
Risposta
In caso di esito positivo, questo metodo restituisce una risorsa Events nel corpo della risposta.
Prova
Utilizza Explorer API riportato di seguito per chiamare questo metodo sui dati live e visualizzare la risposta.