API Reference

Questo riferimento API è organizzato per tipo di risorsa. Ogni tipo di risorsa ha una o più rappresentazioni dei dati e uno o più metodi.

Tipi di risorse

  1. AC
  2. CalendarList
  3. Calendari
  4. Canali
  5. Colori
  6. Eventi
  7. Disponibile
  8. Impostazioni

Acl

Per i dettagli della risorsa Acl, consulta la pagina relativa alla rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente specificato
elimina DELETE  /calendars/calendarId/acl/ruleId Elimina una regola di controllo dell'accesso.
recupero GET  /calendars/calendarId/acl/ruleId Restituisce una regola di controllo dell'accesso.
inserire POST  /calendars/calendarId/acl Crea una regola di controllo dell'accesso.
list GET  /calendars/calendarId/acl Restituisce le regole nell'elenco di controllo dell'accesso per il calendario.
cerotto PATCH  /calendars/calendarId/acl/ruleId Aggiorna una regola di controllo dell'accesso. Questo metodo supporta la semantica della 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 non specificati nella richiesta rimangono invariati. I campi degli array, se specificati, sovrascrivono gli array esistenti. Vengono eliminati eventuali elementi dell'array precedenti.
aggiornamento PUT  /calendars/calendarId/acl/ruleId Aggiorna una regola di controllo dell'accesso.
orologio POST  /calendars/calendarId/acl/watch Controlla le modifiche alle risorse ACL.

CalendarList

Per i dettagli della risorsa CalendarList, consulta la pagina relativa alla rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente specificato
elimina DELETE  /users/me/calendarList/calendarId Rimuove un calendario dall'elenco di calendari dell'utente.
recupero GET  /users/me/calendarList/calendarId Restituisce un calendario dall'elenco di calendari dell'utente.
inserire POST  /users/me/calendarList Inserisce un calendario esistente nell'elenco di calendari dell'utente.
list GET  /users/me/calendarList Restituisce i calendari presenti nell'elenco di calendari dell'utente.
cerotto PATCH  /users/me/calendarList/calendarId Aggiorna un calendario esistente nell'elenco di calendari dell'utente. Questo metodo supporta la semantica della 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 non specificati nella richiesta rimangono invariati. I campi degli array, se specificati, sovrascrivono gli array esistenti. Vengono eliminati eventuali elementi dell'array precedenti.
aggiornamento PUT  /users/me/calendarList/calendarId Aggiorna un calendario esistente nell'elenco di calendari dell'utente.
orologio POST  /users/me/calendarList/watch Controlla le modifiche alle risorse CalendarList.

Calendari

Per i dettagli delle risorse dei calendari, consulta la pagina relativa alla rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente specificato
chiara POST  /calendars/calendarId/clear Cancella un calendario principale. Questa operazione elimina tutti gli eventi associati al calendario principale di un account.
elimina DELETE  /calendars/calendarId Elimina un calendario secondario. Utilizza calendar.clear per cancellare tutti gli eventi dai calendari principali.
recupero GET  /calendars/calendarId Restituisce i metadati per un calendario.
inserire POST  /calendars Crea un calendario secondario.
cerotto PATCH  /calendars/calendarId Aggiorna i metadati per un calendario. Questo metodo supporta la semantica della 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 non specificati nella richiesta rimangono invariati. I campi degli array, se specificati, sovrascrivono gli array esistenti. Vengono eliminati eventuali elementi dell'array precedenti.
aggiornamento PUT  /calendars/calendarId Aggiorna i metadati per un calendario.

Canali

Per i dettagli della risorsa dei canali, consulta la pagina relativa alla rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente specificato
fermare POST  /channels/stop Interrompi la visualizzazione delle risorse su questo canale.

Colori

Per i dettagli della risorsa colori, consulta la pagina sulla rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente specificato
recupero GET  /colors Restituisce le definizioni dei colori per calendari ed eventi.

Eventi

Per i dettagli della risorsa Eventi, consulta la pagina relativa alla rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente specificato
elimina DELETE  /calendars/calendarId/events/eventId Elimina un evento.
recupero GET  /calendars/calendarId/events/eventId Restituisce un evento in base al relativo ID Google Calendar. Per recuperare un evento utilizzando il relativo ID iCalendar, chiama il metodo events.list utilizzando il parametro iCalUID.
import POST  /calendars/calendarId/events/import Importa un evento. Questa operazione viene utilizzata per aggiungere una copia privata di un evento esistente a un calendario. È possibile importare solo gli eventi con un valore eventType pari a default.

Comportamento deprecato:se viene importato un evento non default, il tipo viene modificato in default e le eventuali proprietà specifiche per tipo di evento verranno eliminate.

inserire POST  /calendars/calendarId/events Crea un evento.
istanze GET  /calendars/calendarId/events/eventId/instances Restituisce le istanze dell'evento ricorrente specificato.
list GET  /calendars/calendarId/events Restituisce eventi nel calendario specificato.
spostamento POST  /calendars/calendarId/events/eventId/move Sposta un evento in un altro calendario, ad esempio modifica l'organizzatore di un evento. Tieni presente che puoi spostare solo gli eventi default; non puoi spostare gli eventi outOfOffice, focusTime, workingLocation e fromGmail.

Parametri di query obbligatori: destination

cerotto PATCH  /calendars/calendarId/events/eventId Aggiorna un evento. Questo metodo supporta la semantica della 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 non specificati nella richiesta rimangono invariati. I campi degli array, se specificati, sovrascrivono gli array esistenti. Vengono eliminati eventuali elementi dell'array precedenti.
quickAdd POST  /calendars/calendarId/events/quickAdd Crea un evento basato su una semplice stringa di testo.

Parametri di query obbligatori: text

aggiornamento PUT  /calendars/calendarId/events/eventId Aggiorna un evento. Questo metodo non supporta la semantica delle patch e aggiorna sempre l'intera risorsa evento. Per eseguire un aggiornamento parziale, esegui get seguito da update usando gli etag per garantire l'atomicità.
orologio POST  /calendars/calendarId/events/watch Controlla le modifiche alle risorse Eventi.

Disponibile/Occupato

Per i dettagli delle risorse disponibili, vedi la pagina relativa alla rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente specificato
query POST  /freeBusy Restituisce le informazioni disponibile/occupato per un insieme di calendari.

Impostazioni

Per i dettagli della risorsa Impostazioni, consulta la pagina relativa alla rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente specificato
recupero GET  /users/me/settings/setting Restituisce una singola impostazione utente.
list GET  /users/me/settings Restituisce tutte le impostazioni per l'utente autenticato.
orologio POST  /users/me/settings/watch Controlla le modifiche alle risorse delle impostazioni.