Events: patch

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 di campo 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 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 che ha eseguito l'accesso, utilizza la parola chiave "primary".
eventId string Identificatore evento.
Parametri di query facoltativi
alwaysIncludeEmail boolean Ritirata e ignorata. Nel campo email verrà sempre restituito un valore per l'organizzatore, il creator e i partecipanti, anche se non è disponibile un indirizzo email reale (ovvero verrà fornito un valore generato non funzionante).
conferenceDataVersion integer Numero di versione dei dati della conferenza supportati dal client API. La versione 0 non presuppone il supporto dei dati della conferenza e li ignora 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 accettabili 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, viene restituito solo il partecipante. Facoltativo.
sendNotifications boolean Deprecato. Utilizza invece sendUpdates.

Indica se inviare notifiche sull'aggiornamento dell'evento (ad es. 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 ospiti 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 non Google Calendar.
  • "none": non vengono inviate notifiche. Per le attività di migrazione del calendario, ti consigliamo di utilizzare il metodo Events.import.
supportsAttachments boolean Indica se il client API che esegue l'operazione supporta gli allegati degli 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 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 Events nel corpo della risposta.

Prova

Utilizza l'Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.