Conectar Google Sheets API a n8n en VPS (Guía Completa 2026)

Requisitos

• Un VPS con n8n funcionando (Docker, Easypanel, etc.).
• Un dominio o subdominio accesible por HTTPS (recomendado).
• Acceso a Google Cloud Console con una cuenta Google.
• Permisos para crear credenciales OAuth y habilitar APIs.

Nota: Esta integración usa OAuth 2.0 (no API Key). La API Key no sirve para que n8n “inicie sesión” en tu cuenta.

1) Crear el proyecto en Google Cloud

1. Entra en Google Cloud Console.
2. Crea un proyecto nuevo (ej.: n8n Google Sheets).
3. Selecciona ese proyecto para que todo lo que hagas quede dentro.

2) Habilitar APIs necesarias

Para que Google Sheets funcione bien con automatizaciones, normalmente necesitas dos APIs:

• Google Sheets API
• Google Drive API (para crear/gestionar hojas o acceder a archivos)

1. Ve a APIs & Services → Library.
2. Busca y habilita: Google Sheets API.
3. Busca y habilita: Google Drive API.

3) Configurar la pantalla de consentimiento (OAuth)

Este paso es el que causa el aviso: “Google no ha verificado esta aplicación”. La solución correcta (si es para uso interno) es dejar la app en Testing y añadir tu cuenta como Test user.

3.1 Tipo de usuario

• External: si usas cuentas personales Gmail o fuera de Google Workspace.
• Internal: solo si tienes Google Workspace y quieres restringirlo a tu organización.

3.2 Información mínima obligatoria

• Nombre de la aplicación
• Email de soporte
• Email de contacto del desarrollador

3.3 Usuarios de prueba (clave para que no te bloquee)

1. En OAuth consent screen pon estado Testing.
2. En Test users añade el Gmail exacto con el que autorizarás desde n8n.
3. Guarda.

Si lo haces así, Google deja continuar sin tener que pasar por una verificación completa (que suele ser innecesaria para automatizaciones privadas).

4) Crear credenciales OAuth 2.0

1. Ve a APIs & Services → Credentials.
2. Create credentials → OAuth client ID.
3. Selecciona Web application.
4. Pon un nombre (ej.: n8n Google Sheets).

4.1 Orígenes autorizados de JavaScript

Normalmente aquí va tu dominio base, por ejemplo:

https://automatic.tudominio.com

4.2 Redirect URI autorizado

Este punto es crítico: debe ser EXACTAMENTE el callback que te muestra n8n (mismo protocolo, dominio, ruta y barras).

5) Configurar el Redirect URI exacto de n8n

El error Error 400: redirect_uri_mismatch significa que Google tiene una URL y n8n está enviando otra diferente.

1. En n8n, abre la credencial OAuth del nodo Google Sheets.
2. Copia la OAuth Redirect URL que te enseña n8n.
3. Pégala en Google Cloud en Authorized redirect URIs.
4. Guarda y espera 1-2 minutos.

Checklist de coincidencia exacta:

• https vs http
• subdominio correcto (www / sin www)
• barra final “/” (si existe, debe coincidir)
• ruta completa (ej. /rest/oauth2-credential/callback)

6) Crear la credencial en n8n (Google Sheets)

1. En n8n: Credentials → crea credencial de Google Sheets OAuth2.
2. Pega el Client ID y Client Secret del OAuth Client en Google Cloud.
3. Guarda.
4. Haz clic en Sign in with Google.

Si aparece el aviso “Google no ha verificado esta aplicación”, entra en:

• Configuración avanzada → Ir a … (no seguro)

Si NO te deja, vuelve a la sección 3 y añade tu cuenta en Test users.

7) Errores comunes y soluciones

7.1 Error 400: redirect_uri_mismatch

Causa: el redirect URI no coincide exactamente con el de n8n.

Solución: copia de n8n el callback y pégalo tal cual en Google Cloud.

7.2 “Google no ha verificado esta aplicación”

Causa: OAuth consent screen en Testing + cuenta no autorizada como test user.

Solución: añade tu Gmail en Test users y reintenta.

7.3 No aparecen hojas o da error al crear

Causa típica: falta habilitar Google Drive API.

Solución: habilita Drive API y reintenta.

7.4 Estás usando API Key en lugar de OAuth

Causa: la API Key no sirve para autenticar a un usuario y acceder a su Drive/Sheets privados.

Solución: usa OAuth 2.0 (Client ID + Secret + Redirect URL).

8) Buenas prácticas para producción

• Usa HTTPS siempre (Let’s Encrypt o proxy del VPS).
• Guarda el Client Secret como secreto (nunca en repositorios).
• Limita scopes a lo mínimo necesario.
• Documenta el flujo: proyecto → APIs → OAuth consent → credenciales → n8n.
• Si automatizas para clientes, crea un proyecto OAuth por cliente o una estrategia clara de multi-tenant.

FAQ

¿Necesito verificar la app con Google?

No, si es para uso privado/interno: déjala en Testing y añade tus cuentas en Test users.

¿Puedo usar esto sin dominio, solo con IP?

Se puede, pero es menos estable. Lo recomendado es un dominio con HTTPS.

¿Qué operación de n8n uso para añadir datos?

Para logs y leads: Anexar fila. Para actualizar datos existentes: Agregar o actualizar fila o Actualizar fila.