Sheet Cells

Sheet Cells trabaja con las filas de una pestaña de Google Sheets, como si fuera una tabla: leer todas las filas, añadir una fila nueva al final, cambiar una fila concreta o eliminarla. Toma como nombres de columna lo que hay en la primera fila de la pestaña.

Es la forma más sencilla de usar una hoja de cálculo como registro: pedidos, contactos, incidencias o cualquier lista que el flujo tenga que consultar o completar. Para crear, duplicar o eliminar hojas de cálculo enteras, usa Spread Sheet.

Cuándo usarlo

Cada solicitud que llega por un formulario debe quedar apuntada como una fila nueva.
Un agente de IA tiene que consultar una lista de precios o de productos guardada en Google Sheets.
Cuando se entrega un pedido, quieres cambiar su fila para marcarlo como entregado.
Quieres eliminar de la lista los contactos que se han dado de baja.

Configuración

Necesitas una credencial Google Sheets, que se conecta iniciando sesión con tu cuenta de Google. Para añadir, cambiar o eliminar filas, la credencial debe tener el acceso Create, Update, Delete, Read; con Read Only solo puedes leer. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Google Sheets de la cuenta con la que trabajas.
Operation	Lo que hace el componente. Ver Operaciones. Por defecto, `Add Row`.
Mode of Input	Cómo indicas la hoja de cálculo: `By Selection` muestra un selector para elegirla de tu Drive; `By Id` te pide su identificador; `By Url` te pide su enlace. Por defecto, `By Selection`.
Select Spreadsheet / Spreadsheet ID / Spreadsheet URL	La hoja de cálculo con la que trabajas, según Mode of Input. Obligatorio.
Select Sheet	La pestaña con la que trabajas. La lista se carga al elegir la hoja de cálculo.
Row Number	Solo en `Update Row` y `Delete Row`. El número de la fila en la hoja de cálculo, el que ves a la izquierda en Google Sheets. Obligatorio. En `Delete Row` no puede ser 1, porque es la fila de los nombres de columna.
Type	Solo en `Add Row` y `Update Row`. Cómo se indican los valores de la fila. `Automatic` muestra un campo por cada columna, con el nombre que tiene en la primera fila; `From Data` toma los valores del campo Values; `User Defined` te deja escribir los valores columna a columna. Por defecto, `Automatic`.
(un campo por columna)	Con Type en `Automatic`. El valor que se escribe en cada columna. Cada campo lleva el nombre de su columna.
Values	Con Type en `From Data`. Conecta aquí los datos de la fila. Si conectas una lista, en `Add Row` se añade una fila por elemento.
Number of Columns	Con Type en `User Defined`. Cuántas columnas vas a rellenar. Aparecen los campos Column 1, Column 2… para escribir cada valor.

Operaciones

Operación	Qué hace
`Add Row`	Añade una fila nueva después de la última fila con datos.
`Update Row`	Sustituye los valores de una fila concreta.
`Delete Row`	Elimina una fila concreta.
`Get Rows`	Devuelve todas las filas de la pestaña.

Opciones avanzadas

Campo	Qué hace
Declare Headers	Solo en `Get Rows`. Usa la primera fila como nombres de columna. Si lo desactivas, las columnas se llaman `Column 1`, `Column 2`… y la primera fila se devuelve como una fila más. Por defecto, activado.

Resultado

El componente tiene dos salidas:

Data: en Get Rows, un elemento por cada fila, con un dato por columna y el número de fila en la hoja de cálculo (row_number). En Add Row, Update Row y Delete Row, la zona de la hoja de cálculo que se ha escrito o eliminado.
Json: solo en Get Rows. Las mismas filas como un único texto, útil para pasarlas a un agente o a un componente que espere texto. Aquí las columnas se llaman siempre Column 1, Column 2…

Puedes conectar las filas a un agente de IA para que las consulte, o usar row_number en otro Sheet Cells para cambiar o eliminar esa fila. El componente también se puede conectar a un Agente como herramienta, para que el agente lea o añada filas cuando lo necesite. Ver Tool Mode.

Ejemplo

Una inmobiliaria apunta en una hoja de cálculo cada visita que se solicita en su web.

La hoja de cálculo Visitas tiene en la primera fila las columnas Nombre, Teléfono, Inmueble y Fecha.
Añade Sheet Cells con la operación Add Row, elige la hoja de cálculo en Select Spreadsheet y la pestaña en Select Sheet.
Con Type en Automatic aparecen los campos Nombre, Teléfono, Inmueble y Fecha: rellénalos con los datos que llegan del formulario.
Ejecuta el flujo con una solicitud de prueba y comprueba que aparece la fila nueva.

Buenas prácticas

La primera fila de la pestaña debe tener los nombres de las columnas. Sin ella, Automatic no muestra campos y Update Row y Delete Row no encuentran la tabla.
Con Type en From Data, los valores se escriben en el orden en que llegan, de izquierda a derecha, no según el nombre de cada dato. Asegúrate de que llegan en el mismo orden que las columnas.
Si añades o cambias columnas en la hoja de cálculo, vuelve a elegir la pestaña en Select Sheet para que se actualicen los campos.

Componentes relacionados

Spread Sheet: crear, duplicar y gestionar hojas de cálculo.
Forms: leer las respuestas de un formulario para pasarlas a la hoja de cálculo.