Google Kalender

Siesta AI - Google Kalender möjliggör att skapa och läsa händelser i Google Kalender via det officiella Google Calendar API. Inställningen av assistenten och metoden för delegerad åtkomst är densamma som för Gmail-integrationen, så samma skärmar och procedurer (OAuth, tilldelning av åtkomst, delning) kan användas.

Snabb anslutning

För att skapa, klicka på Add Connection, välj Google Calendar och sidan omdirigeras automatiskt till Google-inloggning. Efter inloggning kopplas kontot samman.

Hur man ansluter (OAuth, precis som Gmail)

1. Add Connection -> välj GoogleCalendar.
   

2. Google OAuth-inloggning (åtkomst till Kalender).
   

3. Bekräfta integrationsnamn (internt namn).
   

4. Samtycke till behörigheter (Kalender scopes analogt med Gmail).
   

Översikt över anslutningar

• Namn på anslutning: GoogleCalendar
• Typ: Google Calendar API (REST)
• Autentisering: Google OAuth (delegerad användartillgång) - detaljer enligt intern konfiguration (utanför dokumentets omfattning)
• Scope/operationer: CreateEventAsync, ListEventsAsync

Allmänna principer

3.1 Tidsformat

Parametrar av typen DateTime använder ISO 8601. Rekommendation: använd explicit tidszon (Z för UTC eller offset +01:00, +02:00).
Exempel: 2025-06-21T14:00:00Z

3.2 Standardkalender

Om calendarId inte anges används användarens standardkalender: primary.

3.3 Återkommande händelser

Uppräkning av händelser stöder valet singleEvents, vilket anger om återkomster ska expandera till individuella instanser.

Detaljerade API-operationer

4.1 CreateEventAsync

Beskrivning: Skapar en händelse i användarens Google-kalender (under hans/hennes Google/Gmail-konto).

Parameter	Typ	Obligatorisk	Beskrivning
summary	String	Ja	Namn / ämne för händelsen
startTime	DateTime	Ja	Start av händelsen (ISO 8601)
endTime	DateTime	Ja	Slut av händelsen (ISO 8601)
description	String	Nej	Beskrivning av händelsen
location	String	Nej	Plats för händelsen
sendNotifications	Bool	Nej	Om notifikationer ska skickas till deltagare/användare

Noteringar om validering

• endTime måste strikt vara efter startTime.
• Rekommendation: använd konsekvent tidszon för båda tiderna.

4.2 ListEventsAsync

Beskrivning: Returnerar en lista över händelser från användarens kalender inom det angivna tidsintervallet.

Parameter	Typ	Obligatorisk	Beskrivning
calendarId	String	Nej	Kalender-ID (standard: primary)
timeMin	DateTime	Nej	Starttid för listning (inklusive)
timeMax	DateTime	Nej	Sluttid för listning (exklusive)
maxResults	Int	Nej	Max antal händelser (standard: 250)
singleEvents	Bool	Nej	Expandera återkomster till instanser (standard: true)

Rekommenderad användning

• För stabila resultat, ställ alltid in timeMin och timeMax.
• Om du bearbetar återkommande möten i analysen, låt singleEvents=true.

Säkerhet och styrning

• Operationerna körs i användarens kontext (delegerad åtkomst via OAuth).
• Anslutningen arbetar endast med kalenderdata inom ramen för beviljade behörigheter.
• Rekommendation: granska och logga minst calendarId, tidsfönster (timeMin/timeMax) för listning och parametrarna summary/startTime/endTime för skapade händelser.