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. Disponibile
  8. Impostazioni

Acl

Per i dettagli delle risorse 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.
prendi GET  /calendars/calendarId/acl/ruleId Restituisce una regola di controllo dell'accesso.
inserisci POST  /calendars/calendarId/acl Crea una regola di controllo dell'accesso.
list GET  /calendars/calendarId/acl Restituisce le regole nell'elenco di controllo di 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 utilizza 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; in questo modo 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 dei calendari dell'utente.
prendi GET  /users/me/calendarList/calendarId Restituisce un calendario dall'elenco dei calendari dell'utente.
inserisci POST  /users/me/calendarList Inserisce un calendario esistente nell'elenco dei calendari dell'utente.
list GET  /users/me/calendarList Restituisce i calendari presenti 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 utilizza 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; in questo modo vengono eliminati eventuali elementi dell'array precedenti.
aggiornamento PUT  /users/me/calendarList/calendarId Aggiorna un calendario esistente nell'elenco dei calendari dell'utente.
orologio POST  /users/me/calendarList/watch Controlla le modifiche alle risorse CalendarList.

Calendari

Per i dettagli delle risorse di Calendar, 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
cancella 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 dei calendari principali.
prendi GET  /calendars/calendarId Restituisce i metadati per un calendario.
inserisci POST  /calendars Crea un calendario secondario.
patch PATCH  /calendars/calendarId Aggiorna i metadati di un calendario. Questo metodo supporta la semantica delle patch. Tieni presente che ogni richiesta di patch utilizza 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; in questo modo vengono eliminati eventuali elementi dell'array precedenti.
aggiornamento PUT  /calendars/calendarId Aggiorna i metadati di 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
interrompi POST  /channels/stop Smetti di guardare le risorse su questo canale.

Colori

Per i dettagli della risorsa Colori, 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
prendi GET  /colors Restituisce le definizioni dei colori per calendari ed eventi.

Eventi

Per i dettagli delle risorse 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.
prendi GET  /calendars/calendarId/events/eventId Restituisce un evento in base al relativo ID di 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.
inserisci POST  /calendars/calendarId/events Crea un evento.
istanze GET  /calendars/calendarId/events/eventId/instances Restituisce 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, ovvero cambia l'organizzatore di un evento. Tieni presente che puoi spostare solo gli eventi default, mentre gli eventi outOfOffice, focusTime e workingLocation non possono essere spostati.

Parametri di ricerca obbligatori: destination

patch PATCH  /calendars/calendarId/events/eventId Consente di aggiornare un evento. Questo metodo supporta la semantica delle patch. Tieni presente che ogni richiesta di patch utilizza 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; in questo modo 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 ricerca obbligatori: text

aggiornamento PUT  /calendars/calendarId/events/eventId Consente di aggiornare un evento. Questo metodo non supporta la semantica delle patch e aggiorna sempre l'intera risorsa evento. Per eseguire un aggiornamento parziale, esegui un comando get seguito da un 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, 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
query POST  /freeBusy Restituisce le informazioni sulla disponibilità 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
prendi GET  /users/me/settings/setting Restituisce una singola impostazione utente.
list GET  /users/me/settings Restituisce tutte le impostazioni utente per l'utente autenticato.
orologio POST  /users/me/settings/watch Controlla le modifiche alle risorse delle impostazioni.