Google Calendar — Get calendars
Google Calendar — Get calendars
Sección titulada «Google Calendar — Get calendars»Tipo: googlecalendar-get-calendars · Paquete: Google Calendar v1.0.5 · Salida: List<Dictionary<string,object>>
Lista los calendarios a los que tiene acceso la cuenta (el principal y los secundarios o compartidos). Úsala para descubrir el id de un calendario distinto del primary (una sala, un equipo, un calendario de turnos) antes de operar sobre él.
Cómo funciona
Sección titulada «Cómo funciona»Consulta la lista de calendarios de la cuenta de la sesión: los que aparecen en su Google Calendar. Devuelve una sola página de resultados, hasta 100 calendarios. Con una service account sin impersonateUser, la lista solo incluye los calendarios que se hayan añadido a esa cuenta.
Parámetros requeridos
Sección titulada «Parámetros requeridos»Ninguno.
Parámetros opcionales
Sección titulada «Parámetros opcionales»| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
session | ZoanGoogleCalendarSession | — | Sesión de Google Calendar — Connect. Dentro del body de Connect se hereda y puedes omitirla. |
Devuelve una List de Dictionary, uno por calendario:
| Clave | Tipo | Contenido |
|---|---|---|
id | string | ID del calendario; úsalo como calendarId. |
summary | string | Nombre del calendario. |
description | string | Descripción (nulo si no tiene). |
primary | bool | true en el calendario principal de la cuenta. |
accessRole | string | Permiso de la cuenta: owner, writer, reader o freeBusyReader. Para crear o cambiar eventos necesitas owner o writer. |
timeZone | string | Zona horaria del calendario (IANA), p. ej. America/Bogota. |
Errores comunes
Sección titulada «Errores comunes»| Mensaje | Causa y solución |
|---|---|
No hay una sesión de Google Calendar disponible. Indica 'session' desde una actividad googlecalendar-connect o coloca esta actividad dentro del cuerpo de la actividad Connect … | La actividad está fuera del body de Connect y no recibió session. Colócala dentro del body o pasa la sesión guardada. |
The service calendar has thrown an exception. HttpStatusCode is … | Google rechazó la llamada: calendario o evento inexistente, sin acceso, token vencido o cuota superada. Ver errores de la API de Google. |
Ejemplo
Sección titulada «Ejemplo»Encontrar el calendario «Soporte» y crear en él un evento:
Google Calendar — Connect credential = credential("calendar-equipo") └─ body: Google Calendar — Get calendars → output: calendarios For Each items = calendarios itemVariable = cal └─ activities: If condition = str(cal["summary"]) == "Soporte" └─ then: Google Calendar — Create event calendarId = cal["id"] summary = "Turno de guardia" start = "2026-06-20" end = "2026-06-21" allDay = trueActividades relacionadas
Sección titulada «Actividades relacionadas»- Google Calendar — Get events — buscar eventos en un calendario.
- Google Calendar — Create event — crear un evento en un calendario.
- Google Calendar — Connect — abrir la sesión.
- Todas las actividades de Google Calendar