Clase 01 · Módulo 06
Credenciales de Google paso a paso
Credenciales de Google paso a paso
Qué logras en esta clase
Conectas tu cuenta de Google a tu n8n con una credencial propia que no se cae a la semana.
- Creas el proyecto y el cliente OAuth en Google Cloud.
- Completas la credencial en n8n y la pruebas.
- Sabes por qué una conexión caduca a los 7 días y cómo evitarlo.
02
Una llave para todo el módulo
Sheets, Gmail, Drive y Calendar usan el mismo mecanismo. Lo que armas hoy sirve para las cinco clases que vienen.
03
Qué estás construyendo
OAuth es un sistema de permisos: en vez de entregar tu contraseña, autorizas a una aplicación a hacer ciertas cosas en tu cuenta. La idea general se ve en el módulo 5, clase 3.
Aquí la «aplicación» es tuya: la creas en Google Cloud, la consola de Google para desarrolladores.
04
Dos caminos según dónde corre tu n8n
| Tu n8n | Qué haces |
|---|---|
| n8n Cloud | Botón Sign in with Google en la credencial, sin pasar por Google Cloud |
| Instalado por ti | Creas tu propio proyecto y cliente (Custom OAuth2) |
En Cloud también puedes usar tu propia aplicación cambiando el tipo de autenticación a Custom OAuth2. El resto de la clase es el camino propio.
05
Lo que necesitas antes de partir
- Tu n8n abierto y con sesión iniciada.
- Una cuenta de Google: la misma que tiene las planillas, correos y archivos.
- Unos 20 minutos sin apuro.
06
Paso 1: crear el proyecto
- Entra a
console.cloud.google.comcon tu cuenta. - Abre el selector de proyectos de la barra superior y elige New project.
- Escribe un Project name que reconozcas, por ejemplo
n8n-cafeteria. - Pulsa Create.
- Comprueba que el selector muestre el proyecto nuevo.
07
Paso 2: habilitar las APIs
Cada servicio de Google tiene su API, y viene apagada.
- Ve a APIs & Services > Library.
- Busca la API que necesitas, por ejemplo Gmail API.
- Ábrela y pulsa Enable.
- Repite con cada servicio que vayas a usar.
08
Qué APIs encender para este módulo
| Vas a usar | Habilita |
|---|---|
| Sheets | Google Sheets API y Google Drive API |
| Gmail | Gmail API |
| Drive | Google Drive API |
| Calendar | Google Calendar API |
| Docs | Google Docs API y Google Drive API |
Sheets, Docs y Slides necesitan además la API de Drive, porque n8n busca los documentos a través de Drive.
09
Paso 3: la pantalla de consentimiento
Es la ventana que Google muestra cuando alguien autoriza tu aplicación.
- Ve a APIs & Services > OAuth consent screen y pulsa Get started.
- Completa App name y User support email.
- En Audience, elige Internal o External.
- Escribe el correo de contacto.
- Acepta la política de datos de usuario y pulsa Create.
10
Internal o External: la decisión que importa
| Internal | External | |
|---|---|---|
| Quién puede autorizar | Cuentas de tu organización de Google Workspace | Cualquier cuenta de Google |
| Estado inicial | Sin modo de prueba | Testing |
| Usuarios de prueba | No hacen falta | Obligatorios mientras esté en Testing |
Con una cuenta @gmail.com común solo puedes usar External. Internal existe para quienes tienen Google Workspace, el servicio pagado de Google para empresas.
11
Paso 4: agregarte como usuario de prueba
Con External en Testing, solo las cuentas que agregues pueden autorizar. Las demás ven una pantalla de acceso denegado.
- Abre la página Audience.
- En Test users, agrega el correo con que vas a iniciar sesión.
- Guarda.
12
Paso 5: crear el cliente OAuth
- Ve a APIs & Services > Credentials.
- Pulsa Create credentials y elige OAuth client ID.
- En Application type, elige Web application.
- Cambia el Name por uno reconocible.
- Deja esta pestaña abierta: falta la dirección de redirección, que sale de n8n.
13
La dirección de redirección sale de n8n
Después de autorizar, Google devuelve al usuario a una dirección fija. Tiene que ser la de tu n8n.
- En n8n, crea una credencial nueva del servicio, por ejemplo Google Sheets.
- Copia el campo OAuth Redirect URL.
- En Google, pégalo en Authorized redirect URIs.
- Pulsa Create.
Google acepta direcciones localhost: para un n8n local no necesitas dominio público.
14
Paso 6: terminar la credencial en n8n
- Del aviso OAuth client created, copia el Client ID a n8n.
- Copia también el Client Secret.
- Pulsa Sign in with Google.
- Elige tu cuenta y acepta los permisos.
- Guarda la credencial.
15
Autoriza desde el mismo navegador
Desde n8n 2.0, el retorno de OAuth exige que tengas la sesión de n8n iniciada.
16
«Google no ha verificado esta app»
Con tu propia aplicación en Testing es normal ver esa advertencia. La aplicación es tuya, así que puedes continuar.
Si en cambio el acceso queda bloqueado:
- En External, tu correo no está en Test users.
- En Internal, estás autorizando con una cuenta distinta a la que creó el cliente.
17
Una credencial por servicio
En n8n cada nodo de Google pide su propio tipo de credencial: una para Sheets, otra para Gmail, otra para Drive, otra para Calendar.
No necesitas repetir el trabajo en Google: el mismo Client ID y Client Secret sirven para todas. Solo cambias de credencial en n8n y autorizas de nuevo. Como la dirección de redirección es la misma, no tocas el cliente.
18
La conexión que muere cada 7 días
Si la aplicación es External y está en Testing, Google vence la autorización a los siete días. No es una falla de n8n: es una regla de Google.
19
Cómo se ve el problema
- El flujo funcionó toda la semana y un día falla en el nodo de Google.
- El error habla de autorización o de un token inválido.
- Al reconectar la credencial, todo vuelve a andar por otros siete días.
20
Tres salidas al vencimiento
| Opción | Cuándo conviene |
|---|---|
| Audience Internal | Tienes Google Workspace y los datos son de esa organización |
| Pasar la aplicación a producción | Cuenta personal y flujos que deben correr sin ti |
| Reconectar cada semana | Solo mientras estás aprendiendo |
El estado de publicación se cambia en la página Audience de la consola.
21
Pasar a producción: lo bueno y lo malo
Lo bueno: la autorización deja de vencer a la semana.
Lo malo: Google puede exigir que verifiques la aplicación según los permisos que pida, y Gmail y Drive piden permisos delicados. Los requisitos cambian.
22
Otras razones por las que deja de funcionar
Aunque resuelvas los 7 días, una autorización se invalida si:
- Revocaste el acceso desde tu cuenta de Google.
- Pasaron seis meses sin usarla.
- Cambiaste la contraseña y la credencial incluye permisos de Gmail.
- Un administrador de Workspace restringió el servicio.
En todos los casos la solución es la misma: reconectar la credencial en n8n.
23
El tope de 100 autorizaciones
Google guarda como máximo 100 autorizaciones vigentes por cuenta y por cliente OAuth. Al crear una más, invalida la más antigua sin avisar.
En uso normal no llegas. Sí puedes llegar si reconectas una y otra vez mientras pruebas, o si reutilizas el mismo cliente en muchas instalaciones.
24
Errores con nombre propio
| Mensaje | Causa | Arreglo |
|---|---|---|
redirect_uri_mismatch | La dirección no coincide | Copiarla de nuevo desde n8n, con http o https y el puerto |
invalid_client | ID o secreto mal copiados | Copiarlos otra vez, sin espacios |
| Acceso denegado | No eres usuario de prueba | Agregarte en Test users |
25
Si cambia la dirección de tu n8n
La dirección de redirección incluye la dirección de tu n8n. Si pasas de localhost a un dominio, o cambias de puerto, deja de coincidir.
- Copia la nueva OAuth Redirect URL desde n8n.
- Agrégala en Authorized redirect URIs del cliente.
- Si usas dominio propio, agrégalo también en Branding > Authorized domains.
- Reconecta la credencial.
26
Permisos mínimos también aquí
- Usa una cuenta de Google dedicada al negocio, no tu cuenta personal con todo adentro.
- Habilita solo las APIs que usas.
- Un cliente OAuth por instalación de n8n.
- Revisa cada cierto tiempo en tu cuenta de Google qué aplicaciones tienen acceso.
Una credencial de Gmail puede leer y enviar correo a tu nombre. Trátala como tal.
27
Lo que te llevas
- En n8n instalado por ti, Google exige proyecto, APIs, pantalla de consentimiento y cliente OAuth.
- La dirección de redirección se copia desde n8n, exacta.
- External en Testing vence a los 7 días: Internal o producción lo resuelven.
- Un mismo cliente sirve para las credenciales de Sheets, Gmail, Drive y Calendar.
- Si algo falla, primero lee el nombre del error.
28
Hazlo ahora
En 15 minutos:
- Crea el proyecto y habilita Google Sheets API y Google Drive API.
- Configura la pantalla de consentimiento y agrégate como usuario de prueba.
- Crea el cliente OAuth con la dirección de redirección de tu n8n.
- Completa la credencial de Google Sheets y autoriza.
- Anota en tu calendario la fecha de hoy más siete días: ese día decides entre Internal, producción o reconectar.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026