Events: patch

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:
  • "all": le notifiche vengono inviate a tutti gli invitati.
  • "externalOnly": le notifiche vengono inviate solo agli invitati che non utilizzano Google Calendar.
  • "none": non viene inviata alcuna notifica. Per le attività di migrazione del calendario, ti consigliamo di utilizzare invece il metodo Events.import.
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.