Google Calendar

Siesta AI - Google Calendar umožňuje vytvárať a čítať udalosti v Google Kalendári cez oficiálne Google Calendar API. Nastavenie asistenta a spôsob delegovaného prístupu je rovnaký ako pri Gmail integrácii, takže je možné využiť rovnaké obrazovky a postupy (OAuth, priradenie prístupu, zdieľanie).

Rýchle pripojenie

Pre vytvorenie stačí kliknúť na Add Connection, vybrať Google Calendar a stránka sa automaticky presmeruje na Google prihlásenie. Po prihlásení je účet prepojený.

Ako sa pripojiť (OAuth, rovnako ako Gmail)

1. Add Connection -> vyber GoogleCalendar.
   

2. Google OAuth prihlásenie (prístup k Calendaru).
   

3. Potvrď názov integrácie (interné meno).
   

4. Súhlas s oprávneniami (Calendar scopes analogicky ako Gmail).
   

Prehľad Pripojenia

• Názov Pripojenia: GoogleCalendar
• Typ: Google Calendar API (REST)
• Autentizácia: Google OAuth (delegovaný prístup používateľa) - detaily podľa internej konfigurácie (mimo rozsah dokumentu)
• Scope/operácie: CreateEventAsync, ListEventsAsync

Obecné princípy

3.1 Časové formáty

Parametre typu DateTime používajú ISO 8601. Odporúčanie: používať explicitnú časovú zónu (Z pre UTC alebo offset +01:00, +02:00).
Príklad: 2025-06-21T14:00:00Z

3.2 Výchozí kalendár

Ak nie je zadaný calendarId, použije sa výchozí kalendár používateľa: primary.

3.3 Rekurentné udalosti

Zoznam udalostí podporuje voľbu singleEvents, ktorá určuje, či sa rekurencia rozbalí na jednotlivé inštancie.

Detailné API operácie

4.1 CreateEventAsync

Popis: Vytvorí udalosť v Google kalendári používateľa (pod jeho Google/Gmail účtom).

Parameter	Type	Required	Description
summary	String	Áno	Názov / predmet udalosti
startTime	DateTime	Áno	Začiatok udalosti (ISO 8601)
endTime	DateTime	Áno	Koniec udalosti (ISO 8601)
description	String	Nie	Popis udalosti
location	String	Nie	Lokácia udalosti
sendNotifications	Bool	Nie	Či poslať notifikáciu účastníkom/používateľovi

Poznámky k validácii

• endTime musí byť striktne po startTime.
• Odporúčanie: používať konzistentnú časovú zónu pre oba časy.

4.2 ListEventsAsync

Popis: Vráti zoznam udalostí z kalendára používateľa v zadanom časovom rozsahu.

Parameter	Type	Required	Description
calendarId	String	Nie	ID kalendára (default: primary)
timeMin	DateTime	Nie	Začiatok času pre listing (inkluzívne)
timeMax	DateTime	Nie	Koniec času pre listing (exkluzívne)
maxResults	Int	Nie	Max počet udalostí (default: 250)
singleEvents	Bool	Nie	Rozbaliť rekurencie na inštancie (default: true)

Odporúčané použitie

• Pre stabilné výsledky vždy nastav timeMin a timeMax.
• Ak spracovávaš rekurentné stretnutia v analytike, nechaj singleEvents=true.

Bezpečnosť a governance

• Operácie bežia v kontexte používateľa (delegovaný prístup cez OAuth).
• Pripojenie pracuje iba s kalendárovými dátami v rozsahu udelených oprávnení.
• Odporúčanie: auditovať a logovať minimálne calendarId, časové okno (timeMin/timeMax) pre listovanie a parametre summary/startTime/endTime pre vytvorené udalosti.