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