Google Calendar

Siesta AI - Google Calendar consente di creare e leggere eventi in Google Calendar tramite l'API ufficiale di Google Calendar. La configurazione dell'assistente e il metodo di accesso delegato sono gli stessi dell'integrazione di Gmail, quindi è possibile utilizzare le stesse schermate e procedure (OAuth, assegnazione dell'accesso, condivisione).

Connessione rapida

Per creare, basta cliccare su Add Connection, selezionare Google Calendar e la pagina verrà automaticamente reindirizzata al login di Google. Dopo il login, l'account è collegato.

Come connettersi (OAuth, come Gmail)

1. Add Connection -> seleziona GoogleCalendar.
   

2. Login OAuth di Google (accesso al Calendar).
   

3. Conferma il nome dell'integrazione (nome interno).
   

4. Consenso alle autorizzazioni (scope del Calendar analogamente a Gmail).
   

Panoramica delle Connessioni

• Nome Connessione: GoogleCalendar
• Tipo: Google Calendar API (REST)
• Autenticazione: Google OAuth (accesso delegato dell'utente) - dettagli secondo la configurazione interna (fuori dal campo di questo documento)
• Scope/operazioni: CreateEventAsync, ListEventsAsync

Principi generali

3.1 Formati temporali

I parametri di tipo DateTime utilizzano ISO 8601. Raccomandazione: utilizzare un fuso orario esplicito (Z per UTC o offset +01:00, +02:00).
Esempio: 2025-06-21T14:00:00Z

3.2 Calendario predefinito

Se non viene fornito calendarId, verrà utilizzato il calendario predefinito dell'utente: primary.

3.3 Eventi ricorrenti

La lista degli eventi supporta l'opzione singleEvents, che determina se la ricorrenza deve essere espansa in singole istanze.

Operazioni API dettagliate

4.1 CreateEventAsync

Descrizione: Crea un evento nel Google Calendar dell'utente (sotto il suo account Google/Gmail).

Parametro	Tipo	Richiesto	Descrizione
summary	String	Sì	Nome / oggetto dell'evento
startTime	DateTime	Sì	Inizio dell'evento (ISO 8601)
endTime	DateTime	Sì	Fine dell'evento (ISO 8601)
description	String	No	Descrizione dell'evento
location	String	No	Luogo dell'evento
sendNotifications	Bool	No	Se inviare notifiche ai partecipanti/utente

Note di validazione

• endTime deve essere strettamente dopo startTime.
• Raccomandazione: utilizzare un fuso orario coerente per entrambi i tempi.

4.2 ListEventsAsync

Descrizione: Restituisce un elenco di eventi dal calendario dell'utente nell'intervallo di tempo specificato.

Parametro	Tipo	Richiesto	Descrizione
calendarId	String	No	ID del calendario (default: primary)
timeMin	DateTime	No	Inizio del tempo per la lista (inclusivo)
timeMax	DateTime	No	Fine del tempo per la lista (esclusivo)
maxResults	Int	No	Numero massimo di eventi (default: 250)
singleEvents	Bool	No	Espandere le ricorrenze in istanze (default: true)

Uso raccomandato

• Per risultati stabili, impostare sempre timeMin e timeMax.
• Se stai elaborando riunioni ricorrenti nell'analisi, lascia singleEvents=true.

Sicurezza e governance

• Le operazioni vengono eseguite nel contesto dell'utente (accesso delegato tramite OAuth).
• La connessione lavora solo con i dati del calendario nell'ambito delle autorizzazioni concesse.
• Raccomandazione: auditare e registrare almeno calendarId, intervallo di tempo (timeMin/timeMax) per la lista e i parametri summary/startTime/endTime per gli eventi creati.