Questa pagina è stata tradotta dall'API Cloud Translation.

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

AC
CalendarList
Calendari
Canali
Colori
Eventi
Disponibile
Impostazioni

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 `default`, il tipo viene modificato in `default` e le eventuali proprietà specifiche per tipo di evento verranno eliminate.
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: `destination`
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: `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 `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.