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. Acl
  2. CalendarList
  3. Calendari
  4. Canali
  5. Colori
  6. Eventi
  7. Freebusy
  8. Impostazioni

Acl

Per i dettagli sulla risorsa ACL, consulta la pagina Rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente indicato
elimina DELETE  /calendars/calendarId/acl/ruleId Elimina una regola di controllo dell'accesso.
get GET  /calendars/calendarId/acl/ruleId Restituisce una regola di controllo dell'accesso.
insert 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.
patch PATCH  /calendars/calendarId/acl/ruleId Aggiorna una regola di controllo dell'accesso. 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 dei campi che specifichi sostituiscono i valori esistenti. I campi non specificati nella richiesta rimangono invariati. I campi array, se specificati, sovrascrivono gli array esistenti, eliminando tutti gli elementi dell'array precedenti.
aggiornamento PUT  /calendars/calendarId/acl/ruleId Aggiorna una regola di controllo dell'accesso.
watch POST  /calendars/calendarId/acl/watch Controlla le modifiche alle risorse ACL.

CalendarList

Per i dettagli sulla risorsa CalendarList, consulta la pagina Rappresentazione della risorsa.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente indicato
elimina DELETE  /users/me/calendarList/calendarId Rimuove un calendario dall'elenco dei calendari dell'utente.
get GET  /users/me/calendarList/calendarId Restituisce un calendario dall'elenco dei calendari dell'utente.
insert POST  /users/me/calendarList Inserisce un calendario esistente nell'elenco dei calendari dell'utente.
list GET  /users/me/calendarList Restituisce i calendari nell'elenco dei calendari dell'utente.
patch PATCH  /users/me/calendarList/calendarId Aggiorna un calendario esistente nell'elenco dei calendari dell'utente. 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 dei campi che specifichi sostituiscono i valori esistenti. I campi non specificati nella richiesta rimangono invariati. I campi array, se specificati, sovrascrivono gli array esistenti, eliminando tutti gli elementi dell'array precedenti.
aggiornamento PUT  /users/me/calendarList/calendarId Aggiorna un calendario esistente nell'elenco dei calendari dell'utente.
watch POST  /users/me/calendarList/watch Controlla le modifiche alle risorse CalendarList.

Calendari

Per i dettagli sulle risorse di Calendari, consulta la pagina Rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente indicato
clear 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 calendars.clear per eliminare tutti gli eventi dai calendari principali.
get GET  /calendars/calendarId Restituisce i metadati di un calendario.
insert POST  /calendars Crea un calendario secondario.

L'utente autenticato per la richiesta diventa il proprietario dei dati del nuovo calendario.
patch PATCH  /calendars/calendarId Aggiorna i metadati di un calendario. 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 dei campi che specifichi sostituiscono i valori esistenti. I campi non specificati nella richiesta rimangono invariati. I campi array, se specificati, sovrascrivono gli array esistenti, eliminando tutti gli elementi dell'array precedenti.
aggiornamento PUT  /calendars/calendarId Aggiorna i metadati di un calendario.

Canali

Per i dettagli sulla risorsa Canali, consulta la pagina Rappresentazione della risorsa.

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

Colori

Per i dettagli sulla risorsa Colori, consulta la pagina Rappresentazione delle risorse.

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

Eventi

Per i dettagli sulla risorsa Eventi, consulta la pagina Rappresentazione della risorsa.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente indicato
elimina DELETE  /calendars/calendarId/events/eventId Elimina un evento.
get GET  /calendars/calendarId/events/eventId Restituisce un evento in base al suo 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. Possono essere importati solo gli eventi con un eventType di default.

Comportamento ritirato:se viene importato un evento non default, il relativo tipo verrà modificato in default e le eventuali proprietà specifiche del tipo di evento verranno eliminate.
insert 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 gli eventi nel calendario specificato.
move POST  /calendars/calendarId/events/eventId/move Sposta un evento in un altro calendario, ovvero cambia l'organizzatore di un evento. Tieni presente che è possibile spostare solo gli eventi default; gli eventi birthday, focusTime, fromGmail, outOfOffice e workingLocation non possono essere spostati.

Parametri di query obbligatori: destination

patch PATCH  /calendars/calendarId/events/eventId 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 dei campi che specifichi sostituiscono i valori esistenti. I campi non specificati nella richiesta rimangono invariati. I campi array, se specificati, sovrascrivono gli array esistenti, eliminando tutti gli 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 un'operazione get seguita da un'operazione update utilizzando i tag ETag per garantire l'atomicità.
watch POST  /calendars/calendarId/events/watch Controlla le modifiche alle risorse Eventi.

Disponibile/Occupato

Per i dettagli sulla risorsa Freebusy, consulta la pagina Rappresentazione delle risorse.

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

Impostazioni

Per i dettagli sulla risorsa Impostazioni, consulta la pagina Rappresentazione delle risorse.

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