Intégration Google Sheets n8nAutomatiser Google Sheets avec n8n.
Une ligne ajoutée dans ton tableur déclenche un workflow n8n. L'intégration Google Sheets n8n réunit 10 opérations sur 2 ressources, le document et l'onglet, et le Google Sheets Trigger écoute 3 événements de ligne. De quoi tenir à jour le fichier partagé d'une équipe ops ou marketing sans le rouvrir à la main.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
L'intégration Google Sheets n8n, pour quoi faire ?
Un workflow n8n, c'est une suite d'étapes que le serveur exécute sans toi. L'intégration Google Sheets n8n couvre les deux sens de circulation : le nœud Google Sheets lit, écrit, met à jour et supprime des lignes dans un tableur, et le Google Sheets Trigger, le nœud qui démarre l'exécution, repère les lignes ajoutées ou modifiées à chaque passage, à l'intervalle que tu règles. La suite de cette page reprend le catalogue n8n opération par opération, avec les champs obligatoires, les options qui changent le résultat et les erreurs de connexion qui reviennent le plus souvent.
Le tableur devient la boîte de réception de l'équipe. Le trigger surveille un onglet, l'événement rowAdded sort au passage suivant, une fois la ligne apparue, et la suite du workflow pousse le contenu là où les gens regardent vraiment : un message Slack pour la personne concernée, un accusé de réception via Gmail. Rien ne change côté saisie.
Le fichier reste aligné sur la base, ligne par ligne. sheet.appendOrUpdate fait un upsert : quand une entrée correspondante existe dans l'onglet, elle est mise à jour ; sinon la ligne est ajoutée à la suite des données. Les valeurs arrivent du nœud précédent par une expression, c'est-à-dire une référence du type {{ $json.email }} que n8n remplace au moment de l'exécution. C'est l'opération qui évite le doublon quand une base Airtable change plusieurs fois dans la journée.
Le récap hebdomadaire se fabrique tout seul. sheet.read sort les lignes qui répondent à un filtre, le workflow calcule ce qu'il faut, puis sheet.append écrit le résumé dans un onglet dédié plutôt que d'écraser l'historique. Si n8n est nouveau pour toi, la formation n8n pose les bases avant de brancher un fichier de production.
Le nœud s'arrête à 10 opérations réparties sur 2 ressources. Mettre en forme des cellules, insérer un graphique, figer une ligne d'en-tête : rien de tout ça n'est exposé. Le nœud HTTP Request prend alors le relais et appelle l'API Google Sheets directement. Le credential Service Account prévoit d'ailleurs une option Set up for use in HTTP Request node, qui demande en retour les Scope(s) à utiliser.
Trois limites méritent d'être connues avant de tout câbler. La première ligne du fichier est traitée comme un en-tête, et sheet.read ne la renvoie pas, sauf à passer par l'option Data Location on Sheet. Un tableau brut ne s'insère pas tel quel : il faut le convertir en paires clé-valeur, avec un nœud Split Out, Code ou AI Transform. Enfin, renommer une colonne après avoir configuré le nœud provoque une erreur tant que Mapping Column Mode n'a pas été re-sélectionné pour rafraîchir la liste. Sur ce que la plateforme fait bien et là où elle coince, l'Avis n8n entre dans le détail.
Comment connecter Google Sheets à n8n ?
- 01
Choisir entre OAuth2 et Service Account
Le nœud accepte deux méthodes. OAuth2 est celle que n8n recommande, plus répandue et plus rapide à poser ; le Service Account est un compte technique Google, réservé aux cas qui le réclament. Un credential, c'est le bloc où n8n range ces identifiants pour les réutiliser partout. Sur n8n Cloud, Managed OAuth2 suffit : tu cliques sur « Sign in with Google » et rien n'est à préparer dans la Google Cloud Console.
- 02
Créer le client OAuth dans la Google Cloud Console
En auto-hébergé, ce bouton n'existe pas. Dans ton projet Google Cloud, ouvre OAuth consent screen, renseigne App name et User support email, choisis l'Audience (Internal pour ton organisation Google Workspace, External sinon), puis ajoute dans Authorized domains le domaine de ton instance, ou
n8n.cloud. Crée enfin un OAuth client ID de type Web application. - 03
Terminer le credential dans n8n
Google ouvre une fenêtre « OAuth client created » : copie le Client ID puis le Client Secret dans le credential n8n, en surveillant les espaces parasites au collage. Clique sur « Sign in with Google », puis enregistre. Aucun champ de scopes n'est à remplir ici : seul le credential Google OAuth2 API générique, celui qui sert à appeler l'API depuis HTTP Request, en réclame une liste.
Que surveille le Google Sheets Trigger ?
Google Sheets Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Google Sheets. Il écoute 3 événements, listés ci-dessous par famille. Tu en choisis un ou plusieurs, tu actives le workflow : n8n enregistre le webhook (l'URL que Google Sheets appelle) sur ton compte.
Ce que tu vois dans n8n
Tous les événements, par famille
Une ligne par objet, une puce par action. L'événement à cocher dans le nœud s'écrit objet.action ; survole une puce pour lire quand il se déclenche.
row.*2any.*1Notes de configuration
01Google Sheets Trigger
Ce nœud ouvre le workflow au lieu de le terminer. Il marche par polling : n8n interroge lui-même l'API Google Sheets à intervalle régulier, au lieu d'attendre un appel de Google. Aucun webhook à déclarer côté tableur, mais un départ qui arrive au passage suivant.
Paramètres clés
- Document : le tableur à surveiller, pris dans la liste déroulante, par URL ou par son
spreadsheetId. - Sheet : l'onglet visé dans ce document, obligatoire lui aussi : le trigger couvre un onglet à la fois, pas le fichier entier.
- Poll Times : l'intervalle entre deux interrogations de l'API, une minute au plus serré, donc le délai maximum avant le départ du workflow.
- Include in Output : ce que n8n fait sortir du nœud. L'option ne joue que sur une exécution automatique, pas pendant un test manuel.
- Columns to Watch : dans Options, les colonnes dont la modification compte, de quoi éviter qu'une colonne de commentaires relance le workflow à chaque retouche. La même collection porte Value Render, la forme des valeurs en sortie, et DateTime Render.
02Row Added, Row Updated
Cette première famille sépare la naissance d'une ligne de sa modification. La distinction paraît fine, elle évite pourtant de retraiter dix fois la même entrée parce qu'un collègue a corrigé une faute dans une cellule.
Paramètres clés
- Trigger On :
rowAddedne part que sur une ligne nouvelle,rowUpdateuniquement quand une ligne déjà présente change. - DateTime Render : à passer sur Formatted String quand tes colonnes de date ressortent en nombres. L'option n'apparaît que si Trigger On vaut Row Added, et le format obtenu dépend de la locale du tableur, réglable dans File, Settings, onglet General.
rowAdded pour accuser réception d'une demande déposée dans le fichier, rowUpdate pour réagir à une colonne de statut qu'on vient de faire passer au vert.03Row Added or Updated
Deuxième famille, un seul événement, anyUpdate, qui réunit les deux gestes précédents sous un même déclenchement. Un nœud, une case cochée, et le workflow part dans les deux situations.
Paramètres clés
- Trigger On :
anyUpdatepart aussi bien sur l'ajout que sur la modification d'une ligne. Le nœud n'accepte pas de joker : il faut désigner cet événement explicitement, comme les deux autres. - Sheet : le même onglet sert aux trois événements, donc deux surveillances différentes demandent deux nœuds.
Les 10 opérations du nœud Google Sheets dans n8n
Le nœud Google Sheets 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.
| Ressource | Create | Update Row | Delete Rows or Columns | Delete | Append Row | Append or Update Row | Clear | Delete | Get Row(s) |
|---|---|---|---|---|---|---|---|---|---|
| Document | ✓ | ✓ | |||||||
| Sheet Within Document | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Document
2 opérationsCreate spreadsheet
spreadsheet.createCe que tu vois dans n8n
Notes & cas d'usage
Aucun champ n'est obligatoire ici : n8n crée un tableur dans le Drive du compte connecté et renvoie son identifiant, celui que les opérations suivantes réclament dans Document.
Paramètres clés
- Title : le titre du tableur créé.
- Sheets : les onglets à créer d'emblée, chacun avec son Title et, si besoin, Hidden pour le garder masqué dans l'interface.
- Locale : la langue et le pays du fichier, au format
en,filouen_US, ce qui décide de l'affichage des dates et des montants. - Recalculation Interval : la fréquence de recalcul des fonctions volatiles comme
NOW, sur changement, à la minute ou à l'heure.
Delete spreadsheet
spreadsheet.deleteSpreadsheetCe que tu vois dans n8n
Notes & cas d'usage
La suppression porte sur le fichier lui-même, onglets compris, et pas seulement sur les lignes qu'il contient. À ne pas confondre avec Clear, qui vide sans supprimer.
Paramètres clés
- Document : le tableur visé, désigné depuis la liste, par URL ou par son
spreadsheetId. En mode By ID, c'est cet identifiant lu dans l'URL après/spreadsheets/d/qu'il faut coller, pas le titre du fichier.
Sheet Within Document
8 opérationsAppend or update row in sheet
sheet.appendOrUpdateCe que tu vois dans n8n
Notes & cas d'usage
Un upsert, pour reprendre le mot du nœud : si une entrée correspondante est trouvée dans l'onglet, la ligne est mise à jour ; sinon elle s'ajoute à la fin des données.
Paramètres clés
- Columns : la correspondance entre champs entrants et colonnes, saisie avec Map Each Column Manually ou laissée à n8n avec Map Automatically quand les noms coïncident déjà.
- Handling extra fields in input : le sort d'un champ sans colonne, entre créer la colonne, l'ignorer et lever une erreur.
- Minimise API Calls : moins d'appels à Google, mais à réserver aux onglets sans trou entre lignes ou colonnes, sous peine de voir les données se décaler.
Append row in sheet
sheet.appendCe que tu vois dans n8n
Notes & cas d'usage
Ici, rien n'est cherché avant d'écrire : la ligne se pose à la fin des données, même si la même existe déjà plus haut. L'opération des journaux et des historiques, là où écraser serait une perte.
Paramètres clés
- Sheet : l'onglet de destination, pris dans la liste, par URL, par
sheetIdou par son nom. - Columns : les valeurs à écrire. En Map Automatically, les champs entrants doivent porter le nom exact des colonnes, quitte à les renommer avant avec Edit Fields.
- Cell Format : Let Google Sheets format traite les valeurs comme une saisie au clavier, Let n8n format conserve les types envoyés par le workflow.
Clear sheet
sheet.clearCe que tu vois dans n8n
Notes & cas d'usage
Vider n'est pas supprimer : les cellules perdent leur contenu, l'onglet et sa place dans le fichier restent.
Paramètres clés
- Range : la plage concernée, en notation Google du type
MySheet!A:Fquand le tableur compte plusieurs onglets. - Clear : la portée du nettoyage, entre Whole Sheet, Specific Rows, Specific Columns et Specific Range.
- Keep First Row : à cocher pour conserver la ligne d'en-têtes et ne balayer que les données.
- Start Row Number : la première ligne effacée, sachant que la numérotation démarre à 1 pour cette opération.
Create sheet
sheet.createCe que tu vois dans n8n
Notes & cas d'usage
Un onglet de plus dans un tableur qui existe déjà, fabriqué pendant l'exécution plutôt qu'à la main la veille.
Paramètres clés
- Title : le nom de l'onglet ; une expression comme
{{ $json.mois }}y place la valeur calculée juste avant. - Sheet Index : la position de l'onglet dans le fichier, pour que le plus récent arrive en tête.
- Sheet ID : un identifiant imposé, obligatoirement positif ou nul, et définitif une fois posé.
- Tab Color : la couleur de l'onglet, pratique quand l'équipe relit le fichier à l'œil.
Delete sheet
sheet.removeCe que tu vois dans n8n
Notes & cas d'usage
Un onglet entier quitte le tableur, définitivement, pendant que les autres restent en place et gardent leur contenu.
Paramètres clés
- Document : le tableur qui héberge l'onglet.
- Sheet : l'onglet à retirer. Par identifiant, c'est le
sheetIdqui se lit après#gid=dans l'URL, et pas le nom affiché sur la languette.
Delete rows or columns from sheet
sheet.deleteCe que tu vois dans n8n
Notes & cas d'usage
Là où Clear laisse des cellules vides, cette opération retire les lignes ou les colonnes elles-mêmes de l'onglet.
Paramètres clés
- To Delete : Rows ou Columns, un choix qui commande la suite du formulaire.
- Start Row Number : la ligne de départ. Attention, la numérotation commence ici à 2, puisque la première ligne sert d'en-tête.
- Number of Rows to Delete : combien de lignes partent à partir de ce point.
Get row(s) in sheet
sheet.readCe que tu vois dans n8n
Notes & cas d'usage
Sans filtre, le nœud remonte toutes les lignes de l'onglet, en-tête exclu : n8n considère la première ligne comme la ligne de titres et ne la renvoie pas.
Paramètres clés
- Filters : une colonne et une valeur à comparer. Combine Filters décide ensuite si toutes les conditions doivent être vraies (AND) ou une seule (OR).
- When Filter Has Multiple Matches : par défaut seule la première ligne trouvée ressort ; Return All Matches les rend toutes.
- Output Formatting : Values (unformatted) retire les symboles de devise, Values (formatted) rend le texte tel qu'il s'affiche, Formulas renvoie la formule sans la calculer.
Update row in sheet
sheet.updateCe que tu vois dans n8n
Notes & cas d'usage
Seules les lignes déjà présentes sont concernées. Quand rien ne correspond, rien ne s'écrit : c'est Append or Update Row qu'il faut dans ce cas.
Paramètres clés
- Columns : les colonnes à réécrire, remplies une par une dans Values to Send avec Map Each Column Manually, ou reprises automatiquement quand les champs entrants portent le nom des colonnes.
- Data Location on Sheet : Header Row et First Data Row, à renseigner quand les en-têtes ne sont pas posés sur la première ligne du fichier.
Besoin d'aide pour automatiser Google Sheets avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
