Passer au contenu principal

​
À quoi sert ce node ?

Le node Google Sheets connecte vos workflows à Google Sheets. Lisez des données depuis des feuilles, écrivez les résultats, et automatisez vos traitements sur tableaux. Usages courants :
  • Lire des données d’entrée (URLs, contacts, mots-clés)
  • Stocker les résultats de workflows
  • Générer des rapports automatisés
  • Synchroniser des données entre systèmes

​
Configuration rapide

1

Connecter le compte Google

Allez dans Builder → Intégrations → Google et authentifiez-vous
2

Ajouter le node Google Sheets

Trouvez-le dans Intégrations → Google → Sheets
3

Saisir l’ID de la feuille et la plage

Indiquez quelles données lire ou écrire

​
Configuration

​
Champs obligatoires

​
spreadsheet_id
string
requis
L’identifiant unique de votre Google Sheet.Où le trouver : Dans l’URL : docs.google.com/spreadsheets/d/[SPREADSHEET_ID]/editExemple : 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms
​
operation
string
requis
L’opération à effectuer.
OpérationDescription
readLire les données de la feuille
writeÉcrire des données dans la feuille
appendAjouter des lignes à la fin
updateMettre à jour des cellules existantes
​
range
string
requis
La plage de cellules en notation A1.Exemples :
  • Sheet1!A:D — Colonnes A à D
  • Sheet1!A1:D100 — Plage précise
  • Sheet1!A2:D — Ignorer la ligne d’en-tête
  • Data!A:Z — Feuille nommée

​
Champs optionnels

​
values
array
Données à écrire (pour les opérations write/append).Format : tableau de tableaux :
[
  ["Name", "Email", "Status"],
  ["Alice", "alice@example.com", "Active"],
  ["Bob", "bob@example.com", "Pending"]
]
​
value_input_option
string
défaut:"USER_ENTERED"
Comment interpréter les valeurs saisies.
OptionComportement
RAWValeurs stockées telles quelles
USER_ENTEREDInterprétées comme si saisies par l’utilisateur
​
include_headers
boolean
défaut:"true"
Considérer la première ligne comme en-têtes (retourne des objets au lieu de tableaux).

​
Sortie

​
Opération read

Avec en-têtes : 
{
  "spreadsheet_id": "1BxiMVs...",
  "range": "Sheet1!A1:C3",
  "rows": 2,
  "columns": 3,
  "data": [
    {"Name": "Alice", "Email": "alice@example.com", "Status": "Active"},
    {"Name": "Bob", "Email": "bob@example.com", "Status": "Pending"}
  ]
}
Sans en-têtes : 
{
  "data": [
    ["Name", "Email", "Status"],
    ["Alice", "alice@example.com", "Active"],
    ["Bob", "bob@example.com", "Pending"]
  ]
}

​
Opération write

{
  "spreadsheet_id": "1BxiMVs...",
  "range": "Sheet1!A1:C3",
  "operation": "write",
  "updated_cells": 9,
  "updated_rows": 3,
  "status": "success"
}

​
Exemples

​
Lire des URLs pour du scraping

Opération : Read
Plage : URLs!A2:A (sans en-tête) Accès aux données : {{GoogleSheets_0.data}}

​
Enregistrer des résultats d’analyse

Opération : Append
Plage : Results!A:E Values : 
[[
  "{{url}}",
  "{{title}}",
  "{{wordCount}}",
  "{{score}}",
  "{{timestamp}}"
]]

​
Mettre à jour des enregistrements existants

Opération : Update
Plage : Data!A2:D2 Met à jour des cellules précises sans toucher aux autres.

​
Schémas courants

​
Read → Process → Write

​
Ajout incrémental

Ajoute des lignes sans écraser les données existantes.

​
Feuille comme base de données

Utiliser Sheets comme base simple :
  1. Read pour récupérer l’état actuel
  2. Process pour transformer
  3. Write pour enregistrer les mises à jour

​
Référence notation A1

NotationSignification
A1Une seule cellule
A1:B2Plage de A1 à B2
A:AColonne A entière
1:1Ligne 1 entière
A:CColonnes A à C
Sheet1!A1:B2Plage sur une feuille donnée

​
Bonnes pratiques

​
Utiliser des plages nommées

Créez des plages nommées dans Sheets pour des références stables : 
❌ Sheet1!A1:D100  (peut changer)
✅ DataTable       (plage nommée)

​
Inclure des en-têtes

Utilisez toujours des en-têtes pour des données lisibles : 
❌ [["Alice", "alice@example.com"]]
✅ [{"name": "Alice", "email": "alice@example.com"}]

​
Gérer les feuilles vides

Vérifiez les résultats vides : 
Conditional :
  Si {{GoogleSheets_0.rows}} égal à 0
    → Gérer le cas vide
  Sinon
    → Traiter les données

​
Utiliser des plages précises

Soyez précis pour de meilleures perfs : 
❌ A:Z     (lit toutes les colonnes)
✅ A:D     (uniquement les colonnes nécessaires)

​
Problèmes courants

  • Vérifiez que le compte Google a accès à la feuille
  • Ré-authentifiez-vous dans Paramètres → Intégrations
  • Vérifiez les paramètres de partage de la feuille
  • Vérifiez que l’ID de la feuille est correct
  • Vérifiez le nom de la feuille (sensible à la casse)
  • Vérifiez que le compte a accès
  • Vérifiez le paramètre include_headers
  • Vérifiez que la plage inclut toutes les colonnes nécessaires
  • Vérifiez les cellules fusionnées (peuvent poser problème)
  • Utilisez append au lieu de write pour ajouter des lignes
  • Indiquez une plage précise pour les mises à jour
  • Vérifiez que la plage ne chevauche pas des données existantes

​
Nodes associés

Google Docs

Lire le contenu des documents

BigQuery

Pour des jeux de données plus volumineux