Google Calendar — Get events

Google Calendar — Get events

Tipo: googlecalendar-get-events  ·  Paquete: Google Calendar v1.0.5  ·  Salida: List<Dictionary<string,object>>

Lista o busca eventos de un calendario dentro de un rango de fechas. Es la forma habitual de obtener los IDs de los eventos a actualizar, cancelar o procesar, y de leer la agenda de un periodo para preparar trabajo.

Cómo funciona

Consulta el calendario calendarId (por defecto primary) con una llamada a Google:

• Devuelve los eventos que coinciden con el periodo: los que terminan después de timeMin y empiezan antes de timeMax. Un evento que ya empezó pero sigue en curso a las timeMin también aparece.
• Sin timeMin, parte de ahora (el momento de la ejecución). Sin timeMax, no hay límite superior.
• timeMin y timeMax aceptan un DateTime o texto ISO 8601; sin desfase se leen en la zona de timeZone o, si lo omites, en la zona del calendario, no en la del equipo. Desde la versión 1.0.5.
• Los eventos recurrentes se expanden: cada ocurrencia llega como un evento con su propio ID.
• Los eventos llegan ordenados por inicio. Los eventos cancelados no aparecen.
• query busca texto libre en los campos del evento (título, descripción, ubicación, invitados…).
• Devuelve hasta maxResults eventos de una sola página de resultados (Google entrega como máximo 2500 por página). Para periodos con muchos eventos, acota con timeMin/timeMax.

Parámetros requeridos

Ninguno.

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.
calendarId	string	primary	ID del calendario (de Get calendars). primary es el calendario principal de la cuenta.
query	string	—	Búsqueda de texto libre en los campos del evento.
timeMin	DateTime | string	la hora actual	Inicio del periodo: un DateTime o texto ISO 8601, p. ej. 2026-06-01T00:00:00.
timeMax	DateTime | string	—	Fin del periodo, en el mismo formato.
timeZone	string	la del calendario	Zona horaria IANA (p. ej. America/Bogota) en la que se leen timeMin y timeMax sin desfase. Desde la versión 1.0.5.
maxResults	int	50	Número máximo de eventos. Un valor no numérico o menor que 1 usa 50.

Salida

Devuelve una List de Dictionary: cada elemento es un evento con los datos de un evento (id, summary, description, location, start, end, allDay, status, organizer, attendees, htmlLink, meetLink). Si no hay eventos, devuelve una lista vacía, no un error.

Errores comunes

Mensaje	Causa y solución
Fecha/hora no válida: «…». Usa ISO 8601 (p. ej. 2026-06-15T14:30:00) o un valor DateTime.	timeMin o timeMax no es un DateTime ni un texto ISO 8601 (por ejemplo, 15/06/2026). Pasa el DateTime directamente o el texto en formato yyyy-MM-ddTHH:mm:ss.
Zona horaria desconocida: «…». Usa una zona IANA como America/Bogota.	timeZone no es una zona IANA válida.
La fecha no trae zona horaria y no se pudo obtener la del calendario. …	La fecha no tiene desfase, timeZone está vacío y la cuenta no pudo leer la zona del calendario. Indica timeZone o incluye el desfase en la fecha.
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

Revisar las reuniones de mañana y registrar las que no tienen ubicación:

Google Calendar — Connect   credential = credential("calendar-equipo")
 └─ body:
      Google Calendar — Get events   timeMin = DateTime.Today.AddDays(1)
                                     timeMax = DateTime.Today.AddDays(2)
                                     → output: eventos
      For Each   items = eventos   itemVariable = evento
       └─ activities:
            If   condition = isNull(evento["location"])
             └─ then:
                  Log   message = "Sin ubicación: " + evento["summary"] + " (" + evento["start"] + ")"

Actividades relacionadas

• Google Calendar — Get event by ID — leer un evento concreto.
• Google Calendar — Update event — modificar un evento.
• Google Calendar — Delete event — cancelar un evento.
• Todas las actividades de Google Calendar