Google Kalender

Siesta AI - Google Kalender gjør det mulig å opprette og lese hendelser i Google Kalender via det offisielle Google Calendar API. Innstillingen av assistenten og måten for delegert tilgang er den samme som for Gmail-integrasjonen, så de samme skjermene og prosedyrene kan brukes (OAuth, tildeling av tilgang, deling).

Rask tilkobling

For å opprette, klikk på Add Connection, velg Google Calendar, og siden vil automatisk bli omdirigert til Google-pålogging. Etter innlogging er kontoen koblet.

Hvordan koble til (OAuth, som Gmail)

1. Add Connection -> velg GoogleCalendar.
   

2. Google OAuth-pålogging (tilgang til Kalender).
   

3. Bekreft integrasjonsnavn (internt navn).
   

4. Samtykke til tillatelser (Kalenderomfang på samme måte som Gmail).
   

Oversikt over tilkoblinger

• Navn på tilkobling: GoogleCalendar
• Type: Google Calendar API (REST)
• Autentisering: Google OAuth (delegert bruker tilgang) - detaljer i henhold til intern konfigurasjon (utenfor dokumentets omfang)
• Omfang/operasjoner: CreateEventAsync, ListEventsAsync

Generelle prinsipper

3.1 Tidsformater

Parametere av typen DateTime bruker ISO 8601. Anbefaling: bruk eksplisitt tidssone (Z for UTC eller offset +01:00, +02:00).
Eksempel: 2025-06-21T14:00:00Z

3.2 Standard kalender

Hvis calendarId ikke er angitt, brukes brukerens standardkalender: primary.

3.3 Rekursive hendelser

Opplistingen av hendelser støtter valget singleEvents, som bestemmer om rekursjonen skal utvides til enkeltinstanser.

Detaljerte API-operasjoner

4.1 CreateEventAsync

Beskrivelse: Oppretter en hendelse i brukerens Google-kalender (under hans/hennes Google/Gmail-konto).

Parameter	Type	Required	Beskrivelse
summary	String	Ja	Tittel / emne for hendelsen
startTime	DateTime	Ja	Start på hendelsen (ISO 8601)
endTime	DateTime	Ja	Slutt på hendelsen (ISO 8601)
description	String	Nei	Beskrivelse av hendelsen
location	String	Nei	Sted for hendelsen
sendNotifications	Bool	Nei	Om det skal sendes varsler til deltakerne/brukeren

Notater om validering

• endTime må være strengt etter startTime.
• Anbefaling: bruk konsistent tidssone for begge tider.

4.2 ListEventsAsync

Beskrivelse: Returnerer en liste over hendelser fra brukerens kalender innenfor det angitte tidsrommet.

Parameter	Type	Required	Beskrivelse
calendarId	String	Nei	ID for kalender (standard: primary)
timeMin	DateTime	Nei	Starttid for opplisting (inkludert)
timeMax	DateTime	Nei	Sluttid for opplisting (ekskludert)
maxResults	Int	Nei	Maks antall hendelser (standard: 250)
singleEvents	Bool	Nei	Utvid rekursjoner til instanser (standard: true)

Anbefalt bruk

• For stabile resultater, sett alltid timeMin og timeMax.
• Hvis du behandler rekursive møter i analysen, la singleEvents=true.

Sikkerhet og styring

• Operasjoner kjører i brukerens kontekst (delegert tilgang via OAuth).
• Tilkoblingen arbeider kun med kalenderdata innenfor rammen av tildelte tillatelser.
• Anbefaling: revider og logg minst calendarId, tidsvinduet (timeMin/timeMax) for opplisting og parametrene summary/startTime/endTime for opprettede hendelser.