Google Calendar — Connect

Google Calendar — Connect

Tipo: googlecalendar-connect  ·  Paquete: Google Calendar v1.0.5  ·  Salida: ZoanGoogleCalendarSession

Abre una sesión autenticada con Google Calendar. Es el punto de partida del paquete: todas las demás actividades (crear, actualizar, buscar eventos, gestionar invitados…) trabajan sobre esta sesión.

Cómo funciona

Se autentica con una conexión OAuth de Google de Zoan Cloud (o una service account) y abre la sesión. Tiene dos formas de uso:

• Con body: las actividades que coloques dentro heredan la sesión automáticamente; al terminar el bloque se cierra sola, también si una actividad falla.
• Sin body: devuelve la sesión como salida; guárdala en una variable, pásala por session a las demás actividades y ciérrala con Google Calendar — Close.

Al conectar consulta el calendario principal para conocer el email de la cuenta, que Respond (RSVP) usa por defecto. Si esa consulta falla (token vencido, sin red), no se detiene: el error aparece en la primera operación.

Autenticación

Dos modos en authType: oauth (por defecto — conexión OAuth de Zoan Cloud con el permiso de Calendar) o service-account (llave JSON guardada como credencial, con impersonateUser opcional para domain-wide delegation). El Designer muestra solo los campos del modo elegido. Ver la autenticación.

Parámetros requeridos

Ninguno.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
authType	string	oauth	Modo de autenticación: oauth o service-account.
credential	credential	—	Modo OAuth: la conexión OAuth de Google de Zoan Cloud, credential("nombre-clave").
serviceAccount	credential	—	Modo service account: credencial con el JSON completo de la llave.
impersonateUser	string	—	Modo service account (opcional): email del usuario del Workspace cuyo calendario se opera (domain-wide delegation).

Sub-flujos

body

Actividades a ejecutar dentro de la sesión. Heredan la sesión automáticamente y, al terminar, esta se cierra.

Salida

Sin body, devuelve un ZoanGoogleCalendarSession: asígnalo a una variable y pásalo como session a las demás actividades. Con body no devuelve nada (la sesión se hereda sola).

Errores comunes

Mensaje	Causa y solución
Credential '…' could not be resolved. Verify it exists in Zoan Automation and that there is an active session.	La conexión o credencial no existe en el ambiente, se usó el nombre legible en vez del nombre clave, o no hay sesión con Zoan Cloud.
'credential' no contiene un access_token válido. Revisa la conexión OAuth en Zoan Cloud.	La conexión existe pero no tiene token (por ejemplo, quedó Pendiente). Autorízala en Zoan Cloud.
'serviceAccount' debe apuntar a una credencial de Zoan Cloud que contenga la clave JSON de la cuenta de servicio.	En modo service account, la credencial está vacía.
La credencial de la cuenta de servicio no es una clave JSON válida de cuenta de servicio de Google. …	El valor guardado no es el JSON completo de la llave. Vuelve a guardarlo tal como lo descargaste.

Ejemplo

Google Calendar — Connect   credential = credential("calendar-equipo")
 └─ body:
      Google Calendar — Create event   summary = "Reunión semanal"
                                        start = "2026-06-15T14:30:00-05:00"   end = "2026-06-15T15:30:00-05:00"
                                        → output: evento
      Log   message = "Creado: " + evento["htmlLink"]

Fechas y calendario por defecto

Las fechas van en ISO 8601; inclúyeles el desfase (-05:00) para que no dependan de la zona horaria del equipo. calendarId por defecto es primary (el calendario principal). notify controla si se envían correos a los invitados — déjalo en false mientras pruebas para no enviar invitaciones reales. Ver calendarios, fechas y avisos.

Actividades relacionadas

• Google Calendar — Create event — crear un evento.
• Google Calendar — Get events — buscar eventos.
• Google Calendar — Close — cerrar la sesión (modo sin body).
• Todas las actividades de Google Calendar