Ressources · Intégration n8n

Intégration Google Cloud Firestore n8nAutomatiser Google Cloud Firestore avec n8n.

Où atterrissent les données qu'un workflow vient de traiter ? L'intégration Google Cloud Firestore n8n répond avec 7 opérations réparties sur 2 ressources : écrire, lire, interroger et supprimer des documents, lister les collections racine. Aucun trigger côté Firestore, le workflow démarre ailleurs.

Tester l'intégration Google Cloud Firestore sur n8nVoir les 7 opérations

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert l'intégration Google Cloud Firestore n8n ?

Google Cloud Firestore est la base de données documentaire de Google, et le nœud n8n lui parle en direct : 7 opérations sur 2 ressources, Document et Collection. Tu crées, lis, mets à jour et supprimes des documents, tu listes les collections racine d'une base, ou tu envoies une requête structurée, sans écrire une ligne de code client.

Firestore n'a pas de nœud trigger dans n8n. Le trigger, c'est le nœud qui lance un workflow : ici, ce sera un Schedule Trigger à intervalle fixe, un Webhook n8n (une URL qu'un autre service appelle), ou le déclencheur d'un autre outil.

Premier cas, la boutique en ligne. Une commande arrive, le workflow la nettoie, et document.create écrit un document par commande dans une collection commandes, avec la référence comme Document ID. Retrouver la commande plus tard tient en une lecture par cet identifiant, sans chercher dans le champ. Un message Slack en fin de branche prévient l'équipe logistique.

Deuxième cas, le catalogue partagé. L'équipe produit tient ses fiches dans Airtable, un Schedule Trigger lit les fiches modifiées, et document.upsert les pousse dans Firestore. Comme l'opération crée ou met à jour selon que le document existe, le workflow peut repasser toutes les heures sans jamais créer de doublon. L'inverse marche aussi : document.getAll avec Return All activé sort la collection entière vers Google Sheets pour les gens qui travaillent au tableur, ou vers Supabase quand il faut du SQL pour du reporting.

Troisième cas, la recherche au milieu d'un workflow plus large. Un client répond à un email, il faut sa fiche : document.get la récupère par identifiant. Quand l'identifiant est inconnu, document.query prend une requête structurée en JSON et filtre sur un champ à la place.

Le nœud HTTP Request prend le relais dès que l'opération manque à la liste. Il appelle n'importe quel endpoint de l'API Firestore en réutilisant le même credential, c'est-à-dire l'accès enregistré une fois dans n8n, via l'authentification prédéfinie. Écritures par lot, gestion des index : c'est par là.

Deux limites à connaître avant de construire. Aucun flux d'événements : un document modifié dans Firestore ne réveille pas n8n tout seul, il faut aller lire à intervalle régulier. Et document.query attend du JSON de requête structurée, pas un constructeur de filtres à cocher, donc garde la syntaxe Firestore sous la main. Pour prendre le nœud en main de zéro, la Formation n8n fait le tour du constructeur.

Connexion

Comment connecter Firestore à n8n ?

  1. 01

    Créer le credential dans n8n

    Ouvre le menu Credentials et choisis le credential OAuth2 de Google Cloud Firestore (googleFirebaseCloudFirestoreOAuth2Api). Un credential se crée une fois et se réutilise dans tous les workflows : le nœud te le proposera ensuite dans sa liste déroulante. Sur n8n Cloud, le chemin court s'appelle Managed OAuth2 : tu cliques sur Sign in with Google et il n'y a rien d'autre à configurer dans la Google Cloud Console.

  2. 02

    Monter le client OAuth dans la Google Cloud Console

    Sur une instance auto-hébergée, il faut passer par Custom OAuth2. Crée un projet Google Cloud, active les API, puis configure l'écran de consentement OAuth avec un App name et un User support email. Dans Branding, ajoute le domaine autorisé n8n.cloud, ou celui de ton instance. Va ensuite dans Credentials, Create credentials, OAuth client ID, type Web application, et colle l'OAuth Redirect URL de ton credential dans Authorized redirect URIs.

  3. 03

    Ou passer par un compte de service

    Le nœud accepte aussi un credential Service Account (serviceAccount), pratique quand personne ne doit se connecter dans le flux OAuth. Dans la console : Credentials, Create credentials, Service account, remplis Service account name et Service account ID, puis onglet Keys, Add key, Create new key, JSON. Ouvre le fichier téléchargé, copie client_email dans Service Account Email et private_key dans Private Key, sans les guillemets qui l'entourent.

Actions

Les 7 opérations du nœud Firestore

Le nœud Google Cloud Firestore expose 7 opérations sur 2 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
RessourceCreateGetGet ManyDeleteQueryCreate or Update
Document✓✓✓✓✓✓
Collection✓

Document

6 opérations
01

Create a document

document.create

Ce que tu vois dans n8n

Notes & cas d'usage

Écrit un nouveau document dans une collection et renvoie ce que Firestore a enregistré. Chaque attribut listé devient un champ.

Paramètres clés

  • Project Name or ID : le projet tel qu'il apparaît dans l'URL de la console Firebase, pris dans la liste ou passé par une expression, la syntaxe n8n qui lit un champ de l'item entrant ({{ $json.projectId }}).
  • Database : la base visée, en général la valeur par défaut proposée.
  • Collection : la collection qui reçoit le document.
  • Columns / Attributes : les attributs à enregistrer, par exemple productId, modelName, description.
  • Document ID : facultatif. Vide, Firestore génère l'identifiant ; rempli, il garde ta clé.
Cas d'usage
journaliser chaque commande traitée dans son document, avec la référence en Document ID.
02

Create or update a document

document.upsert

Ce que tu vois dans n8n

Notes & cas d'usage

Une seule opération couvre les deux cas : le document est créé s'il n'existe pas, mis à jour s'il existe déjà. Un workflow qui repasse sur la même fiche laisse un document, pas deux.

Paramètres clés

  • Project Name or ID : le même sélecteur de projet que les autres opérations.
  • Database : la base cible, en général la valeur par défaut proposée.
  • Collection : la collection qui contient les documents à mettre à jour.
  • Update Key : le champ de l'item entrant qui porte l'identifiant du document, documentId par exemple. Il arbitre entre création et mise à jour.
  • Columns /Attributes : les colonnes à insérer, du genre age, city, location.
Cas d'usage
garder une fiche client alignée à chaque modification envoyée par le CRM.
03

Delete a document

document.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un document d'une collection. Firestore supprime par chemin : l'opération réclame l'identifiant exact, pas la valeur d'un champ à l'intérieur du document.

Paramètres clés

  • Project Name or ID : le projet Firestore, choisi dans la liste ou construit par expression.
  • Database : la base qui héberge la collection.
  • Collection : le nom de la collection.
  • Document ID : l'identifiant du document à retirer, souvent {{ $json.documentId }} récupéré d'un nœud précédent.
Cas d'usage
traiter une demande de suppression de compte en retirant le document une fois que la branche d'archivage a fait son travail.
04

Get a document

document.get

Ce que tu vois dans n8n

Notes & cas d'usage

Relit un document et passe ses champs au nœud suivant. Rien n'est écrit, c'est donc l'opération à mettre avant une décision, pour vérifier l'état d'une fiche.

Paramètres clés

  • Project Name or ID : le projet affiché dans l'URL de la console Firebase.
  • Database : la base à lire.
  • Collection : la collection où chercher.
  • Document ID : l'identifiant à récupérer. Un champ requis vide bloque l'exécution du nœud, donc ajoute un If en amont si l'identifiant peut manquer.
  • Simplify : activé, n8n renvoie une version simplifiée du document au lieu de la réponse brute et de ses valeurs typées.
Cas d'usage
sortir la fiche d'abonnement avant une réponse au support, pour citer la bonne formule.
05

Get many documents

document.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Ramène les documents d'une collection sous forme de liste d'items, un item par document, prêt pour une boucle ou un export.

Paramètres clés

  • Project Name or ID : le projet Firestore concerné.
  • Database : la base qui contient la collection.
  • Collection : la collection à lire.
  • Return All : activé, n8n enchaîne les pages de l'API jusqu'à avoir tous les documents. Désactivé, il s'arrête à Limit.
  • Limit : le nombre maximal de documents renvoyés quand Return All reste désactivé.
  • Simplify : renvoie les documents dans leur forme simplifiée plutôt que la réponse brute.
Cas d'usage
l'export nocturne d'une collection vers un tableur, Return All activé pour ne rien tronquer.
06

Query a document

document.query

Ce que tu vois dans n8n

Notes & cas d'usage

Exécute une requête sur tes documents et ne renvoie que ceux qui correspondent. Plus économe que tout charger pour filtrer ensuite dans un nœud Code.

Paramètres clés

  • Project Name or ID : le projet sur lequel tourne la requête.
  • Database : la base qui héberge les données.
  • Query JSON : la requête à exécuter, en syntaxe de requête structurée Firestore, par exemple {"structuredQuery": {"where": {"fieldFilter": {"field": {"fieldPath": "age"},"op": "EQUAL", "value": {"integerValue": 28}}}, "from": [{"collectionId": "users-collection"}]}}. La collection se nomme dans la requête, pas dans un champ à part.
  • Simplify : réduit la réponse aux champs du document.
Cas d'usage
lister les comptes d'une même formule avant un emailing ciblé.

Collection

1 opération
07

Get many collections

collection.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les collections racine d'une base, ce qui permet à un workflow de découvrir ce qui existe au lieu d'écrire les noms de collections en dur.

Paramètres clés

  • Project Name or ID : le projet dont tu veux les collections.
  • Database : la base à inspecter, en général la valeur par défaut proposée.
  • Return All : activé, toutes les collections racine reviennent. Désactivé, le nœud s'arrête à Limit.
  • Limit : le nombre de collections à renvoyer quand Return All est désactivé.
Cas d'usage
un workflow d'inventaire qui liste les collections d'un projet, puis boucle sur chacune pour compter les documents.
Besoin d'aide

Besoin d'aide pour automatiser Google Cloud Firestore avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Google Cloud Firestore et n8n, les questions fréquentes

01L'intégration Google Cloud Firestore n8n est-elle gratuite ?
Oui, côté n8n. Le nœud Google Cloud Firestore est livré avec n8n : rien à installer, aucun coût supplémentaire pour le nœud lui-même. Il se comporte pareil sur n8n Cloud, l'offre hébergée par n8n, et sur une instance auto-hébergée lancée via Docker ou npm, en Community Edition sous licence Sustainable Use. Un workflow construit d'un côté tourne de l'autre sans modification. Ce que Google facture pour l'usage de Firestore est une autre affaire : c'est décompté sur ton projet Google, selon le volume de lectures et d'écritures de tes workflows.
02Quels credentials ou droits faut-il pour le nœud Firestore ?
Deux méthodes existent. OAuth2 est la recommandée et la plus simple à mettre en place : sur n8n Cloud, un clic sur Sign in with Google suffit grâce au Managed OAuth2, tandis qu'une instance auto-hébergée demande une application Custom OAuth2, donc un projet Google Cloud, un écran de consentement OAuth, et un OAuth client ID de type Web application dont les Authorized redirect URIs contiennent l'URL de redirection affichée dans le credential n8n. La seconde méthode est le compte de service : tu le crées dans la console, tu télécharges la clé JSON, puis tu recopies client_email dans Service Account Email et private_key dans Private Key. Le credential se crée une fois et sert à tous les workflows.
03Quelles sont les limites du nœud Firestore ?
Le nœud expose 7 opérations sur 2 ressources, Document et Collection. Les documents se créent, se mettent à jour, se lisent à l'unité ou en lot, s'interrogent et se suppriment ; les collections se listent seulement au niveau racine. Tout le reste, écritures par lot ou travail sur les index par exemple, passe par le nœud HTTP Request, qui atteint n'importe quel endpoint Firestore en réutilisant le même credential via l'authentification prédéfinie. Deux points pratiques : tant que Return All reste désactivé, le nœud s'arrête à Limit et tu récupères une collection partielle ; et l'opération Query attend du JSON de requête structurée, donc le filtre s'écrit en syntaxe Firestore, il ne se choisit pas dans une liste.
04n8n peut-il réagir en temps réel à une modification dans Firestore ?
Pas directement. Firestore n'a pas de nœud trigger dans n8n, donc rien ne réveille un workflow quand un document change dans la base. Deux contournements. Soit un Schedule Trigger tourne à intervalle fixe et relit les données avec Get many documents ou Query, puis compare avec ce que le workflow connaît déjà ; soit le changement est annoncé par ce qui l'a provoqué, qui appelle un Webhook n8n, une URL exposée par ton workflow, lequel écrit ensuite dans Firestore. Les workflows qui partent du trigger d'un autre outil, un formulaire ou un CRM, fonctionnent sur le même principe.
05n8n ou Make pour Google Cloud Firestore ?
La réponse tient à l'hébergement et au modèle de coût. Make est hébergé uniquement, sans option d'auto-hébergement, et facturé à l'opération : confortable quand tu ne veux jamais gérer de serveur, moins quand un workflow écrit des milliers de documents par jour. n8n tourne sur son offre Cloud ou sur ta propre machine via Docker ou npm, donc le chemin entre le workflow et ton projet Firestore peut rester dans ton infrastructure, ce qui compte quand les documents contiennent des données clients. La logique visuelle diffère aussi : n8n mélange le canevas et des nœuds de code quand un payload doit être remodelé. Les deux se connectent à Firestore, le choix porte sur l'endroit où vit le workflow.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.

Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations