Google Calendar
Gestionar eventos de Google Calendar
Google Calendar es el potente servicio de calendario y programación de Google que proporciona una plataforma completa para gestionar eventos, reuniones y citas. Con una integración perfecta en todo el ecosistema de Google y una adopción generalizada, Google Calendar ofrece funciones robustas tanto para necesidades de programación personales como profesionales.
Con Google Calendar, puedes:
- Crear y gestionar eventos: Programar reuniones, citas y recordatorios con información detallada
- Enviar invitaciones de calendario: Notificar y coordinar automáticamente con los asistentes mediante invitaciones por correo electrónico
- Creación de eventos con lenguaje natural: Añadir eventos rápidamente usando lenguaje conversacional como "Reunión con Juan mañana a las 3pm"
- Ver y buscar eventos: Encontrar y acceder fácilmente a tus eventos programados en múltiples calendarios
- Gestionar múltiples calendarios: Organizar diferentes tipos de eventos en varios calendarios
En Sim, la integración con Google Calendar permite a tus agentes crear, leer y gestionar eventos de calendario de forma programática. Esto permite potentes escenarios de automatización como programar reuniones, enviar invitaciones de calendario, comprobar disponibilidad y gestionar detalles de eventos. Tus agentes pueden crear eventos con entrada en lenguaje natural, enviar invitaciones de calendario automatizadas a los asistentes, recuperar información de eventos y listar próximos eventos. Esta integración cierra la brecha entre tus flujos de trabajo de IA y la gestión de calendarios, permitiendo una automatización de programación y coordinación perfecta con una de las plataformas de calendario más utilizadas del mundo.
Integra Google Calendar en el flujo de trabajo. Puede crear, leer, actualizar y listar eventos del calendario. Requiere OAuth.
Crear un nuevo evento en Google Calendar
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
calendarId | string | No | ID del calendario (por defecto es el primario) |
summary | string | Sí | Título/resumen del evento |
description | string | No | Descripción del evento |
location | string | No | Ubicación del evento |
startDateTime | string | Sí | Fecha y hora de inicio. DEBE incluir el desplazamiento de zona horaria (p. ej., 2025-06-03T10:00:00-08:00) O proporcionar el parámetro timeZone |
endDateTime | string | Sí | Fecha y hora de finalización. DEBE incluir el desplazamiento de zona horaria (p. ej., 2025-06-03T11:00:00-08:00) O proporcionar el parámetro timeZone |
timeZone | string | No | Zona horaria (p. ej., America/Los_Angeles). Obligatorio si la fecha y hora no incluye desplazamiento. Por defecto es America/Los_Angeles si no se proporciona. |
attendees | array | No | Array de direcciones de correo electrónico de los asistentes |
sendUpdates | string | No | Cómo enviar actualizaciones a los asistentes: all, externalOnly o none |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de confirmación de creación del evento |
metadata | json | Metadatos del evento creado incluyendo ID, estado y detalles |
Listar eventos de Google Calendar
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
calendarId | string | No | ID del calendario (por defecto es el primario) |
timeMin | string | No | Límite inferior para eventos (marca de tiempo RFC3339, p. ej., 2025-06-03T00:00:00Z) |
timeMax | string | No | Límite superior para eventos (marca de tiempo RFC3339, p. ej., 2025-06-04T00:00:00Z) |
orderBy | string | No | Orden de los eventos devueltos (startTime o updated) |
showDeleted | boolean | No | Incluir eventos eliminados |
| Parámetro | Tipo | Descripción |
|---|
content | string | Resumen del recuento de eventos encontrados |
metadata | json | Lista de eventos con tokens de paginación y detalles del evento |
Obtener un evento específico de Google Calendar
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
calendarId | string | No | ID del calendario (predeterminado: primario) |
eventId | string | Sí | ID del evento a recuperar |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de confirmación de recuperación del evento |
metadata | json | Detalles del evento incluyendo ID, estado, horarios y asistentes |
Crear eventos a partir de texto en lenguaje natural
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
calendarId | string | No | ID del calendario (predeterminado: primario) |
text | string | Sí | Texto en lenguaje natural que describe el evento (p. ej., "Reunión con Juan mañana a las 3pm") |
attendees | array | No | Array de direcciones de correo electrónico de los asistentes (también se acepta cadena separada por comas) |
sendUpdates | string | No | Cómo enviar actualizaciones a los asistentes: all, externalOnly o none |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de confirmación de creación del evento a partir de lenguaje natural |
metadata | json | Metadatos del evento creado incluyendo detalles analizados |
Invitar asistentes a un evento existente de Google Calendar
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
calendarId | string | No | ID del calendario (por defecto es el primario) |
eventId | string | Sí | ID del evento al que invitar asistentes |
attendees | array | Sí | Array de direcciones de correo electrónico de los asistentes a invitar |
sendUpdates | string | No | Cómo enviar actualizaciones a los asistentes: all, externalOnly, o none |
replaceExisting | boolean | No | Si reemplazar a los asistentes existentes o añadirlos (por defecto es false) |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de confirmación de invitación a asistentes con estado de entrega de correo electrónico |
metadata | json | Metadatos actualizados del evento incluyendo lista de asistentes y detalles |
- Categoría:
tools
- Tipo:
google_calendar
Mover un evento a un calendario diferente. Devuelve solo campos alineados con la API.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
calendarId | string | No | ID del calendario de Google de origen (p. ej., primary o calendar@group.calendar.google.com) |
eventId | string | Sí | ID del evento de Google Calendar a mover |
destinationCalendarId | string | Sí | ID del calendario de Google de destino |
sendUpdates | string | No | Cómo enviar actualizaciones a los asistentes: all, externalOnly o none |
| Parámetro | Tipo | Descripción |
|---|
id | string | ID del evento |
htmlLink | string | Enlace del evento |
status | string | Estado del evento |
summary | string | Título del evento |
description | string | Descripción del evento |
location | string | Ubicación del evento |
start | json | Inicio del evento |
end | json | Fin del evento |
attendees | json | Asistentes del evento |
creator | json | Creador del evento |
organizer | json | Organizador del evento |
Obtener instancias de un evento recurrente de Google Calendar. Devuelve solo campos alineados con la API.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
calendarId | string | No | ID del calendario de Google (p. ej., primary o calendar@group.calendar.google.com) |
eventId | string | Sí | ID del evento recurrente del que obtener instancias |
timeMin | string | No | Límite inferior para las instancias (marca de tiempo RFC3339, p. ej., 2025-06-03T00:00:00Z) |
timeMax | string | No | Límite superior para las instancias (marca de tiempo RFC3339, p. ej., 2025-06-04T00:00:00Z) |
maxResults | number | No | Número máximo de instancias a devolver (por defecto 250, máximo 2500) |
pageToken | string | No | Token para recuperar páginas posteriores de resultados |
showDeleted | boolean | No | Incluir instancias eliminadas |
| Parámetro | Tipo | Descripción |
|---|
nextPageToken | string | Token de página siguiente |
timeZone | string | Zona horaria del calendario |
instances | json | Lista de instancias de eventos recurrentes |
Listar todos los calendarios del usuario
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
minAccessRole | string | No | Rol de acceso mínimo para los calendarios devueltos: freeBusyReader, reader, writer u owner |
maxResults | number | No | Número máximo de calendarios a devolver (predeterminado 100, máximo 250) |
pageToken | string | No | Token para recuperar páginas posteriores de resultados |
showDeleted | boolean | No | Incluir calendarios eliminados |
showHidden | boolean | No | Incluir calendarios ocultos |
| Parámetro | Tipo | Descripción |
|---|
nextPageToken | string | Token de página siguiente |
calendars | array | Lista de calendarios |
↳ id | string | ID del calendario |
↳ summary | string | Título del calendario |
↳ description | string | Descripción del calendario |
↳ location | string | Ubicación del calendario |
↳ timeZone | string | Zona horaria del calendario |
↳ accessRole | string | Rol de acceso para el calendario |
↳ backgroundColor | string | Color de fondo del calendario |
↳ foregroundColor | string | Color de primer plano del calendario |
↳ primary | boolean | Si este es el calendario principal |
↳ hidden | boolean | Si el calendario está oculto |
↳ selected | boolean | Si el calendario está seleccionado |
Crear eventos a partir de texto en lenguaje natural. Devuelve solo campos alineados con la API.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
calendarId | string | No | ID del calendario de Google (p. ej., primary o calendar@group.calendar.google.com) |
text | string | Sí | Texto en lenguaje natural que describe el evento (p. ej., "Reunión con John mañana a las 3pm") |
attendees | array | No | Array de direcciones de correo electrónico de los asistentes (también se acepta cadena separada por comas) |
sendUpdates | string | No | Cómo enviar actualizaciones a los asistentes: all, externalOnly o none |
| Parámetro | Tipo | Descripción |
|---|
id | string | ID del evento |
htmlLink | string | Enlace del evento |
status | string | Estado del evento |
summary | string | Título del evento |
description | string | Descripción del evento |
location | string | Ubicación del evento |
start | json | Inicio del evento |
end | json | Fin del evento |
attendees | json | Asistentes del evento |
creator | json | Creador del evento |
organizer | json | Organizador del evento |
Invitar asistentes a un evento existente de Google Calendar. Devuelve solo campos alineados con la API.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
calendarId | string | No | ID del calendario de Google (p. ej., primary o calendar@group.calendar.google.com) |
eventId | string | Sí | ID del evento de Google Calendar al que invitar asistentes |
attendees | array | Sí | Array de direcciones de correo electrónico de los asistentes a invitar |
sendUpdates | string | No | Cómo enviar actualizaciones a los asistentes: all, externalOnly o none |
replaceExisting | boolean | No | Si reemplazar los asistentes existentes o agregarlos (por defecto es false) |
| Parámetro | Tipo | Descripción |
|---|
id | string | ID del evento |
htmlLink | string | Enlace del evento |
status | string | Estado del evento |
summary | string | Título del evento |
description | string | Descripción del evento |
location | string | Ubicación del evento |
start | json | Inicio del evento |
end | json | Fin del evento |
attendees | json | Asistentes del evento |
creator | json | Creador del evento |
organizer | json | Organizador del evento |