Google Sheets es una herramienta accesible para equipos que necesitan datos estructurados sin montar una base de datos. A diferencia de Supabase (que conecta con PostgreSQL y lógica de negocio) o de un CRM (que impone un modelo predefinido), Sheets es flexible, compartible y familiar para cualquier persona del equipo. En Brain Studio, la integración permite que tus flujos lean, escriban y transformen datos en hojas en tiempo real: registrar leads, actualizar estados, consolidar reportes y orquestar procesos donde la hoja funciona como panel de control operativo.Documentation Index
Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
Use this file to discover all available pages before exploring further.
Qué habilita Google Sheets
Al conectar Google Sheets, puedes:- Registrar eventos del negocio en hojas compartidas — leads, citas, pagos o documentos que quedan estructurados desde la conversación
- Consultar datos existentes antes de responder — buscar una fila por ID, leer un rango o verificar un estado para que el agente no invente
- Actualizar estados y columnas en tiempo real — marcar como procesado, agregar timestamp o cambiar un valor según lo que ocurre en el flujo
- Gobernar la estructura del documento — formato condicional, validación de datos y protección de rangos para mantener la calidad de la hoja
- Orquestar procesos entre integraciones — usar la hoja como cola de tareas donde cada fila es un caso pendiente que el flujo procesa y marca como hecho
Instalación
Requisitos previos
- Una cuenta de Google con acceso a Google Sheets y Google Drive.
Cómo conectarla
La forma más directa es usar Jelou Agent: describe lo que necesitas y el agente conecta Google Sheets automáticamente dentro del flujo. Si prefieres instalar manualmente, sigue estos pasos en el Marketplace. La conexión usa OAuth de Google; no necesitas copiar credenciales.Autorizar acceso con Google
Tools disponibles
A alto nivel, las acciones se agrupan así:- Consultar — obtener celdas, rangos, filas, pestañas y metadatos del libro.
- Crear y estructurar — crear libros/pestañas, insertar filas/columnas y mover dimensiones.
- Actualizar datos — agregar, editar, limpiar o hacer upsert de filas y celdas.
- Gobierno y calidad — validación, formato condicional, protección, comentarios y notas.
Crear columna
Crear columna
InsertDimension o peticiones equivalentes en batchUpdate).Inputs:- spreadsheetId (string) — ID del libro.
- sheetId / sheetName (string) — Pestaña.
- startIndex (number) — Índice donde insertar la columna.
- endIndex (opcional, number) — Si se insertan varias columnas.
spreadsheets.values.batchUpdate · Solicitudes de hojaAgregar regla de formato condicional
Agregar regla de formato condicional
BOOLEAN, fórmula personalizada, etc.).Inputs:- spreadsheetId (string) — ID del libro.
- sheetId (number) — ID de la pestaña.
- rule (objeto) — Definición de la regla (
ranges,booleanRule,gradientRule, etc.).
AddConditionalFormatRuleRequestAgregar varias filas
Agregar varias filas
values.append.Inputs:- spreadsheetId (string) — ID del libro.
- range (string) — Rango base (p. ej.
Hoja1!A:C). - values (array 2D) — Filas a añadir.
- valueInputOption (opcional, enum:
RAW|USER_ENTERED) — Por defectoUSER_ENTERED.
spreadsheets.values.appendAgregar rango protegido
Agregar rango protegido
AddProtectedRange).Inputs:- spreadsheetId (string) — ID del libro.
- range (objeto) — Rango a proteger.
- editors (opcional, objeto) — Usuarios o dominios con permiso de edición.
AddProtectedRangeRequestAgregar una fila única
Agregar una fila única
- spreadsheetId (string) — ID del libro.
- range (string) — Rango destino o tabla.
- values (array) — Una fila de valores.
- insertDataOption (opcional, enum) —
INSERT_ROWSu opciones deappend.
spreadsheets.values.appendCelda clara
Celda clara
values.clear sobre el rango A1 de una celda).Inputs:- spreadsheetId (string) — ID del libro.
- range (string) — Celda en notación A1 (p. ej.
Hoja1!B5).
spreadsheets.values.clearLimpiar filas
Limpiar filas
- spreadsheetId (string) — ID del libro.
- range (string) — Rango de filas (p. ej.
Hoja1!A5:Z20).
spreadsheets.values.clearCopiar hoja de cálculo
Copiar hoja de cálculo
sheets.copyTo).Inputs:- spreadsheetId (string) — ID del libro origen.
- sheetId (number) — ID de la pestaña a copiar.
- destinationSpreadsheetId (string) — ID del libro destino.
spreadsheets.sheets.copyToCrear hoja de cálculo
Crear hoja de cálculo
spreadsheets.create).Inputs:- title (string) — Título del libro.
- sheets (opcional, array) — Pestañas iniciales con
title. - sourceSpreadsheetId (opcional, string) — Si la tool admite duplicar desde otro ID.
spreadsheets.createCrear Hoja de Cálculo
Crear Hoja de Cálculo
AddSheetRequest dentro de batchUpdate).Inputs:- spreadsheetId (string) — ID del libro.
- title (string) — Nombre de la nueva pestaña.
AddSheetRequest · batchUpdateEliminar regla de formato condicional
Eliminar regla de formato condicional
- spreadsheetId (string) — ID del libro.
- sheetId (number) — ID de pestaña.
- index (number) — Índice de la regla a eliminar.
DeleteConditionalFormatRuleRequestEliminar Filas
Eliminar Filas
DeleteDimension en filas).Inputs:- spreadsheetId (string) — ID del libro.
- sheetId (number) — Pestaña.
- startIndex (number) — Primera fila a eliminar (0-based).
- endIndex (number) — Fila final (exclusiva).
DeleteDimensionRequestEliminar hoja
Eliminar hoja
DeleteSheetRequest vía batchUpdate).Inputs:- spreadsheetId (string) — ID del libro.
- sheetId (number) — ID de la pestaña a eliminar.
DeleteSheetRequestBuscar Fila
Buscar Fila
values.get / filtrado en el flujo).Inputs:- spreadsheetId (string) — ID del libro.
- range (string) — Rango a escanear.
- column (string o number) — Columna clave.
- value (string) — Valor buscado.
spreadsheets.values.getObtener Celda
Obtener Celda
values.get en rango A1 de una celda).Inputs:- spreadsheetId (string) — ID del libro.
- range (string) — Celda (p. ej.
Hoja1!B2).
spreadsheets.values.getObtener usuario actual
Obtener usuario actual
about.get de Drive: nombre, correo, cuota, etc.Inputs:- fields (opcional, string) — Campos (
user,storageQuota, …).
about.get (Drive)Obtener hoja de cálculo por ID
Obtener hoja de cálculo por ID
spreadsheets.get).Inputs:- spreadsheetId (string) — ID del libro.
- ranges (opcional, array de string) — Rangos para devolver también datos parciales si la tool lo permite.
- includeGridData (opcional, boolean) — Incluir datos de cuadrícula.
spreadsheets.getObtener valores en rango
Obtener valores en rango
values.get).Inputs:- spreadsheetId (string) — ID del libro.
- range (string) — Rango (p. ej.
Ventas!A1:F100). - majorDimension (opcional, enum:
ROWS|COLUMNS) — Orientación.
spreadsheets.values.getInsertar una nota anclada
Insertar una nota anclada
SetCellNote / peticiones en batchUpdate).Inputs:- spreadsheetId (string) — ID del libro.
- sheetId (number) — Pestaña.
- row (number) — Fila (0-based).
- column (number) — Columna (0-based).
- note (string) — Texto de la nota.
spreadsheets.batchUpdateInsertar comentario
Insertar comentario
- fileId (string) — ID del libro (mismo que spreadsheetId).
- content (string) — Texto del comentario.
- anchor (opcional, objeto) — Anclaje si la tool lo expone.
comments.create (Drive)Insertar Dimensión
Insertar Dimensión
InsertDimension).Inputs:- spreadsheetId (string) — ID del libro.
- sheetId (number) — Pestaña.
- dimension (enum:
ROWS|COLUMNS) — Tipo. - startIndex / endIndex (number) — Posición e intervalo.
InsertDimensionRequestListar hojas de cálculo
Listar hojas de cálculo
spreadsheets.get → sheets[]).Inputs:- spreadsheetId (string) — ID del libro.
spreadsheets.getCombinar celdas
Combinar celdas
MergeCells).Inputs:- spreadsheetId (string) — ID del libro.
- range (objeto) —
sheetId,startRowIndex,endRowIndex,startColumnIndex,endColumnIndex. - mergeType (opcional, enum) — Tipo de fusión.
MergeCellsRequestMover Dimensión
Mover Dimensión
MoveDimension).Inputs:- spreadsheetId (string) — ID del libro.
- sheetId (number) — Pestaña.
- dimension (enum:
ROWS|COLUMNS) — Tipo. - sourceIndex / destinationIndex (number) — Origen y destino según la API.
MoveDimensionRequestConfigurar validación de datos
Configurar validación de datos
SetDataValidation.Inputs:- spreadsheetId (string) — ID del libro.
- range (objeto) — Rango objetivo.
- rule (objeto) — Regla (
condition,showCustomUi, etc.).
SetDataValidationRequestActualizar Celda
Actualizar Celda
values.update en rango de una celda).Inputs:- spreadsheetId (string) — ID del libro.
- range (string) — Celda A1.
- values (array 2D de 1×1) — Valor.
- valueInputOption (opcional, enum) —
USER_ENTEREDpor defecto.
spreadsheets.values.updateActualizar regla de formato condicional
Actualizar regla de formato condicional
UpdateConditionalFormatRule).Inputs:- spreadsheetId (string) — ID del libro.
- sheetId (number) — Pestaña.
- index (number) — Índice de la regla.
- rule (objeto) — Nueva definición.
UpdateConditionalFormatRuleRequestActualizar Formato
Actualizar Formato
RepeatCell / UpdateCells en batchUpdate.Inputs:- spreadsheetId (string) — ID del libro.
- range (objeto) — Rango.
- format (objeto) —
userEnteredFormat(texto, fondo, bordes).
Actualizar varias filas
Actualizar varias filas
values.update en un rango rectangular.Inputs:- spreadsheetId (string) — ID del libro.
- range (string) — Rango (p. ej.
Hoja1!A2:D10). - values (array 2D) — Matriz de valores.
- valueInputOption (opcional, enum) —
USER_ENTERED.
spreadsheets.values.updateActualizar fila
Actualizar fila
- spreadsheetId (string) — ID del libro.
- range (string) — P. ej.
Hoja1!A5:Z5. - values (array 2D de una fila) — Valores.
spreadsheets.values.updateInsertar o actualizar fila
Insertar o actualizar fila
append + lógica de negocio o update).Inputs:- spreadsheetId (string) — ID del libro.
- range (string) — Tabla o rango.
- values (array) — Fila de datos.
- keyColumn (opcional, string) — Columna de clave para decidir upsert.
spreadsheets.values.appendCómo usar en Brain
Una vez conectada, puedes usar Google Sheets en dos superficies:En AI Agent
Ideal cuando el usuario quiere consultar, insertar o actualizar filas en lenguaje natural.Configura las tools
En Canvas
Ideal cuando necesitas control total del flujo (por ejemplo: buscar fila → validar → insertar o actualizar → siguiente paso).Arrastra Google Sheets al Canvas
Selecciona la tool
Configura el cuerpo y la memoria
spreadsheetId, range, keyColumn y values según tu libro y columnas.
Casos de uso
Registro de leads en tiempo real desde WhatsApp
Registro de leads en tiempo real desde WhatsApp
Tablero operativo con estados sincronizados
Tablero operativo con estados sincronizados
Hoja como cola de tareas entre integraciones
Hoja como cola de tareas entre integraciones
Integraciones que combinan bien con Google Sheets
Google Drive
Google Drive
fileId, el enlace y el estado del documento como columna en la hoja operativa. Todo queda trazado en un solo lugar.Flujo combinado: archivo subido a Drive → nueva columna en Sheets con enlace y fecha.Documentación de Google DriveGmail
Gmail
Google Calendar
Google Calendar
CRM (HubSpot / Pipedrive)
CRM (HubSpot / Pipedrive)