DocumentaciónWorkflowsApps y servicios
Google Sheets nodo
Leer tablas de Google Sheets, añadir nuevas filas o actualizar rangos de celdas concretos. Perfecto para reports, logs o como fuente de datos para pasos de IA posteriores. Consulta la configuración, las entradas y salidas, las pruebas y la solución de errores.
9 min de lecturaActualizado el
Qué hace este nodo
Leer tablas de Google Sheets, añadir nuevas filas o actualizar rangos de celdas concretos. Perfecto para reports, logs o como fuente de datos para pasos de IA posteriores.
Usa Google Sheets como un paso claramente definido en un workflow de anymize.
- Procesa 1 entrada.
- Ofrece 1 salida para los pasos siguientes.
- Se ejecuta como un paso normal del flujo.
Configurar el nodo
- 01Abre un workflow y añade Google Sheets desde el catálogo de nodos.
- 02Selecciona tu conexión de google_byo. Puedes crearla directamente en el workflow.
- 03Completa los campos obligatorios y asigna valores de los pasos anteriores.
- 04Ejecuta el nodo con un conjunto pequeño de datos y revisa la salida.
- 05Conecta la salida correcta y activa el workflow después de una prueba completa.
Acciones y modos
Elige la función necesaria en Acción. El panel mostrará los ajustes correspondientes.
- Añadir fila
- Leer rango
- Actualizar rango
- Añadir filas por columnas
Ajustes
| Campo | Significado | Área |
|---|---|---|
| Acción | Opciones: Añadir fila, Leer rango, Actualizar rango, Añadir filas por columnas | Estándar |
| Tabla (ID de la URL) | Abre tu tabla en Google Sheets y copia el código de la dirección: docs.google.com/spreadsheets/d/AQUÍ/edit | Estándar |
| Rango | ¿Qué rango de celdas? Formato como en Sheets: Tabla1!A:Z (columnas enteras) o Tabla1!A2:D10. Déjalo vacío para la primera columna. | Estándar |
| Valores | Una celda por línea o valor. No necesitas escribir JSON. | Estándar |
| Formato de importación | Configura este valor en el panel del nodo. | Estándar |
| Cuenta de Google | Elige el perfil de Google OAuth conectado para esta hoja de cálculo. | Protegido |
| Pestaña | Conserva la pestaña de la plantilla o introduce su ID. En las opciones puedes seleccionarla por nombre. | Estándar |
| Asignar columnas | Asigna cada campo a una columna o usa los nombres automáticamente. Todos los registros entrantes se escriben juntos. | Estándar |
| Seleccionar documento por | Opciones: ID, Selección guardada, Enlace | Estándar |
| Seleccionar pestaña por | Opciones: ID, Selección guardada, Nombre, Enlace | Estándar |
| Fila de encabezados | Configura este valor en el panel del nodo. | Estándar |
| Escribir valores | Sheets puede interpretar números, fechas y fórmulas. El modo exacto conserva los valores recibidos. | Estándar |
| Escribir nuevos encabezados | Opciones: Conservar valores exactos, Como entrada en Sheets | Estándar |
| Añadir directamente | Reduce las peticiones en hojas sin huecos entre filas o columnas. En caso contrario, desactívalo para escribir debajo de la última fila con datos. | Estándar |
| Campos adicionales | Se aplica a la asignación automática cuando un campo no tiene una columna correspondiente. | Estándar |
| Ejecutar una vez por elemento | Desactivado (por defecto): el nodo se ejecuta una vez para toda la entrada. Activado: si recibe varios elementos (por ejemplo de «Dividir lista»), se ejecuta una vez POR elemento, y {{ $json }} es justo ese elemento. Así procesas una lista de archivos entrada por entrada. | Estándar |
| Si un elemento falla | «Omitir» escribe un campo `error` para el elemento fallido y sigue con el resto, en lugar de perder toda la ejecución por un único archivo ilegible. | Estándar |
| Pausa entre elementos (milisegundos) | Espera antes de cada ejecución excepto la primera. 1000 = 1 segundo por elemento. Útil si el otro extremo te limita. Máximo 300000 (5 minutos). | Estándar |
Entradas y salidas
| Entrada | Significado | Tipo |
|---|---|---|
| Estándar | Recibe el resultado completo del paso anterior. | JSON |
| Salida | Significado | Tipo |
|---|---|---|
| Estándar | Entrega el resultado al paso siguiente como JSON. | JSON |
Este nodo puede procesar listas elemento por elemento. La gestión de errores y la pausa están en los ajustes avanzados.
Ejemplo y prueba
Escribir lead en la hoja: empieza con un conjunto pequeño y reconocible. Revisa la salida y usa solo los campos que estén presentes.
Ejemplo de prueba
{
"range": "Leads!A:D",
"values": [
"Alice",
"alice@example.com",
"2026-04-19",
"neu"
]
}Acceso y seguridad
Este nodo usa una conexión de google_byo. Revisa los permisos y concede solo el acceso necesario.
Guarda claves y credenciales en el gestor protegido. No las pegues en campos normales, datos de prueba ni descripciones.
Resolver errores
- Sin salida: revisa la última ejecución y los campos entregados por el nodo anterior.
- Variable vacía: abre la salida anterior y usa un campo presente en los datos reales.
- Conexión rechazada: vuelve a conectar el servicio con los permisos necesarios.
- La lista se procesa una sola vez: activa la ejecución por elemento.