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
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 |
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:
|
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:
|
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. |