Automatiza Google Cloud Firestore con n8n: 7 operaciones

Por qué automatizar

¿Qué resuelve la integración Google Cloud Firestore n8n?

Google Cloud Firestore es la base de datos documental de Google, y el nodo de n8n habla con ella directamente: 7 operaciones sobre 2 recursos, Document y Collection. Creas, lees, actualizas y borras documentos, listas las colecciones raíz de una base o lanzas una consulta estructurada, sin escribir código de cliente.

Firestore no tiene nodo trigger en n8n. El trigger es el nodo que arranca un flujo de trabajo: aquí será un Schedule Trigger a intervalo fijo, un Webhook de n8n (una URL que otro servicio llama) o el disparador de otra herramienta.

Primer escenario, el inventario. Un almacén envía movimientos de stock, el flujo los normaliza y document.upsert los escribe en una colección stock usando la referencia del artículo como clave. Si el flujo se repite sobre la misma referencia, el documento se actualiza en lugar de duplicarse. Un correo con Gmail avisa cuando una referencia baja del umbral.

Segundo escenario, el informe de la mañana. Un Schedule Trigger despierta el flujo, document.getAll lee la colección con Return All activado y los items acaban en Google Sheets para quien trabaja con hojas de cálculo, o en Postgres cuando el equipo de datos necesita SQL. Si la copia vive en Supabase, el patrón es el mismo, solo cambia el nodo de destino.

Tercer escenario, la consulta puntual dentro de un flujo mayor. Llega un ticket de soporte y hace falta la ficha del cliente: document.get la trae por identificador. Cuando no conoces el identificador, document.query recibe una consulta estructurada en JSON y filtra por un campo.

El nodo HTTP Request cubre lo que falta. Llama a cualquier endpoint de la API de Firestore reutilizando el mismo credential, es decir el acceso que guardas una sola vez en n8n, mediante la autenticación predefinida. Escrituras por lotes o gestión de índices se hacen por ahí.

Dos límites antes de construir. No hay flujo de eventos: un documento que cambia en Firestore no despierta n8n por sí solo, hay que ir a leerlo cada cierto tiempo. Y document.query espera JSON de consulta estructurada, no un constructor de filtros con menús, así que ten la sintaxis de Firestore a mano. Para aprender el nodo desde cero, el Curso n8n recorre el editor completo.

Conexión

¿Cómo conectas Firestore con n8n?

01
Crea el credential en n8n
Abre el menú Credentials y elige el credential OAuth2 de Google Cloud Firestore (googleFirebaseCloudFirestoreOAuth2Api). Un credential se crea una vez y se reutiliza en todos los flujos: el nodo te lo ofrece después en su lista desplegable. En n8n Cloud existe el atajo Managed OAuth2, donde pulsas Sign in with Google y no hace falta tocar nada más en la Google Cloud Console.
02
Monta el cliente OAuth en la Google Cloud Console
En una instancia autoalojada toca el camino Custom OAuth2. Crea un proyecto de Google Cloud, activa las API y configura la pantalla de consentimiento OAuth con un App name y un User support email. En Branding añade el dominio autorizado n8n.cloud, o el de tu instancia. Después entra en Credentials, Create credentials, OAuth client ID, tipo Web application, y pega en Authorized redirect URIs la OAuth Redirect URL de tu credential.
03
O autentica con una cuenta de servicio
El nodo acepta también un credential Service Account (serviceAccount), útil cuando ninguna persona debe pasar por el flujo OAuth. En la consola: Credentials, Create credentials, Service account, rellenas Service account name y Service account ID, y en la pestaña Keys eliges Add key, Create new key, formato JSON. Abre el archivo descargado, copia client_email en Service Account Email y private_key en Private Key, sin las comillas que lo rodean.

Acciones

Las 7 operaciones del nodo Firestore

El nodo Google Cloud Firestore expone 7 operaciones en 2 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
Recurso	Create	Get	Get Many	Delete	Query	Create or Update
Document	✓	✓	✓	✓	✓	✓
Collection			✓

Document

6 operaciones

01

Create a document

document.create

Lo que ves en n8n

Notas y casos de uso

Escribe un documento nuevo en una colección y devuelve lo que Firestore ha guardado. Cada atributo de la lista pasa a ser un campo.

Parámetros clave

Project Name or ID: el proyecto tal como aparece en la URL de la consola de Firebase, elegido en la lista o pasado con una expresión, la sintaxis de n8n que lee un campo del item entrante ({{ $json.projectId }}).
Database: la base donde escribir, normalmente el valor por defecto.
Collection: la colección que recibe el documento.
Columns / Attributes: los atributos a guardar, por ejemplo productId, modelName, description.
Document ID: opcional. Vacío, Firestore genera el identificador; relleno, conserva tu clave.

Casos de uso

registrar cada pedido procesado en su documento, con la referencia como Document ID.

02

Create or update a document

document.upsert

Lo que ves en n8n

Notas y casos de uso

Una sola operación cubre los dos casos: crea el documento si no existe y lo actualiza si ya está. Un flujo que vuelve a pasar sobre la misma ficha deja un documento, no dos.

Parámetros clave

Project Name or ID: el mismo selector de proyecto que el resto de operaciones.
Database: la base de destino, normalmente el valor por defecto.
Collection: la colección que contiene los documentos a actualizar.
Update Key: el campo del item entrante que lleva el identificador del documento, por ejemplo documentId. Decide entre crear y actualizar.
Columns /Attributes: las columnas a insertar, del estilo age, city, location.

Casos de uso

mantener la ficha de un cliente al día cada vez que el CRM manda un cambio.

03

Delete a document

document.delete

Lo que ves en n8n

Notas y casos de uso

Borra un documento de una colección. Firestore borra por ruta, así que la operación pide el identificador exacto, no el valor de un campo dentro del documento.

Parámetros clave

Project Name or ID: el proyecto de Firestore, elegido en la lista o construido con una expresión.
Database: la base que aloja la colección.
Collection: el nombre de la colección.
Document ID: el identificador del documento a retirar, a menudo {{ $json.documentId }} recuperado de un nodo anterior.

Casos de uso

atender una solicitud de baja retirando el documento después de que la rama de archivado haya hecho su trabajo.

04

Get a document

document.get

Lo que ves en n8n

Notas y casos de uso

Relee un documento y entrega sus campos al nodo siguiente. No escribe nada, por eso encaja antes de una decisión, para comprobar el estado de una ficha.

Parámetros clave

Project Name or ID: el proyecto que aparece en la URL de la consola de Firebase.
Database: la base que vas a leer.
Collection: la colección donde buscar.
Document ID: el identificador a recuperar. Un campo requerido vacío bloquea la ejecución del nodo, así que pon un If delante.
Simplify: activado, n8n devuelve una versión simplificada del documento en vez de la respuesta cruda.

Casos de uso

sacar la ficha de suscripción antes de responder a un ticket, para citar el plan correcto.

05

Get many documents

document.getAll

Lo que ves en n8n

Notas y casos de uso

Trae los documentos de una colección como lista de items, uno por documento, listos para un bucle o una exportación.

Parámetros clave

Project Name or ID: el proyecto de Firestore implicado.
Database: la base que contiene la colección.
Collection: la colección a leer.
Return All: activado, n8n encadena las páginas de la API hasta tener todos los documentos. Desactivado, se detiene en Limit.
Limit: el número máximo de documentos devueltos mientras Return All siga desactivado.
Simplify: devuelve los documentos en su forma simplificada en vez de la respuesta cruda.

Casos de uso

la exportación nocturna de una colección a una hoja de cálculo, con Return All activado para no cortar nada.

06

Query a document

document.query

Lo que ves en n8n

Notas y casos de uso

Lanza una consulta sobre tus documentos y devuelve solo los que coinciden. Sale más barato que cargar la colección entera y filtrarla luego en un nodo Code.

Parámetros clave

Project Name or ID: el proyecto donde corre la consulta.
Database: la base que guarda los datos.
Query JSON: la consulta a ejecutar, en sintaxis de consulta estructurada de Firestore, por ejemplo {"structuredQuery": {"where": {"fieldFilter": {"field": {"fieldPath": "age"},"op": "EQUAL", "value": {"integerValue": 28}}}, "from": [{"collectionId": "users-collection"}]}}. La colección se nombra dentro de la consulta, no en un campo aparte.
Simplify: reduce la respuesta a los campos del documento.

Casos de uso

listar las cuentas de un mismo plan antes de un envío segmentado.

Collection

1 operación

07

Get many collections

collection.getAll

Lo que ves en n8n

Notas y casos de uso

Enumera las colecciones raíz de una base, para que un flujo descubra lo que existe en vez de llevar los nombres de colección escritos a mano.

Parámetros clave

Project Name or ID: el proyecto cuyas colecciones quieres.
Database: la base a inspeccionar, normalmente el valor por defecto propuesto.
Return All: activado, vuelven todas las colecciones raíz. Desactivado, el nodo se detiene en Limit.
Limit: cuántas colecciones devolver cuando Return All está desactivado.

Casos de uso

un flujo de inventario que lista las colecciones de un proyecto y después recorre cada una para contar documentos.

Necesitas ayuda

¿Necesitas ayuda para automatizar Google Cloud Firestore con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Google Cloud Firestore y n8n, preguntas frecuentes

01¿La integración Google Cloud Firestore n8n es gratuita?

Sí, por el lado de n8n. El nodo de Google Cloud Firestore viene incluido con n8n: no hay nada que instalar ni coste adicional por el nodo en sí. Funciona igual en n8n Cloud, la oferta alojada por n8n, y en una instancia autoalojada con Docker o npm, en Community Edition bajo licencia Sustainable Use. Un flujo construido en un sitio corre en el otro sin cambios. Lo que Google cobra por el uso de Firestore es otro asunto: se factura en tu proyecto de Google y depende del volumen de lecturas y escrituras de tus flujos.

02¿Qué credentials o permisos necesita el nodo de Firestore?

Hay dos métodos. OAuth2 es el recomendado y el más rápido de montar: en n8n Cloud basta pulsar Sign in with Google gracias a Managed OAuth2, mientras que una instancia autoalojada necesita una aplicación Custom OAuth2, o sea un proyecto de Google Cloud, una pantalla de consentimiento OAuth y un OAuth client ID de tipo Web application cuyos Authorized redirect URIs incluyan la URL de redirección que muestra el credential de n8n. El segundo método es la cuenta de servicio: la creas en la consola, descargas la clave JSON y copias client_email en Service Account Email y private_key en Private Key. El credential se guarda una vez y sirve para todos los flujos.

03¿Qué límites tiene el nodo de Firestore?

El nodo expone 7 operaciones sobre 2 recursos, Document y Collection. Los documentos se crean, se actualizan, se leen de uno en uno o en bloque, se consultan y se borran; las colecciones solo se listan a nivel raíz. Todo lo demás, escrituras por lotes o trabajo con índices por ejemplo, pasa por el nodo HTTP Request, que alcanza cualquier endpoint de Firestore reutilizando el mismo credential con la autenticación predefinida. Dos detalles prácticos: mientras Return All siga desactivado el nodo se detiene en Limit y recibes una colección parcial, y la operación Query espera JSON de consulta estructurada, así que el filtro se escribe en sintaxis de Firestore, no se elige en un menú.

04¿Puede n8n reaccionar en tiempo real a un cambio en Firestore?

No de forma directa. Firestore no tiene nodo trigger en n8n, así que nada despierta un flujo cuando cambia un documento en la base. Quedan dos caminos. O un Schedule Trigger corre a intervalo fijo y relee los datos con Get many documents o Query, comparando lo que llega con lo que el flujo ya conocía; o el cambio lo anuncia quien lo provocó, llamando a un Webhook de n8n, una URL que expone tu flujo, y el flujo escribe después en Firestore. Los flujos que arrancan desde el trigger de otra herramienta, un formulario o un CRM, siguen la misma lógica.

05¿n8n o Make para Google Cloud Firestore?

La decisión va de alojamiento y modelo de coste. Make solo existe alojado, sin opción de instalarlo en tu servidor, y se factura por operación: cómodo si nunca quieres mantener una máquina, menos cómodo cuando un flujo escribe miles de documentos al día. n8n corre en su oferta Cloud o en tu propia máquina con Docker o npm, de modo que el camino entre el flujo y tu proyecto de Firestore puede quedarse dentro de tu infraestructura, algo que pesa cuando los documentos guardan datos de clientes. La lógica visual también difiere: n8n combina el lienzo con nodos de código cuando hay que remodelar un payload. Los dos conectan con Firestore, lo que cambia es dónde vive el flujo.

Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.

Crea el credential en n8n

Monta el cliente OAuth en la Google Cloud Console

O autentica con una cuenta de servicio

¿Necesitas ayuda para automatizar Google Cloud Firestore con n8n?

Recibe nuestros tips de integración cada semana.