Google Spread Sheet

El componente Google Spread Sheet permite a los usuarios de Nappai crear, leer, actualizar, duplicar y eliminar hojas de cálculo de Google directamente desde el dashboard. Con él puedes automatizar tareas que involucren datos almacenados en Google Sheets sin salir de la plataforma.

¿Cómo funciona?

El componente se conecta a la API de Google Sheets mediante una credencial previamente configurada en Nappai. Cuando seleccionas una operación, el componente envía la solicitud correspondiente a la API y devuelve los resultados. Si activas el Mapping Mode, el componente puede procesar varios registros a la vez, lo que facilita la integración con flujos de datos masivos.

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 SpreadSheet: Crea una nueva hoja de cálculo en tu cuenta de Google Drive.
Create Sheet: Añade una nueva hoja dentro de una hoja de cálculo existente.
Get: Recupera los datos de una hoja de cálculo o de una hoja específica.
Update: Modifica los datos de una hoja de cálculo existente.
Duplicate SpreadSheet: Duplica una hoja de cálculo completa.
Clear: Elimina los datos de una hoja o de todas las hojas de una hoja de cálculo.
Delete: Elimina una hoja de cálculo completa.

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:

Select Spreadsheet: Selecciona la hoja de cálculo de Google. En la operación Get, si este campo está vacío, se devolverán todas las hojas.
- Visible en: Create Sheet, Get, Update, Duplicate SpreadSheet, Clear, Delete
Operation: Selecciona la operación a realizar.
- Visible en: Create SpreadSheet, Create Sheet, Get, Update, Duplicate SpreadSheet, Clear, Delete
Include Data: Incluye los datos que contiene la hoja de cálculo.
- Visible en: Get
Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros de datos en lote.
- Visible en: Create SpreadSheet, Create Sheet, Get, Update, Duplicate SpreadSheet, Clear, Delete
Mode of Input: Modo a usar. Si se selecciona By Id, las entradas serán Id; si se selecciona By Selection, las entradas serán una selección; si se selecciona By Url, las entradas serán Url.
- Visible en: Create Sheet, Get, Update, Duplicate SpreadSheet, Clear, Delete
New Spreadsheet Name: Nombre que se asignará a la nueva hoja de cálculo.
- Visible en: Update, Duplicate SpreadSheet
Select Sheet: Selecciona la hoja a usar. Si se selecciona All SpreadSheet, se usarán todas las hojas en la operación.
- Visible en: Get, Clear, Delete
Sheet Name: Nombre que se usará para las nuevas hojas.
- Visible en: Create SpreadSheet, Create Sheet
Spreadsheet ID: ID de la hoja de cálculo a usar. En la operación Get, si este campo está vacío, se devolverán todas las hojas.
- Visible en: Create Sheet, Get, Update, Duplicate SpreadSheet, Clear, Delete
Spreadsheet Name: Nombre que se usará en la hoja de cálculo.
- Visible en: Create SpreadSheet
Tool Name: El nombre de la herramienta que se usará cuando este componente esté conectado como herramienta. Este nombre se mostrará al agente cuando seleccione herramientas.
- Visible en: Create SpreadSheet, Create Sheet, Get, Update, Duplicate SpreadSheet, Clear, Delete
Tool Description: Descripción detallada de lo que hace esta herramienta. Ayuda al agente a entender cuándo y cómo usarla eficazmente.
- Visible en: Create SpreadSheet, Create Sheet, Get, Update, Duplicate SpreadSheet, Clear, Delete
Tools arguments metadata: Define los metadatos de los argumentos para las herramientas.
- Visible en: Create SpreadSheet, Create Sheet, Get, Update, Duplicate SpreadSheet, Clear, Delete

Nota: Este componente requiere una credencial de tipo Google Sheets API.

Configura primero la credencial en la sección de credenciales de Nappai.

Luego selecciona esa credencial en el campo Credential del componente.
La credencial necesita un Client Id, un Client Secret y un nivel de acceso de lectura a hojas de cálculo.

Salidas

Data: Devuelve los datos obtenidos o modificados en la hoja de cálculo.
Tool: Devuelve una representación de la herramienta que puede ser utilizada por agentes de IA dentro de Nappai.

Ejemplo de Uso

Crear una nueva hoja de cálculo

Arrastra el componente Google Spread Sheet al flujo.
En el campo Operation, selecciona Create SpreadSheet.
En Spreadsheet Name, escribe el nombre que deseas darle.
En Tool Name y Tool Description, escribe un nombre y una breve descripción para que el agente las reconozca.
Ejecuta el flujo. El componente creará la hoja de cálculo y devolverá su ID en la salida Data.

Obtener datos de una hoja existente

Arrastra el componente y selecciona la operación Get.
En Select Spreadsheet, elige la hoja de cálculo que quieres leer.
En Select Sheet, selecciona la hoja específica o deja All SpreadSheet para leer todas.
Marca Include Data si quieres que se devuelvan los datos.
Ejecuta el flujo. Los datos se devolverán en la salida Data y estarán disponibles para ser usados por otros componentes.

Componentes Relacionados

Google Drive Component – Gestiona archivos y carpetas en Google Drive.
Google Calendar Component – Interactúa con eventos de Google Calendar.
Nappai Scheduler – Programa la ejecución de flujos que usan Google Sheets.

Consejos y Mejores Prácticas

Usa el Modo de Mapeo cuando necesites procesar listas de hojas de cálculo o datos en lote.
Limita la cantidad de datos que recuperas con la operación Get para evitar tiempos de espera largos.
Guarda el ID de la hoja de cálculo en una variable para reutilizarla en operaciones posteriores.
Configura la credencial con el mínimo nivel de acceso necesario (solo lectura si no vas a modificar datos).

Consideraciones de Seguridad

La credencial de Google Sheets API contiene información sensible; no la compartas públicamente.
Asegúrate de que solo los usuarios autorizados tengan acceso a la credencial en Nappai.
Revisa los permisos de la hoja de cálculo para evitar exponer datos confidenciales.