Google Calendar

Siesta AI - Google Calendar mahdollistaa tapahtumien luomisen ja lukemisen Google Kalenterissa virallisen Google Calendar API:n kautta. Avustajan asetukset ja delegoidun pääsyn menetelmä ovat samat kuin Gmail-integraatiossa, joten samoja näyttöjä ja menettelyjä (OAuth, käyttöoikeuksien määrittäminen, jakaminen) voidaan käyttää.

Nopea yhteys

Yhteyden luomiseksi riittää, että napsautat Add Connection, valitset Google Calendar ja sivu ohjataan automaattisesti Google-kirjautumiseen. Kirjautumisen jälkeen tili on yhdistetty.

Kuinka yhdistää (OAuth, kuten Gmail)

1. Add Connection -> valitse GoogleCalendar.
   

2. Google OAuth kirjautuminen (pääsy Kalenteriin).
   

3. Vahvista integraation nimi (sisäinen nimi).
   

4. Hyväksy käyttöoikeudet (Kalenterin käyttöoikeudet analogisesti kuin Gmail).
   

Yhteyksien yleiskatsaus

• Yhteyden nimi: GoogleCalendar
• Tyyppi: Google Calendar API (REST)
• Todennus: Google OAuth (käyttäjän delegoitu pääsy) - yksityiskohdat sisäisen konfiguraation mukaan (dokumentin ulkopuolella)
• Scope/toiminnot: CreateEventAsync, ListEventsAsync

Yleiset periaatteet

3.1 Aikamuodot

DateTime-tyyppiset parametrit käyttävät ISO 8601 -standardia. Suositus: käyttää eksplisiittistä aikavyöhykettä (Z UTC:lle tai offset +01:00, +02:00).
Esimerkki: 2025-06-21T14:00:00Z

3.2 Oletuskalenteri

Jos calendarId ei ole määritetty, käytetään käyttäjän oletuskalenteria: primary.

3.3 Toistuvat tapahtumat

Tapahtumien luettelo tukee singleEvents-valintaa, joka määrittää, laajennetaanko toistot yksittäisiksi instansseiksi.

Yksityiskohtaiset API-toiminnot

4.1 CreateEventAsync

Kuvaus: Luo tapahtuma käyttäjän Google-kalenteriin (hänen Google/Gmail-tilinsä alla).

Parametri	Tyyppi	Pakollinen	Kuvaus
summary	Merkkijono	Kyllä	Tapahtuman nimi / aihe
startTime	DateTime	Kyllä	Tapahtuman alkamisaika (ISO 8601)
endTime	DateTime	Kyllä	Tapahtuman päättymisaika (ISO 8601)
description	Merkkijono	Ei	Tapahtuman kuvaus
location	Merkkijono	Ei	Tapahtuman sijainti
sendNotifications	Bool	Ei	Lähetetäänkö ilmoitus osallistujille/käyttäjälle

Validointihuomiot

• endTime on oltava tiukasti startTime:n jälkeen.
• Suositus: käyttää johdonmukaista aikavyöhykettä molemmille ajoille.

4.2 ListEventsAsync

Kuvaus: Palauttaa luettelon käyttäjän kalenterin tapahtumista määritellyllä aikavälillä.

Parametri	Tyyppi	Pakollinen	Kuvaus
calendarId	Merkkijono	Ei	Kalenterin ID (oletus: primary)
timeMin	DateTime	Ei	Ajan aloitus luetteloimista varten (sisältyen)
timeMax	DateTime	Ei	Ajan päättymisaika luetteloimista varten (ilman)
maxResults	Int	Ei	Maksimimäärä tapahtumia (oletus: 250)
singleEvents	Bool	Ei	Laajennetaanko toistot instansseiksi (oletus: true)

Suositeltu käyttö

• Vakaiden tulosten saavuttamiseksi aseta aina timeMin ja timeMax.
• Jos käsittelet toistuvia kokouksia analytiikassa, jätä singleEvents=true.

Turvallisuus ja hallinta

• Toiminnot suoritetaan käyttäjän kontekstissa (delegoitu pääsy OAuth:n kautta).
• Yhteys toimii vain kalenteritiedoilla, jotka ovat annettujen käyttöoikeuksien rajoissa.
• Suositus: auditointi ja lokitus vähintään calendarId, aikaväli (timeMin/timeMax) luetteloimista varten sekä parametrit summary/startTime/endTime luoduille tapahtumille.