Ressources · Intégration n8n

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

Combien de fichiers passent encore par un glisser-déposer manuel chaque semaine ? L'intégration Google Cloud Storage n8n met 10 opérations et 2 ressources, les buckets et les objets, à portée d'un workflow. Pas de nœud trigger côté Google Cloud Storage : c'est une planification ou un autre outil qui lance l'exécution.

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

Pourquoi automatiser

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

Le nœud relie un workflow n8n aux buckets de ton projet Google Cloud. Il manipule deux choses : les buckets, qui sont les conteneurs, et les objets, qui sont les fichiers rangés dedans. Les 10 opérations couvrent la création, la lecture, la mise à jour et la suppression des deux. Un même workflow peut donc préparer un bucket, y déposer un fichier, corriger ses métadonnées puis faire le ménage, sans que personne ouvre la console Google Cloud.

Premier usage, le classement des pièces jointes. Un workflow démarre sur Gmail, récupère la facture attachée au message, et object.create l'écrit dans le bucket du fournisseur concerné avec l'option Use Input Binary Field activée. Le fichier n'est jamais téléchargé sur un poste : il passe du message au bucket dans la même exécution.

Deuxième usage, l'arrivée d'un client. Quand un compte est créé, bucket.create ouvre un espace dédié dans le projet, puis bucket.update pose les Labels qui serviront plus tard à ventiler la facture de stockage par équipe. Une convention de nommage propre à ce moment-là évite des heures de tri six mois après.

Troisième usage, l'inventaire. Une planification mensuelle enchaîne bucket.getAll sur le projet et object.getAll sur chaque bucket, puis écrit une ligne par objet dans Google Sheets. C'est la réponse la plus rapide à la question « qu'est-ce qu'on stocke, et depuis quand ».

Un credential, c'est un jeu d'identifiants enregistré une fois dans n8n et réutilisé partout : la même connexion Google sert à ce nœud et aux autres nœuds Google de l'instance. Quand un workflow a besoin d'autre chose que les 10 opérations du catalogue, le nœud HTTP Request appelle n'importe quel endpoint de l'API Cloud Storage en réutilisant ce même credential via l'authentification prédéfinie.

Ça vise les équipes qui stockent déjà chez Google et veulent arrêter les étapes manuelles autour des fichiers. Si le choix de la plateforme n'est pas encore tranché, l'Avis n8n détaille les contreparties, et la Formation n8n passe par la construction des premiers workflows.

Connexion

Comment connecter Google Cloud Storage à n8n ?

  1. 01

    Choisir la méthode d'authentification

    Le nœud accepte deux types de credentials : OAuth2, et Service Account, signalé comme recommandé dans la liste. OAuth2 connecte une personne et reste le plus simple à mettre en place. Le compte de service connecte le workflow lui-même, ce qui tient mieux dans la durée quand la personne qui a monté le flux quitte l'équipe. La doc Google conseille OAuth2 par défaut, et le compte de service quand tu sais pourquoi tu en as besoin.

  2. 02

    Créer le credential OAuth2

    Sur n8n Cloud, Managed OAuth2 est disponible pour certains nœuds Google : un clic sur Sign in with Google dans l'écran du credential suffit, rien à faire côté Google. Sinon, et toujours sur une instance auto-hébergée, bascule le menu déroulant sur Custom OAuth2, crée un client Web application dans la console Google Cloud, colle l'OAuth Redirect URL de n8n dans les Authorized redirect URIs, et rapporte le Client ID et le Client Secret.

  3. 03

    Ou fournir une clé de compte de service

    Dans la console Google Cloud, ouvre APIs & Services puis Credentials, et choisis Create credentials, puis Service account. Ouvre le compte créé, va dans l'onglet Keys, prends Add key puis Create new key, et sélectionne JSON. Google télécharge le fichier. Copie ensuite client_email dans le champ Service Account Email de n8n, et private_key dans le champ Private Key.

Actions

Ce que le nœud Google Cloud Storage sait faire

Le nœud Google Cloud Storage expose 10 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 ManyUpdateDelete
Bucket
Object

Bucket

5 opérations
01

Create a new Bucket

bucket.create

Ce que tu vois dans n8n

Notes & cas d'usage

Crée un bucket dans le projet Google Cloud que tu désignes. Ce bucket devient ensuite la destination visée par toutes les opérations sur les objets.

Paramètres clés

  • Project ID : le projet auquel rattacher le bucket, repris du sélecteur de projet de la console Google Cloud.
  • Bucket Name : le nom du nouveau bucket, réutilisé tel quel dans chaque opération sur les objets.
  • Location : l'emplacement des données du bucket, paramètre optionnel qu'il vaut mieux poser tout de suite.
  • Predefined ACL : une règle d'accès toute faite appliquée au bucket, de private à publicRead.
Cas d'usage
ouvrir un bucket par client dès la signature, plutôt que d'empiler les fichiers de tout le monde dans un conteneur commun.
02

Delete an empty Bucket

bucket.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Retire un bucket du projet. Le libellé dit la condition : le bucket doit être vide, donc un passage par object.getAll puis object.delete précède presque toujours cette opération.

Paramètres clés

  • Bucket Name : le bucket à supprimer, orthographié comme à sa création.
  • Metageneration Match : un filtre qui ne laisse passer l'appel que si la valeur de metageneration du bucket correspond à celle envoyée, ce qui bloque une suppression lancée sur un bucket modifié entre-temps.
Cas d'usage
démonter les buckets temporaires créés par un pipeline de test, une fois l'exécution archivée ailleurs.
03

Get a Bucket

bucket.get

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les métadonnées d'un bucket. Rien n'est écrit : c'est la façon prudente de vérifier une configuration avant qu'un workflow agisse dessus.

Paramètres clés

  • Bucket Name : le bucket à lire, souvent transmis par un nœud précédent avec une expression du type {{ $json.field }}, la syntaxe n8n pour aller chercher un champ de l'item entrant.
  • Projection : full ramène All Properties, noAcl renvoie les métadonnées sans les entrées de contrôle d'accès, ce qui allège l'item pour la suite.
Cas d'usage
un contrôle mensuel qui relit chaque bucket et signale ceux dont les réglages se sont écartés du modèle.
04

Get a list of Buckets for a given project

bucket.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les buckets d'un projet, un item par bucket, prêt à être parcouru en boucle.

Paramètres clés

  • Project ID : le projet à inventorier, le même identifiant que pour la création d'un bucket.
  • Prefix : filtre sur les noms de buckets, donc une convention de nommage avec un code client en tête te rend les buckets de ce client, et rien d'autre.
  • Return All : coché, n8n enchaîne les pages de l'API jusqu'au dernier bucket ; décoché, il s'arrête à la limite fixée.
Cas d'usage
produire l'état du stockage que réclame le service financier, une ligne par bucket dans un tableur.
05

Update the metadata of a Bucket

bucket.update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifie les réglages d'un bucket existant sans toucher aux fichiers qu'il contient.

Paramètres clés

  • Bucket Name : le bucket à modifier.
  • Labels : des étiquettes fournies par l'utilisateur, en paires clé et valeur, la manière habituelle de marquer un propriétaire, un environnement ou un centre de coût.
  • Versioning : la configuration de versionnage du bucket, envoyée en JSON.
Cas d'usage
ré-étiqueter les buckets après une réorganisation, pour répartir la facture de stockage par équipe sans rien renommer.

Object

5 opérations
06

Create an object

object.create

Ce que tu vois dans n8n

Notes & cas d'usage

Écrit un fichier dans un bucket. Elle accepte aussi bien un binaire déjà présent dans l'exécution qu'un texte composé dans n8n.

Paramètres clés

  • Bucket Name et Object Name : la destination et le nom du fichier, souvent construit avec une expression comme {{ $json.field }}.
  • Use Input Binary Field : à activer quand le contenu vient d'un champ binaire, dont le nom se renseigne dans Input Binary Field.
  • File Content : le texte à envoyer quand il n'y a pas de binaire, un CSV assemblé dans le workflow par exemple.
  • Content Type : un des Create Fields, il indique au navigateur de quel type de fichier il s'agit.
Cas d'usage
archiver chaque contrat signé dans le dossier du client dès le retour de la signature.
07

Delete an object from a bucket

object.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Efface un fichier. Un bucket, un nom, et l'entrée disparaît.

Paramètres clés

  • Bucket Name : le bucket qui contient le fichier.
  • Object Name : le nom exact de l'objet, préfixe compris quand celui-ci joue le rôle de dossier dans le chemin.
  • Generation : sélectionne une révision précise de l'objet choisi, utile quand un bucket garde plusieurs versions du même nom.
Cas d'usage
supprimer les rendus intermédiaires qu'une chaîne vidéo laisse derrière elle une fois le fichier final publié.
08

Get object data or metadata

object.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère un objet, et tu décides si tu veux le fichier lui-même ou les informations à son sujet.

Paramètres clés

  • Bucket Name et Object Name : le fichier à lire.
  • Return Data : json renvoie Metadata, media renvoie Object Data, c'est-à-dire le contenu du fichier.
  • Put Output File in Field : le nom du champ binaire de sortie dans lequel le fichier atterrit, pour que le nœud suivant puisse l'attacher ou le transformer.
Cas d'usage
ressortir un PDF stocké pour le joindre à un email, sans que personne le télécharge à la main au préalable.
09

Get a list of objects

object.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste le contenu d'un bucket, un item par objet.

Paramètres clés

  • Bucket Name : le bucket à parcourir.
  • Prefix : ne garde que les noms qui commencent par cette valeur, la façon de lister un seul dossier.
  • Return All et Limit : toutes les pages, ou un nombre maximal de résultats par exécution.
  • Delimiter : renvoie les résultats en mode arborescent, en utilisant cette valeur comme séparateur.
Cas d'usage
vérifier chaque matin que les exports de la veille sont bien arrivés, et lever une alerte quand le dossier est vide.
10

Update an object's metadata

object.update

Ce que tu vois dans n8n

Notes & cas d'usage

Réécrit les informations attachées à un fichier déjà stocké. Le contenu, lui, ne bouge pas.

Paramètres clés

  • Bucket Name et Object Name : l'objet à corriger.
  • Cache Control : un des Update Fields, il pilote la mise en cache du fichier quand celui-ci est servi.
  • Content Disposition : un autre Update Field, il oriente la façon dont un navigateur présente le fichier.
  • Metadata : du JSON libre attaché à l'objet, l'endroit où loger une référence interne.
Cas d'usage
rattraper des fichiers déposés avec le mauvais type, dans une boucle sur les résultats d'object.getAll.
Besoin d'aide

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

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Google Cloud Storage et n8n, les questions qui viennent après

01L'intégration Google Cloud Storage n8n est-elle gratuite ?
Oui du côté de n8n. Le nœud est livré avec n8n : rien à installer, aucun coût supplémentaire pour l'utiliser, aussi bien sur n8n Cloud que sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow se comporte de la même façon dans les deux cas. Ce que Google facture pour le stockage lui-même relève de ton contrat avec Google et n'est pas traité ici. En pratique, la vraie question de coût porte sur le nombre d'exécutions que les étapes fichier ajoutent à ton instance, pas sur le nœud.
02Quels credentials faut-il pour le nœud Google Cloud Storage ?
Deux méthodes existent : OAuth2, et Service Account, que le nœud signale comme recommandé. OAuth2 est la plus répandue et la plus rapide à configurer. Sur n8n Cloud, Managed OAuth2 permet de cliquer sur Sign in with Google et d'éviter complètement la console Google Cloud, pour les nœuds Google qui le prennent en charge. En auto-hébergé, tu crées une application Custom OAuth2 dans la console Google Cloud et tu rapportes un Client ID et un Client Secret, après avoir ajouté le domaine de ton instance aux domaines autorisés. La voie du compte de service consiste à donner à n8n un Service Account Email et une Private Key issus du fichier de clé JSON téléchargé. Dans les deux cas, le credential se crée une fois et se réutilise dans tous les workflows.
03Quelles sont les limites du nœud Google Cloud Storage ?
Le nœud expose 10 opérations réparties sur 2 ressources, les buckets et les objets. Tout ce qui sort de ce catalogue passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Cloud Storage en réutilisant le même credential Google via l'authentification prédéfinie : pas de seconde connexion à monter. L'autre point de vigilance concerne les listes. Return All décoché, n8n s'arrête à la valeur de Limit, ce qui convient pour un contrôle et fausse un export complet. Cette case explique une bonne partie des surprises rencontrées sur les opérations de listing.
04Peut-on déclencher un workflow à l'arrivée d'un fichier ?
Pas depuis ce nœud : Google Cloud Storage n'a pas de nœud trigger dans n8n, donc un workflow autour du stockage démarre ailleurs. Trois chemins couvrent presque tous les besoins. Le Schedule Trigger lance l'exécution à intervalle fixe et liste le bucket avec object.getAll, ce qui convient à un inventaire ou à un nettoyage. Le nœud Webhook de n8n fournit une URL, c'est-à-dire une adresse qu'un service tiers appelle pour signaler un changement, au lieu d'aller interroger le bucket en boucle. Enfin, l'exécution peut partir du trigger d'un autre outil, une nouvelle ligne, un nouveau message, un nouveau document, l'étape de stockage étant alors la suite logique.
05n8n ou Make pour Google Cloud Storage ?
Ça dépend de ce qui compte le plus dans ton contexte. Make est une plateforme hébergée, sans option d'auto-hébergement, facturée à l'opération, et la construction visuelle est son argument principal. n8n tourne sur tes propres serveurs ou sur n8n Cloud, avec un workflow identique dans les deux cas, ce qui pèse lourd quand les fichiers déplacés ne peuvent pas sortir d'une infrastructure que tu maîtrises. Le modèle de coût diffère aussi : la facturation à l'opération reste prévisible à faible volume et grimpe avec lui, là où l'auto-hébergement déplace le coût vers la machine et son entretien. Regarde l'hébergement, la maîtrise des données, le modèle de coût et l'aisance de ton équipe dans chaque éditeur, puis fais tourner le même workflow des deux côtés avant de trancher.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.