Questa pagina è stata tradotta dall'API Cloud Translation.

API Reference

Questo riferimento API è organizzato in base al tipo di risorsa. Ogni tipo di risorsa ha una o più rappresentazioni dei dati e uno o più metodi.

Tipi di risorse

Acl
CalendarList
Calendari
Canali
Colori
Eventi
Freebusy
Impostazioni

Acl

Per i dettagli sulla risorsa ACL, consulta la pagina Rappresentazione della risorsa.

Metodo	Richiesta HTTP	Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente indicato
elimina	`DELETE /calendars/calendarId/acl/ruleId`	Consente di eliminare una regola di controllo dell'accesso.
get	`GET /calendars/calendarId/acl/ruleId`	Restituisce una regola di controllo dell'accesso.
insert	`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.
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 consuma tre unità di quota. Ti consigliamo di utilizzare un `get` seguito da un `update`. I valori di campo specificati sostituiscono quelli esistenti. I campi non specificati nella richiesta rimangono invariati. I campi array, se specificati, sovrascrivono gli array esistenti; vengono ignorati tutti gli elementi array precedenti.
update	`PUT /calendars/calendarId/acl/ruleId`	Aggiorna una regola di controllo dell'accesso.
watch	`POST /calendars/calendarId/acl/watch`	Controlla se ci sono modifiche alle risorse ACL.

CalendarList

Per i dettagli sulla risorsa CalendarList, vedi la pagina Rappresentazione della risorsa.

Metodo	Richiesta HTTP	Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente indicato
elimina	`DELETE /users/me/calendarList/calendarId`	Rimuove un calendario dall'elenco di calendari dell'utente.
get	`GET /users/me/calendarList/calendarId`	Restituisce un calendario dall'elenco dei calendari dell'utente.
insert	`POST /users/me/calendarList`	Inserisce un calendario esistente nell'elenco dei calendari dell'utente.
list	`GET /users/me/calendarList`	Restituisce i calendari 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 consuma tre unità di quota. Ti consigliamo di utilizzare un `get` seguito da un `update`. I valori di campo specificati sostituiscono quelli esistenti. I campi non specificati nella richiesta rimangono invariati. I campi array, se specificati, sovrascrivono gli array esistenti; vengono ignorati tutti gli elementi array precedenti.
update	`PUT /users/me/calendarList/calendarId`	Aggiorna un calendario esistente nell'elenco dei calendari dell'utente.
watch	`POST /users/me/calendarList/watch`	Tieni d'occhio le modifiche alle risorse CalendarList.

Calendari

Per i dettagli sulle risorse di calendario, vedi la pagina Rappresentazione della risorsa.

Metodo	Richiesta HTTP	Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente indicato
clear	`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`	Consente di eliminare un calendario secondario. Utilizza calendars.clear per cancellare tutti gli eventi nei calendari principali.
get	`GET /calendars/calendarId`	Restituisce i metadati di un calendario.
insert	`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 consuma tre unità di quota. Ti consigliamo di utilizzare un `get` seguito da un `update`. I valori di campo specificati sostituiscono quelli esistenti. I campi non specificati nella richiesta rimangono invariati. I campi array, se specificati, sovrascrivono gli array esistenti; vengono ignorati tutti gli elementi array precedenti.
update	`PUT /calendars/calendarId`	Aggiorna i metadati di un calendario.

Canali

Per i dettagli sulla risorsa Canali, consulta la pagina Rappresentazione della risorsa.

Metodo	Richiesta HTTP	Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente indicato
stop	`POST /channels/stop`	Interrompere la visione delle risorse tramite questo canale.

Colori

Per i dettagli della risorsa Colori, consulta la pagina Rappresentazione della risorsa.

Metodo	Richiesta HTTP	Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente indicato
get	`GET /colors`	Restituisce le definizioni dei colori per i calendari e gli eventi.

Eventi

Per i dettagli della risorsa Eventi, consulta la pagina Rappresentazione della risorsa.

Metodo	Richiesta HTTP	Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente indicato
elimina	`DELETE /calendars/calendarId/events/eventId`	Elimina un evento.
get	`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. È possibile importare solo gli eventi con un valore `eventType` pari a `default`. Comportamento deprecato:se viene importato un evento diverso da `default`, il relativo tipo verrà modificato in `default` e tutte le proprietà specifiche del tipo di evento che potrebbero essere presenti verranno eliminate.
insert	`POST /calendars/calendarId/events`	Crea un evento.
instances	`GET /calendars/calendarId/events/eventId/instances`	Restituisce le istanze dell'evento ricorrente specificato.
list	`GET /calendars/calendarId/events`	Restituisce gli eventi nel calendario specificato.
move	`POST /calendars/calendarId/events/eventId/move`	Sposta un evento in un altro calendario, ovvero cambia l'organizzatore di un evento. Tieni presente che è possibile spostare solo gli eventi `default`; gli eventi `birthday`, `focusTime`, `fromGmail`, `outOfOffice` e `workingLocation` non possono essere spostati. Parametri di query obbligatori: `destination`
patch	`PATCH /calendars/calendarId/events/eventId`	Aggiorna un evento. Questo metodo supporta la semantica delle patch. Tieni presente che ogni richiesta di patch consuma tre unità di quota. Ti consigliamo di utilizzare un `get` seguito da un `update`. I valori di campo specificati sostituiscono quelli esistenti. I campi non specificati nella richiesta rimangono invariati. I campi array, se specificati, sovrascrivono gli array esistenti; vengono ignorati tutti gli elementi array precedenti.
quickAdd	`POST /calendars/calendarId/events/quickAdd`	Crea un evento in base a una semplice stringa di testo. Parametri di query obbligatori: `text`
update	`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 un `get` seguito da un `update` utilizzando gli etag per garantire l'atomicità.
watch	`POST /calendars/calendarId/events/watch`	Tieni d'occhio le modifiche alle risorse Eventi.

Disponibile/Occupato

Per i dettagli della risorsa Freebusy, consulta la pagina Rappresentazione della risorsa.

Metodo	Richiesta HTTP	Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente indicato
query	`POST /freeBusy`	Restituisce informazioni su disponibilità/prenotazione per un insieme di calendari.

Impostazioni

Per i dettagli della risorsa Impostazioni, consulta la pagina Rappresentazione della risorsa.

Metodo	Richiesta HTTP	Descrizione
URI relativi a https://www.googleapis.com/calendar/v3, se non diversamente indicato
get	`GET /users/me/settings/setting`	Restituisce un'impostazione per un singolo utente.
list	`GET /users/me/settings`	Restituisce tutte le impostazioni utente per l'utente autenticato.
watch	`POST /users/me/settings/watch`	Tieni d'occhio le modifiche alle risorse Impostazioni.