Módulo 1: Google Sheets

Conectar Google Sheets a n8n

Siguiente →

Descripción de la cápsula

Antes de leer o escribir una sola celda, n8n necesita permiso para entrar a tu Google Sheets. Ese permiso se llama credencial, y para Google se gestiona con OAuth2 — el mismo mecanismo que usas cuando una app te pide "iniciar sesión con Google".

En G1-M05 ya viste el concepto de credenciales y el flujo OAuth2 de Google de forma general. Aquí lo aplicamos específicamente a Google Sheets: qué tipo de credencial elegir, qué permisos pide, cómo conectarla, y cómo agregar el nodo de Google Sheets a un workflow para confirmar que todo funciona.

Esta cápsula es corta a propósito. El objetivo es que termines con una credencial funcionando y un nodo que lee tu primera hoja. Todo lo demás (leer con filtros, escribir, actualizar) se construye encima de esto.

Lo que vas a aprender

Al terminar esta cápsula serás capaz de:

  • ✅ Crear una credencial de Google Sheets en n8n con OAuth2
  • ✅ Entender qué permisos estás otorgando y por qué
  • ✅ Agregar el nodo Google Sheets a un workflow
  • ✅ Seleccionar un documento y una hoja desde el nodo
  • ✅ Ejecutar una lectura de prueba para confirmar la conexión
  • ✅ Distinguir entre la credencial OAuth2 (recomendada) y Service Account

Las dos formas de conectar Google Sheets

n8n ofrece dos tipos de credencial para Google Sheets:

TipoCuándo usarlaDificultad
OAuth2Tu cuenta personal o de trabajo. Caso normal.Baja — pocos clics
Service AccountCuentas de servidor, automatizaciones sin un humano dueño, equipos.Alta — requiere Google Cloud Console

Para este módulo y para el 90% de los casos de un freelancer o PyME, usa OAuth2. Service Account se cubre en G10 (Production) cuando hablamos de automatizaciones "sin dueño humano".

Qué es OAuth2 (recordatorio rápido de G1)

OAuth2 es el flujo donde tú autorizas a n8n a actuar en tu nombre, sin darle tu contraseña. Funciona así:

  1. n8n te manda a una pantalla de Google
  2. Google te pregunta: "¿Le das permiso a n8n para ver y editar tus hojas de cálculo?"
  3. Tú aceptas
  4. Google le da a n8n un token (no tu contraseña)
  5. n8n usa ese token para trabajar

La ventaja: si algún día quieres cortar el acceso, lo revocas desde tu cuenta de Google sin cambiar tu contraseña.

Paso a paso: crear la credencial

Paso A: Abrir el gestor de credenciales

  1. En n8n, ve al menú lateral → Credentials
  2. Click en Add credential (o Create new)
  3. Busca Google Sheets
  4. Selecciona Google Sheets OAuth2 API

Paso B: Conectar con Google

Lo que ves depende de tu instalación de n8n:

  • n8n Cloud: el botón Sign in with Google funciona directo. Click, eliges tu cuenta, aceptas permisos. Listo.
  • n8n self-hosted: puede que necesites configurar primero un proyecto en Google Cloud Console (Client ID y Client Secret). n8n muestra instrucciones en la misma pantalla. Esto es un setup de una sola vez.

Si estás en self-hosted y la configuración de Google Cloud te frena, no te atasques aquí: muchos estudiantes usan n8n Cloud (trial de 14 días) para todo este módulo y migran después. Lo importante es aprender el nodo, no pelear con OAuth.

Paso C: Aceptar los permisos

Google te mostrará qué permisos pide n8n. Para Sheets típicamente:

  • Ver, editar, crear y borrar tus hojas de cálculo de Google
  • A veces también ver tus archivos de Google Drive (para poder listar y elegir documentos)

Acepta. Vuelves a n8n y la credencial aparece como conectada (un check verde o similar).

Paso D: Nombrar la credencial

Ponle un nombre claro: Google Sheets - cuenta personal o Sheets - negocio. Cuando tengas 5 credenciales distintas, agradecerás los nombres descriptivos.

Paso a paso: agregar el nodo y leer tu primera hoja

Ahora confirmamos que la credencial sirve.

Paso 1: Crear hoja de prueba

En sheets.google.com, crea una hoja nueva. Ponle encabezados en la fila 1 y un par de filas de datos:

nameemailcity
Ana Lópezana@example.comCDMX
Beto Ruizbeto@example.comBogotá

Nómbrala Clientes prueba.

Paso 2: Agregar el nodo en n8n

  1. En un workflow nuevo, agrega un Manual Trigger (para poder ejecutar a mano)
  2. Agrega un nodo Google Sheets
  3. En Credential, elige la que acabas de crear

Paso 3: Configurar la operación

  • Resource: Sheet Within Document
  • Operation: Get Row(s)
  • Document: abre el selector y elige Clientes prueba (n8n lista tus documentos)
  • Sheet: elige la pestaña (normalmente Hoja 1 / Sheet1)

Paso 4: Ejecutar

Click en Test step (o ejecuta el workflow completo). Si todo está bien, n8n te devuelve 2 items, uno por cada fila de datos:

[
  { "name": "Ana López", "email": "ana@example.com", "city": "CDMX" },
  { "name": "Beto Ruiz", "email": "beto@example.com", "city": "Bogotá" }
]

Si ves esto: la conexión funciona. Cada fila se convierte en un item, y cada encabezado de columna se vuelve un campo.

Cómo n8n "ve" tu hoja

Detalle clave que vas a usar todo el módulo:

n8n usa la fila 1 como encabezados. Cada columna de la fila 1 se convierte en el nombre de un campo. Las filas siguientes son los datos.

Por eso tus encabezados importan: si la columna se llama Customer Email, ese será el nombre del campo (con espacios y todo). Encabezados cortos y sin espacios (email, name, city) hacen tu vida más fácil al mapear datos en las cápsulas siguientes.

Trampas comunes

Trampa 1: La credencial conecta pero el nodo no ve tus documentos

Qué pasa: El selector de Document aparece vacío o no encuentra tu hoja.

Causas y solución:

  • El permiso de Drive no se otorgó → recrea la credencial y acepta todos los permisos
  • La hoja la creó otra cuenta → asegúrate de estar usando la cuenta de Google dueña del documento
  • Workaround: en lugar del selector, pega el ID del documento manualmente (cambia el modo del campo a "By ID"). El ID está en la URL de la hoja: docs.google.com/spreadsheets/d/ESTE-ES-EL-ID/edit

Trampa 2: "Insufficient permissions" al leer

Qué pasa: La credencial existe pero el nodo da error de permisos.

Cómo evitar: Pasa cuando la hoja no es tuya sino compartida contigo solo como "lector". n8n necesita al menos permiso de edición sobre el documento si vas a escribir, y de lectura si solo vas a leer. Pide al dueño que te comparta con el nivel correcto.

Trampa 3: Confundir el nombre del documento con el nombre de la hoja

Qué pasa: Eliges bien el documento pero el nodo no encuentra datos.

Cómo evitar: Un documento de Google Sheets puede tener varias pestañas (hojas). El campo Document es el archivo completo; el campo Sheet es la pestaña específica. Verifica que elegiste la pestaña correcta.

Trampa 4: Datos que no empiezan en la fila 1

Qué pasa: Tu hoja tiene un título decorativo en la fila 1 y los encabezados reales en la fila 3. n8n lee la fila 1 como encabezados y todo sale mal.

Cómo evitar: Para este módulo, mantén tus hojas limpias: encabezados en fila 1, datos desde la fila 2. Si heredas una hoja con formato raro, el nodo tiene opciones avanzadas (Header Row / Data Start Row) — pero lo más simple es arreglar la hoja.

Ejercicio: conecta y lee

Objetivo: terminar con una credencial y una lectura funcionando — es el cimiento del módulo.

Tu tarea

  1. Crea la credencial Google Sheets OAuth2 en n8n
  2. Crea una hoja Clientes prueba con las columnas name, email, city y 3 filas de datos
  3. Construye un workflow: Manual Trigger → Google Sheets (Get Row(s))
  4. Ejecútalo y confirma que recibes 3 items

Checklist de éxito:

  • La credencial muestra estado conectado
  • El nodo lista tu documento en el selector
  • La ejecución devuelve 1 item por cada fila de datos
  • Los nombres de campo coinciden con tus encabezados

Resumen y siguiente paso

  • Google Sheets necesita una credencial para que n8n entre — usa OAuth2 (no Service Account) para el caso normal
  • OAuth2 te da un token, no entrega tu contraseña; lo puedes revocar desde tu cuenta de Google
  • El nodo necesita elegir Document (archivo) y Sheet (pestaña)
  • n8n usa la fila 1 como encabezados — cada columna se vuelve un campo
  • Una lectura de prueba con Get Row(s) confirma que todo funciona
  • 4 trampas: documentos no visibles, permisos insuficientes, confundir documento con hoja, datos fuera de la fila 1

Antes de avanzar deberías poder:

  • Crear una credencial de Google Sheets sin ayuda
  • Agregar el nodo y seleccionar documento + hoja
  • Explicar por qué la fila 1 importa

Lo que sigue (cápsula 03):

Ya conectado, empezamos por la operación más segura: leer. Vas a aprender a traer filas con criterios — no "todas las filas" sino "las filas donde la ciudad es CDMX", o "la fila cuyo email es X". Eso es lookup, y es la base de no duplicar datos cuando escribas.

Recursos adicionales

  1. n8n Google Sheets Credentials Docs - Setup de credenciales de Google paso a paso.
  2. Google Account permissions - Aquí ves y revocas qué apps tienen acceso a tu cuenta.
  3. n8n Cloud trial - Si self-hosting te frena con OAuth, el trial de 14 días sirve para todo el módulo.

Creado: Mayo 14, 2026 Versión: 1.0

← AnteriorIntroducción al Módulo: Google SheetsSiguiente →Leer y Buscar Filas