Events: patch

Aggiorna un evento. Questo metodo supporta la semantica delle patch. Tieni presente che ogni richiesta di patch utilizza tre unità di quota; preferisci usare get seguito da update. I valori dei campi specificati sostituiscono quelli esistenti. I campi non specificati nella richiesta rimangono invariati. I campi array, se specificati, sovrascrivono gli array esistenti. Vengono ignorati tutti gli elementi 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 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.
eventId string Identificatore dell'evento.
Parametri di query facoltativi
alwaysIncludeEmail boolean Deprecato e ignorato. Verrà sempre restituito un valore nel campo email per l'organizzatore, l'autore 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 presuppone che i dati relativi alle conferenze non siano supportati e ignora i dati relativi alle conferenze nel corpo dell'evento. La versione 1 consente il supporto per la copia di ConferenceData e per la creazione di nuove conferenze utilizzando il campo createRequest di ConferenceData. Il valore predefinito è 0. I valori accettati sono compresi tra 0 e 1 (inclusi).
maxAttendees integer Il numero massimo di partecipanti da includere nella risposta. Se il numero di partecipanti supera quello specificato, viene restituito solo il partecipante. (Facoltativo)
sendNotifications boolean Deprecato. Usa invece sendUpdates.

Indica se 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 Gli invitati che devono ricevere notifiche sull'aggiornamento dell'evento (ad es. 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 vengono inviate notifiche. Per le attività di migrazione del calendario, prendi in considerazione l'utilizzo del metodo Events.import.
supportsAttachments boolean Indica se il client API che esegue l'operazione supporta i collegamenti di 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

Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.

Corpo della richiesta

Nel corpo della richiesta, fornisci le parti pertinenti di una risorsa Eventi, in base alle regole della semantica della patch.

Risposta

In caso di esito positivo, questo metodo restituisce una risorsa Eventi nel corpo della risposta.

Prova

Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.