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 e workingLocation.
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. |