Google Kalender

Siesta AI - Google Kalender giver mulighed for at oprette og læse begivenheder i Google Kalender via det officielle Google Calendar API. Opsætningen af assistenten og metoden til delegeret adgang er den samme som ved Gmail-integration, så de samme skærme og procedurer (OAuth, tildeling af adgang, deling) kan anvendes.

Hurtig forbindelse

For at oprette en forbindelse skal du klikke på Add Connection, vælge Google Calendar, og siden vil automatisk blive omdirigeret til Google-login. Efter login er kontoen forbundet.

Sådan forbinder du (OAuth, ligesom Gmail)

1. Add Connection -> vælg GoogleCalendar.
   

2. Google OAuth-login (adgang til Kalender).
   

3. Bekræft integrationsnavn (intern navn).
   

4. Samtykke til tilladelser (Kalender scopes analogt med Gmail).
   

Oversigt over forbindelser

• Navn på forbindelse: GoogleCalendar
• Type: Google Calendar API (REST)
• Autentificering: Google OAuth (delegeret brugeradgang) - detaljer ifølge intern konfiguration (uden for dokumentets omfang)
• Scope/operationer: CreateEventAsync, ListEventsAsync

Generelle principper

3.1 Tidsformater

Parametre af typen DateTime bruger ISO 8601. Anbefaling: brug eksplicit tidszone (Z for UTC eller offset +01:00, +02:00).
Eksempel: 2025-06-21T14:00:00Z

3.2 Standardkalender

Hvis calendarId ikke er angivet, bruges brugerens standardkalender: primary.

3.3 Rekurrente begivenheder

Opstilling af begivenheder understøtter valget singleEvents, som angiver, om rekursionen skal udvides til individuelle instanser.

Detaljerede API-operationer

4.1 CreateEventAsync

Beskrivelse: Opretter en begivenhed i brugerens Google Kalender (under hans/hendes Google/Gmail-konto).

Parameter	Type	Påkrævet	Beskrivelse
summary	String	Ja	Navn / emne for begivenheden
startTime	DateTime	Ja	Start på begivenheden (ISO 8601)
endTime	DateTime	Ja	Slut på begivenheden (ISO 8601)
description	String	Nej	Beskrivelse af begivenheden
location	String	Nej	Lokation for begivenheden
sendNotifications	Bool	Nej	Om der skal sendes notifikation til deltagerne/brugeren

Bemærkninger til validering

• endTime skal være strengt efter startTime.
• Anbefaling: brug en konsekvent tidszone for begge tider.

4.2 ListEventsAsync

Beskrivelse: Returnerer en liste over begivenheder fra brugerens kalender inden for det angivne tidsinterval.

Parameter	Type	Påkrævet	Beskrivelse
calendarId	String	Nej	ID for kalenderen (standard: primary)
timeMin	DateTime	Nej	Starttidspunkt for opstillingen (inklusive)
timeMax	DateTime	Nej	Sluttidspunkt for opstillingen (eksklusive)
maxResults	Int	Nej	Maks antal begivenheder (standard: 250)
singleEvents	Bool	Nej	Udfold rekursioner til instanser (standard: true)

Anbefalet brug

• For stabile resultater skal du altid angive timeMin og timeMax.
• Hvis du behandler rekurrente møder i analysen, skal du lade singleEvents=true.

Sikkerhed og governance

• Operationer kører i brugerens kontekst (delegeret adgang via OAuth).
• Forbindelsen arbejder kun med kalenderdata inden for de tildelte tilladelser.
• Anbefaling: auditér og log mindst calendarId, tidsvindue (timeMin/timeMax) for opstilling og parametrene summary/startTime/endTime for oprettede begivenheder.