Google Calendar Calendars

Google Calendar Calendars es un componente que te permite crear, leer, actualizar y eliminar eventos en tus calendarios de Google directamente desde el dashboard de Nappai. Con él puedes automatizar tareas como programar reuniones, sincronizar eventos con otras aplicaciones o mantener tu agenda actualizada sin salir de la plataforma.

¿Cómo funciona?

El componente se conecta a la API de Google Calendar mediante una credencial previamente configurada en Nappai. Cuando seleccionas una operación (Create, Get, Update o Delete) el componente envía la solicitud correspondiente a Google Calendar y devuelve los resultados. Si activas el Mapping Mode, el componente puede procesar varios registros a la vez, lo que facilita la creación o actualización masiva de eventos.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

Create: Crea un nuevo evento en el calendario especificado.
Get: Obtiene información de uno o varios eventos. Si no se indica un Calendar Id, devuelve todos los calendarios disponibles.
Update: Modifica un evento existente en el calendario.
Delete: Elimina un evento del calendario.

Para usar el componente, primero selecciona la operación que necesitas en el campo “Operation” (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

Fixed (Fijo): Escribes el valor directamente en el campo.
Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

Operation: Selecciona la operación que deseas ejecutar.
- Visible en: Create, Get, Update, Delete
Calendar Id: Introduce el Id del calendario. En la operación Get, si no se proporciona, se devolverán todos los calendarios.
- Visible en: Get, Update, Delete
Calendar Selection: Selecciona el calendario desde tu Google Calendar.
- Visible en: Get, Update, Delete
Description: La descripción del evento.
- Visible en: Create, Update
Input Type: El tipo de entrada a usar.
- Visible en: Get, Update, Delete
Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
- Visible en: Create, Get, Update, Delete
Summary: El resumen del evento.
- Visible en: Create, Update
Tool Name: El nombre de la herramienta que se usará cuando este componente esté conectado como herramienta.
- Visible en: Create, Get, Update, Delete
Tool Description: Una descripción detallada de lo que hace esta herramienta.
- Visible en: Create, Get, Update, Delete
Tools arguments metadata: Define los metadatos de los argumentos para las herramientas.
- Visible en: Create, Get, Update, Delete
Credential: Selecciona la credencial Google Calendar previamente configurada en Nappai.
- Visible en: Create, Get, Update, Delete

Nota: Para usar este componente, primero debes configurar la credencial Google Calendar en la sección de credenciales de Nappai y luego seleccionarla en el campo Credential del componente.

Salidas

Data: Devuelve los datos de la operación realizada (por ejemplo, la información del evento creado o actualizado).
Tool: Devuelve una representación de la herramienta que puede ser utilizada por agentes de IA dentro de Nappai.

Ejemplo de Uso

Escenario: Crear un evento de reunión en tu calendario principal.

Arrastra el componente Google Calendar Calendars al flujo de trabajo.
En el campo Operation, selecciona Create.
En Calendar Id, escribe el ID de tu calendario principal (o déjalo vacío para usar el calendario por defecto).
En Summary, escribe “Reunión de equipo”.
En Description, escribe “Revisión de avances del proyecto”.
En Credential, selecciona la credencial Google Calendar que configuraste.
Ejecuta el flujo.
La salida Data mostrará los detalles del evento creado, y la salida Tool permitirá que un agente de IA lo utilice en pasos posteriores.

Uso de Mapping Mode: Si necesitas crear varios eventos a la vez, activa Mapping Mode, conecta la salida de un componente que genere una lista de eventos a la entrada Mapping Data, y configura los campos Summary y Description con expresiones Javascript que extraigan los valores de cada registro.

Componentes Relacionados

Google Calendar Custom – Permite configuraciones avanzadas de la API de Google Calendar.
Google Calendar Event – Maneja eventos individuales con mayor detalle.

Consejos y Mejores Prácticas

Usa Mapping Mode cuando necesites procesar listas de eventos para ahorrar tiempo.
Mantén tus credenciales seguras: no compartas la credencial de Google Calendar con usuarios que no necesiten acceso.
Prueba con un solo evento antes de activar el modo de mapeo para asegurarte de que los datos están correctos.
Revisa los límites de la API de Google Calendar para evitar bloqueos por exceso de peticiones.

Consideraciones de Seguridad

La credencial Google Calendar contiene información sensible (Client Id, Client Secret). Asegúrate de que solo los usuarios autorizados tengan acceso a la sección de credenciales de Nappai.
Cuando uses Mapping Mode, verifica que los datos que se envían a Google Calendar no incluyan información confidencial sin cifrar.