Google Calendar

Siesta AI - Google Calendar permite crear y leer eventos en Google Calendar a través de la API oficial de Google Calendar. La configuración del asistente y el método de acceso delegado son los mismos que para la integración de Gmail, por lo que se pueden utilizar las mismas pantallas y procedimientos (OAuth, asignación de acceso, compartición).

Conexión rápida

Para crear, simplemente haz clic en Add Connection, selecciona Google Calendar y la página se redirigirá automáticamente a la página de inicio de sesión de Google. Después de iniciar sesión, la cuenta estará vinculada.

Cómo conectarse (OAuth, al igual que Gmail)

1. Add Connection -> selecciona GoogleCalendar.
   

2. Inicio de sesión de Google OAuth (acceso al Calendar).
   

3. Confirma el nombre de la integración (nombre interno).
   

4. Consentimiento de permisos (alcances de Calendar de manera análoga a Gmail).
   

Resumen de Conexiones

• Nombre de Conexión: GoogleCalendar
• Tipo: API de Google Calendar (REST)
• Autenticación: Google OAuth (acceso delegado del usuario) - detalles según la configuración interna (fuera del alcance del documento)
• Scope/operaciones: CreateEventAsync, ListEventsAsync

Principios generales

3.1 Formatos de tiempo

Los parámetros de tipo DateTime utilizan ISO 8601. Recomendación: usar zona horaria explícita (Z para UTC o desplazamiento +01:00, +02:00).
Ejemplo: 2025-06-21T14:00:00Z

3.2 Calendario predeterminado

Si no se proporciona calendarId, se utilizará el calendario predeterminado del usuario: primary.

3.3 Eventos recurrentes

La enumeración de eventos admite la opción singleEvents, que determina si la recurrencia se desglosa en instancias individuales.

Operaciones detalladas de la API

4.1 CreateEventAsync

Descripción: Crea un evento en el calendario de Google del usuario (bajo su cuenta de Google/Gmail).

Parámetro	Tipo	Requerido	Descripción
summary	String	Sí	Título / asunto del evento
startTime	DateTime	Sí	Inicio del evento (ISO 8601)
endTime	DateTime	Sí	Fin del evento (ISO 8601)
description	String	No	Descripción del evento
location	String	No	Ubicación del evento
sendNotifications	Bool	No	Si se debe enviar notificación a los participantes/usuario

Notas sobre la validación

• endTime debe ser estrictamente después de startTime.
• Recomendación: usar zona horaria consistente para ambos tiempos.

4.2 ListEventsAsync

Descripción: Devuelve una lista de eventos del calendario del usuario en el rango de tiempo especificado.

Parámetro	Tipo	Requerido	Descripción
calendarId	String	No	ID del calendario (predeterminado: primary)
timeMin	DateTime	No	Inicio del tiempo para la lista (incluido)
timeMax	DateTime	No	Fin del tiempo para la lista (excluido)
maxResults	Int	No	Máximo número de eventos (predeterminado: 250)
singleEvents	Bool	No	Desglosar recurrencias en instancias (predeterminado: true)

Uso recomendado

• Para resultados estables, siempre establece timeMin y timeMax.
• Si procesas reuniones recurrentes en análisis, deja singleEvents=true.

Seguridad y gobernanza

• Las operaciones se ejecutan en el contexto del usuario (acceso delegado a través de OAuth).
• La conexión solo trabaja con datos de calendario dentro del alcance de los permisos otorgados.
• Recomendación: auditar y registrar al menos calendarId, ventana de tiempo (timeMin/timeMax) para la enumeración y parámetros summary/startTime/endTime para los eventos creados.