Google Calendar Connector

Siesta AI - Google Calendar Connector umožňuje vytvářet a číst události v Google Kalendáři přes oficiální Google Calendar API. Nastavení asistenta a způsob delegovaného přístupu je stejné jako u Gmail konektoru, takže lze využít stejné obrazovky a postupy (OAuth, přiřazení přístupu, sdílení).

Rychlé připojení

Pro vytvoření stačí kliknout na Přidat připojení, vybrat Google Calendar a stránka se automaticky přesměruje na Google přihlášení. Po přihlášení je účet propojen.

Jak se připojit (OAuth, stejně jako Gmail)

1. Add Connection -> vyber GoogleCalendar.
   

2. Google OAuth přihlášení (přístup k Calendaru).
   

3. Potvrď název integrace (interní jméno).
   

4. Souhlas s oprávněními (Calendar scopes analogicky jako Gmail).
   

Přehled konektoru

• Název konektoru: GoogleCalendar
• Typ: Google Calendar API (REST)
• Autentizace: Google OAuth (delegovaný přístup uživatele) - detaily dle interní konfigurace (mimo rozsah dokumentu)
• Scope/operace: CreateEventAsync, ListEventsAsync

Obecné principy

3.1 Časové formáty

Parametry typu DateTime používají ISO 8601. Doporučení: používat explicitní časovou zónu (Z pro UTC nebo offset +01:00, +02:00).
Příklad: 2025-06-21T14:00:00Z

3.2 Výchozí kalendář

Pokud není zadán calendarId, použije se výchozí kalendář uživatele: primary.

3.3 Rekurentní události

Listování událostí podporuje volbu singleEvents, která určuje, zda se rekurence rozbalí na jednotlivé instance.

Detailní API operace

4.1 CreateEventAsync

Popis: Vytvoří událost v Google kalendáři uživatele (pod jeho Google/Gmail účtem).

Parameter	Type	Required	Description
summary	String	Yes	Název / předmět události
startTime	DateTime	Yes	Začátek události (ISO 8601)
endTime	DateTime	Yes	Konec události (ISO 8601)
description	String	No	Popis události
location	String	No	Lokace události
sendNotifications	Bool	No	Zda poslat notifikaci účastníkům/uživateli

Poznámky k validaci

• endTime musí být striktně po startTime.
• Doporučení: používat konzistentní time zone pro oba časy.

4.2 ListEventsAsync

Popis: Vrátí seznam událostí z kalendáře uživatele v zadaném časovém rozsahu.

Parameter	Type	Required	Description
calendarId	String	No	ID kalendáře (default: primary)
timeMin	DateTime	No	Start času pro listing (inkluzivně)
timeMax	DateTime	No	Konec času pro listing (exkluzivně)
maxResults	Int	No	Max počet událostí (default: 250)
singleEvents	Bool	No	Rozbalit rekurence na instance (default: true)

Doporučené použití

• Pro stabilní výsledky vždy nastav timeMin a timeMax.
• Pokud zpracováváš rekurentní meetingy v analytice, nech singleEvents=true.

Bezpečnost a governance

• Operace běží v kontextu uživatele (delegovaný přístup přes OAuth).
• Konektor pracuje pouze s kalendářovými daty v rozsahu udělených oprávnění.
• Doporučení: auditovat a logovat minimálně calendarId, časové okno (timeMin/timeMax) pro listování a parametry summary/startTime/endTime pro vytvořené události.