Ir al contenido principal

Integración de Google Calendar - Guía de configuración

Conecta tu cuenta de Google Calendar a Goodweek para leer, crear y gestionar eventos de calendario y horarios directamente desde tu espacio de trabajo de IA.

A
Escrito por Antoine Stempien

Conecta tu cuenta de Google Calendar a Goodweek para leer, crear y gestionar eventos de calendario y horarios directamente desde tu espacio de trabajo de IA.

ℹ️ Nota de gobernanza

Goodweek nunca superará los niveles de acceso otorgados al usuario dentro de Google Calendar, lo que garantiza la alineación con las políticas de gobernanza de tu organización. Los resultados y las funciones disponibles pueden variar según los permisos específicos y el acceso autenticado de cada usuario.

📋 Requisitos previos

Antes de que cualquier usuario pueda ver y conectar la integración de Google Calendar, el administrador de tu organización debe habilitarla primero desde el Panel de administración de Goodweek, en la pestaña Integraciones.

Configuración del administrador

Cuentas personales de Google (@gmail.com)

No se requiere configuración por parte del administrador. Conéctate directamente siguiendo los pasos de Conexión del usuario que se indican a continuación.

Cuentas de Google Workspace (trabajo o escuela)

Según la política de acceso a la API de tu organización, puede aplicarse uno de los siguientes escenarios.

Escenario 1 — Predeterminado (acceso de terceros sin restricciones)

Cualquier usuario puede conectarse directamente sin intervención del administrador.

Escenario 2 — El acceso de terceros está restringido (error admin_policy_enforced)

Un superadministrador de Google Workspace debe marcar Composio como una aplicación de confianza:

  1. Inicia sesión en admin.google.com como superadministrador.

  2. Ve a Seguridad → Control de acceso y datos → Controles de API → Gestionar el acceso de aplicaciones de terceros.

  3. Haz clic en Configure new app, busca Composio, selecciónalo, establece el acceso como Trusted y haz clic en Save.

Escenario 3 — Todo el acceso de terceros a la API está bloqueado

Ve a admin.google.com → Seguridad → Control de acceso y datos → Controles de API y revisa la configuración "Third-party app access to Google APIs". Si está bloqueada, el administrador debe crear una excepción para Composio antes de seguir el Escenario 2.

Conexión del usuario

  1. En Goodweek, ve a Integraciones.

  2. Busca Google Calendar y haz clic en Connect.

  3. Serás redirigido a Google, donde se te pedirá que inicies sesión.

  4. Revisa los permisos solicitados y haz clic en Allow para volver a Goodweek.

Notas importantes

  • Cada usuario debe conectar su propia cuenta individualmente.

  • Goodweek solo puede acceder a los calendarios a los que tu cuenta de usuario individual tiene acceso. Los calendarios compartidos solo son accesibles si se te han otorgado los permisos de uso compartido correspondientes.

  • Si tienes varias cuentas de Google, asegúrate de seleccionar la correcta durante el paso de conexión.

  • Puedes revocar el acceso de Goodweek en cualquier momento desde myaccount.google.com → Seguridad → Aplicaciones de terceros con acceso a la cuenta.


Herramientas disponibles

Herramienta

Descripción

Tipo

Create Event

Crea un nuevo evento en un Google Calendar con hora de inicio, duración, asistentes y otros detalles.

Escritura

Update Event

Actualiza los campos de un evento de calendario existente mediante su ID.

Escritura

Patch Event

Actualiza parcialmente campos específicos de un evento de calendario existente sin sobrescribir el resto.

Escritura

Quick Add Event

Crea un evento de calendario básico analizando una cadena de texto en lenguaje natural (p. ej., «Comida con Alice mañana a la 1pm»).

Escritura

Get Event

Recupera un único evento de calendario mediante su ID exclusivo.

Lectura

Find Event

Busca eventos en un calendario mediante una consulta de texto, intervalos de tiempo y tipos de evento.

Lectura

List Events

Devuelve los eventos de un calendario especificado dentro de un intervalo de tiempo determinado.

Lectura

List Events from All Calendars

Devuelve una lista unificada de eventos de todos los calendarios de la lista de calendarios del usuario para un intervalo de tiempo determinado.

Lectura

Get Event Instances

Devuelve todas las instancias de un evento recurrente dentro de un intervalo de tiempo opcional.

Lectura

Find Free Slots

Encuentra franjas horarias libres y ocupadas en los calendarios especificados dentro de un intervalo de tiempo definido.

Lectura

Get Current Date and Time

Devuelve la fecha y hora actuales de una zona horaria determinada, útil antes de calcular fechas relativas.

Lectura

Create a New Calendar

Crea un nuevo Google Calendar secundario con un título especificado y ajustes opcionales.

Escritura

List Google Calendars

Recupera todos los calendarios de la lista de Google Calendar del usuario.

Lectura

Patch Calendar

Actualiza parcialmente los metadatos de un calendario existente (nombre, descripción, zona horaria, etc.).

Escritura

Move Event

Mueve un evento a un calendario diferente.

Lectura

List Calendar Resources

Recupera recursos de calendario, como salas de reuniones, de un dominio de Google Workspace.

Lectura

Create ACL Rule

Crea una regla de control de acceso para otorgar permisos de uso compartido de calendario a un usuario, grupo o dominio.

Escritura

List ACL Rules

Recupera todas las reglas de control de acceso de un calendario especificado.

Lectura

Delete Event

Elimina permanentemente un evento de calendario especificado mediante su ID.

⚠️ Destructivo

Remove Attendee from Event

Elimina a un asistente específico de un evento de calendario existente.

⚠️ Destructivo

Delete Calendar

Elimina permanentemente un calendario secundario propiedad del usuario.

⚠️ Destructivo

Clear Calendar

Elimina todos los eventos de un calendario principal conservando el propio calendario.

⚠️ Destructivo

Delete ACL Rule

Elimina un permiso de uso compartido de un Google Calendar.

⚠️ Destructivo

Casos de uso

  • Crea y gestiona eventos desde las conversaciones. Programa reuniones, configura recordatorios o añade eventos a tu Google Calendar directamente desde una conversación de Goodweek, incluyendo asistentes, ubicación y descripción, sin cambiar a la aplicación de calendario.

  • Comprueba la disponibilidad antes de programar. Consulta las franjas libres y ocupadas de uno o varios calendarios para encontrar un horario de reunión adecuado antes de proponerlo a los participantes.

  • Consulta tu agenda cuando lo necesites. Recupera los eventos de hoy, de esta semana o de cualquier intervalo de tiempo personalizado en todos tus calendarios para obtener una visión rápida de tu horario sin salir de tu espacio de trabajo.

  • Actualiza o cancela eventos rápidamente. Modifica los detalles de un evento o elimina asistentes de reuniones existentes directamente desde Goodweek cuando cambien los planes, sin tener que navegar por la interfaz del calendario.


Solución de problemas

"Error 400: admin_policy_enforced" al conectar

El administrador de tu organización ha restringido el acceso de aplicaciones de terceros. Solo un superadministrador de Google Workspace puede solucionar esto siguiendo el Escenario 2 anterior.

El administrador marcó Composio como Trusted pero el error sigue apareciendo

Puede haber un retraso de propagación. Espera unos minutos y vuelve a intentarlo.

La integración no es visible en Goodweek

Asegúrate de que el administrador de tu organización haya habilitado la integración de Google Calendar desde el Panel de administración de Goodweek, en la pestaña Integraciones.

Referencias

¿Ha quedado contestada tu pregunta?