Saltearse al contenido
Nappai Documentation

Google Sheet Reader

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

El Google Sheet Reader te permite extraer datos de una hoja de cálculo de Google directamente a tu flujo de trabajo en Nappai. Solo necesitas indicar la hoja que quieres leer y el componente se encargará de conectarse a Google Sheets, descargar la información y entregártela en formato estructurado o como texto JSON.

¿Cómo funciona?

El componente se conecta a la API de Google Sheets usando una credencial previamente configurada en Nappai. Cuando lo arrastras al dashboard, seleccionas la hoja de cálculo y opcionalmente el nombre de la pestaña que quieres leer. Internamente, el componente hace una llamada HTTP a la API de Google Sheets, recupera los datos en formato JSON y los convierte en un objeto Data que puede ser usado por otros componentes. También puedes obtener la representación JSON completa o convertir el resultado en una herramienta que un agente de IA pueda usar.

Entradas

  • or Select folder: Selecciona una carpeta que contenga las hojas de cálculo de Google.
  • Select Google Sheet: Selecciona la hoja de cálculo que deseas leer.
  • Sheet Name: Nombre de la pestaña específica que quieres leer (opcional).
  • Tool Name: El nombre que tendrá la herramienta cuando el componente se conecte como una herramienta de IA. Este nombre se mostrará al agente al elegir herramientas.
  • Tool Description: Descripción detallada de lo que hace esta herramienta para que el agente la entienda.
  • Tools arguments metadata: Define los metadatos de los argumentos que la herramienta aceptará.

Credencial

Para que el componente funcione necesitas una credencial de tipo Google Sheets API:

  1. Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada Google Sheets API.
  2. Ingresa tu Client Id y Client Secret que puedes encontrar en la consola de Google Cloud.
  3. Selecciona el nivel de acceso Spreadsheet read access.
  4. En el componente, elige la credencial que acabas de crear en el campo Credential.

Nota: Los campos de la credencial (Client Id, Client Secret, Spreadsheet read access) no aparecen en la lista de entradas porque ya están configurados en la sección de credenciales.

Salidas

  • Data: Objeto de datos estructurado (método: fetch_content).
  • JSON Data: Texto con la representación JSON de los datos (método: get_json_data).
  • Tool: Objeto de herramienta que puede ser usado por un agente de IA (método: to_toolkit).

Ejemplo de Uso

  1. Añade el componente al dashboard.
  2. Selecciona la carpeta que contiene tus archivos de Google Sheets.
  3. Elige la hoja de cálculo que quieres leer.
  4. (Opcional) Especifica el nombre de la pestaña si solo necesitas una parte de la hoja.
  5. Configura la credencial siguiendo los pasos de la sección Credencial.
  6. Conecta la salida Data a otro componente, por ejemplo, un Data Transformer para filtrar o transformar los datos antes de usarlos en un informe.

El flujo resultante te permitirá leer datos de Google Sheets y pasarlos a cualquier otro componente sin necesidad de escribir código.

Componentes Relacionados

  • Google Sheet Writer – Escribe datos de vuelta a una hoja de cálculo de Google.
  • Google Drive Reader – Lee archivos de Google Drive, útil si necesitas acceder a archivos que no son hojas de cálculo.
  • Data Transformer – Permite filtrar, mapear o transformar los datos que recibes del Google Sheet Reader.

Consejos y Mejores Prácticas

  • Mantén la credencial actualizada: Si cambias el acceso de la hoja de cálculo, actualiza la credencial en Nappai.
  • Usa la salida JSON cuando necesites enviar los datos a un servicio externo que acepte JSON.
  • Limita el rango de celdas: Si solo necesitas una parte de la hoja, especifica el rango en la hoja de cálculo para reducir la cantidad de datos transferidos.
  • Prueba con datos pequeños antes de usar hojas muy grandes para asegurarte de que el flujo funciona correctamente.

Consideraciones de Seguridad

  • Protege tu credencial: No compartas la credencial de Google Sheets API con usuarios que no necesiten acceso a los datos.
  • Revisa los permisos: Asegúrate de que la credencial solo tenga acceso de lectura a los rangos necesarios.
  • Audita los logs: Si tu organización tiene políticas de auditoría, revisa los logs de acceso a Google Sheets para detectar usos inesperados.