Consente di aggiornare un evento. Questo metodo supporta la semantica delle patch. Tieni presente che ogni richiesta di patch consuma tre unità di quota; è preferibile utilizzare get
seguito da update
. I valori dei campi specificati sostituiscono quelli esistenti. I campi che non hai specificato nella richiesta rimarranno invariati. I campi degli array, se specificati, sovrascrivono gli array esistenti; in questo modo vengono ignorati eventuali elementi dell'array precedenti.
Prova subito.
Richiesta
Richiesta HTTP
PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
Parametri
Nome del parametro | Valore | Descrizione |
---|---|---|
Parametri del percorso | ||
calendarId |
string |
Identificatore del calendario. Per recuperare gli ID calendario, chiama il metodo calendarList.list. Utilizza la parola chiave "primary " per accedere al calendario principale dell'utente che ha eseguito l'accesso.
|
eventId |
string |
Identificatore dell'evento. |
Parametri di query facoltativi | ||
alwaysIncludeEmail |
boolean |
Obsoleto e ignorato. Verrà sempre restituito un valore nel campo email per l'organizzatore, il creatore e i partecipanti, anche se non è disponibile alcun indirizzo email reale (ad esempio, verrà fornito un valore generato e non funzionante).
|
conferenceDataVersion |
integer |
Numero di versione dei dati di conferenza supportato dal client API. La versione 0 presuppone che non vi sia supporto per i dati relativi alle conferenze e ignora i dati relativi alle conferenze nel corpo dell'evento. La versione 1 supporta la copia di ConferenceData e la creazione di nuove conferenze utilizzando il campo createRequest di conferenceData. Il valore predefinito è 0.
I valori accettati sono compresi tra 0 e 1 .
|
maxAttendees |
integer |
Il numero massimo di partecipanti da includere nella risposta. Se il numero di partecipanti è superiore a quello specificato, verrà restituito solo il partecipante. Campo facoltativo. |
sendNotifications |
boolean |
Deprecato. Usa invece sendUpdates. Se vuoi inviare notifiche sull'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 |
Invitati che dovrebbero ricevere notifiche sull'aggiornamento dell'evento (ad esempio modifiche al titolo e così via).
I valori accettati sono:
|
supportsAttachments |
boolean |
Indica se l'operazione di esecuzione del client API supporta i collegamenti agli eventi. Campo 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 |
Per ulteriori informazioni, consulta la pagina relativa all'autenticazione e autorizzazione.
Corpo della richiesta
Nel corpo della richiesta, fornisci le parti pertinenti di una risorsa Eventi, in base alle regole della semantica delle patch.
Risposta
In caso di esito positivo, questo metodo restituisce una risorsa Eventi nel corpo della risposta.
Prova.
Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.