Clase 02 · Módulo 06
Google Sheets: leer, agregar y actualizar filas
Google Sheets: leer, agregar y actualizar filas
Qué logras en esta clase
Lees y escribes una planilla de Google desde un flujo sin desordenarla.
- Preparas la planilla para que n8n la entienda.
- Usas las operaciones de leer, agregar y actualizar.
- Actualizas la fila correcta sin crear duplicados.
02
Por qué casi todo parte en una planilla
Una planilla es la base de datos que todo el negocio ya sabe usar. Tu flujo escribe y las personas miran, filtran y corrigen sin aprender nada nuevo.
03
Cómo ve n8n una planilla
- El documento es el archivo completo.
- La hoja es cada pestaña de abajo.
- La primera fila son los encabezados.
- Cada fila siguiente es un ítem.
- Cada encabezado es el nombre de un campo.
Una fila con nombre, correo y monto llega al flujo como un ítem con esos tres campos, igual que los JSON del módulo 3.
04
Preparar la planilla antes de conectar
- Deja los encabezados en la fila 1, uno por columna.
- Usa nombres cortos, en minúsculas y sin repetir:
correo, no «Correo del cliente (principal)». - Una sola tabla por hoja, empezando en la celda A1.
- Sin celdas combinadas ni filas en blanco entre los datos.
- Agrega una columna
idcon un valor único por fila.
05
Lo que rompe un flujo
| En la planilla | Consecuencia |
|---|---|
| Encabezados repetidos | Un campo pisa al otro |
| Filas en blanco en medio | Los datos nuevos pueden quedar fuera de lugar |
| Totales debajo de la tabla | Se leen como una fila más |
| Alguien renombra una columna | El flujo deja de encontrar el campo |
06
Conectar el nodo
- Agrega el nodo Google Sheets.
- Elige la credencial de la clase anterior.
- En Resource, deja Sheet Within Document.
- Elige la Operation.
- En Document, selecciona la planilla: From list, By URL o By ID.
- En Sheet, selecciona la pestaña.
07
Lista, URL o ID
| Modo | Cuándo conviene |
|---|---|
| From list | Para partir: eliges por nombre |
| By URL | Pegas la dirección de la planilla |
| By ID | El documento viene de un nodo anterior, con una expresión |
Elegir por lista guarda el identificador del documento, no su nombre. Puedes renombrar la planilla sin romper el flujo. Si la reemplazas por una copia, tienes que volver a elegirla.
08
Las operaciones de una hoja
| Operación | Qué hace |
|---|---|
| Get Row(s) | Lee filas |
| Append Row | Agrega una fila al final |
| Update Row | Cambia filas que ya existen |
| Append or Update Row | Actualiza si existe; si no, agrega |
| Clear | Vacía celdas, filas o columnas |
| Delete Rows or Columns | Elimina filas o columnas |
También existen Create y Delete, que crean o borran una pestaña completa.
09
Leer: Get Row(s)
Sin filtros, trae todas las filas con datos, un ítem por fila. La fila de encabezados no llega como ítem.
Con Filters traes solo las que coinciden:
- Column: la columna donde buscar.
- Value: el valor que debe tener. Puedes arrastrar un dato de un nodo anterior.
10
Un filtro devuelve una sola fila
Cuando el filtro encuentra varias filas, por defecto el nodo entrega solo la primera.
Para recibirlas todas, abre Options, agrega When Filter Has Multiple Matches y elige Return All Matches.
11
Cómo llegan los valores
En Options > Output Formatting decides qué recibes de cada celda.
| General Formatting | Recibes |
|---|---|
| Values (unformatted) | El valor sin formato: 15000 |
| Values (formatted) | Lo que se ve en pantalla, como texto: $15.000 |
| Formulas | El texto de la fórmula |
El primero es el valor por defecto y el que sirve para calcular. Las fechas tienen su propio ajuste, Date Formatting: texto con formato o número de serie.
12
Agregar: Append Row
Agrega una fila al final de los datos. Lo primero es elegir el Mapping Column Mode:
- Map Each Column Manually: escribes o arrastras el valor de cada columna.
- Map Automatically: cada campo del ítem va a la columna que se llama igual.
- Nothing: no envía datos.
13
Manual o automático
| Manual | Automático | |
|---|---|---|
| Control | Decides columna por columna | Depende de los nombres |
| Esfuerzo | Más clics | Casi ninguno |
| Riesgo | Olvidar una columna nueva | Campos de más o mal nombrados |
Para el automático, deja antes un nodo Edit Fields con exactamente los campos de la planilla (módulo 3, clase 3).
14
Qué pasa con los campos que sobran
En modo automático, la opción Handling extra fields in input decide qué hacer con un campo que no tiene columna:
- Insert in New Column(s): crea la columna. Es el valor por defecto.
- Ignore Them: lo descarta.
- Error: detiene la ejecución.
15
Quién da formato a la celda
La opción Cell Format tiene dos valores:
- Let Google Sheets format: Sheets interpreta lo que llega, como si lo escribieras a mano. Es el valor por defecto.
- Let n8n format: se respeta el tipo de dato que envía n8n.
16
Actualizar: Update Row
Cambia filas que ya existen. Para saber cuál, el nodo compara una columna de la planilla con un valor de tu ítem.
- Elige el modo de mapeo.
- Indica la columna para buscar la coincidencia.
- Entrega el valor de esa columna en el ítem.
- Completa solo las columnas que quieres cambiar.
Si ninguna fila coincide, Update Row no agrega nada.
17
La columna de coincidencia tiene que ser única
Si buscas por nombre y hay dos «Juan Pérez», actualizas la fila equivocada. Busca siempre por un identificador que no se repite.
18
Append or Update Row
Hace las dos cosas: si encuentra la coincidencia, actualiza; si no, agrega al final.
Es la operación que evita duplicados cuando un flujo corre dos veces con los mismos datos.
19
Cuál de las tres usar
| Situación | Operación |
|---|---|
| Cada evento es un registro nuevo: una bitácora | Append Row |
| La fila ya existe y solo cambias algo: un estado | Update Row |
| No sabes si existe: sincronizar clientes | Append or Update Row |
Si dudas, parte por Append or Update Row con una columna id.
20
Encabezados que no están en la fila 1
Si no puedes mover la tabla, la opción Data Location on Sheet indica dónde está:
- Header Row: el número de fila de los encabezados.
- First Data Row: la primera fila con datos.
En Get Row(s) la misma opción define el rango a leer. Sin ella, n8n detecta el rango hasta la última fila con datos.
21
Use Append: rápido pero frágil
La opción Use Append usa otro método de Google para agregar filas. Es más rápida, pero puede dejar datos fuera de lugar si la hoja tiene huecos.
Actívala solo si la tabla está limpia, sin filas en blanco, y de verdad necesitas la velocidad.
22
Los límites de Google
| Tipo | Por proyecto | Por usuario |
|---|---|---|
| Lecturas por minuto | 300 | 60 |
| Escrituras por minuto | 300 | 60 |
No hay tope diario. Al pasarte recibes un error 429. Una petición que tarda más de 180 segundos se corta.
El uso estándar es gratuito. Google anuncia cobros por exceso de cuota «más adelante en 2026», sin fecha: revisa la página de límites de las fuentes.
23
El error que agota la cuota
La alternativa: lee la hoja completa una sola vez y cruza los datos con Merge (módulo 4, clase 2).
24
Leer una vez, cruzar dentro de n8n
Una lectura reemplaza a cientos. Si igual necesitas escribir mucho, usa lotes con pausa (módulo 4, clase 3).
25
Borrar con cuidado
- Clear vacía el contenido. Con Whole Sheet y Keep First Row conservas los encabezados.
- Delete Rows or Columns elimina filas desde un número de fila, y las de abajo suben.
Un flujo no tiene papelera. Para recuperar, queda el historial de versiones de la planilla, en el menú Archivo.
Mejor que borrar: una columna estado con el valor «anulado». Es el tema de la clase siguiente.
26
Lo que te llevas
- Encabezados limpios en la fila 1 y una columna
idúnica. - Get Row(s) con filtro entrega una sola fila salvo que pidas todas.
- Append or Update Row con
idevita duplicados. - Revisa Cell Format cuando un código o una fecha cambian al escribirse.
- 60 lecturas y 60 escrituras por minuto por usuario: lee una vez, no fila por fila.
27
Hazlo ahora
En 15 minutos:
- Crea una planilla
clientescon columnasid,nombre,correoyestado, y tres filas. - Léela con Get Row(s) y mira los ítems.
- Filtra por un
estadoque tengan dos filas y logra recibir ambas. - Con Append or Update Row, cambia el correo del
id2. - Ejecuta de nuevo con un
id4 y comprueba que agrega en vez de actualizar.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026