DocumentationWorkflowsApps et services

Google Sheets node

Lire des tableaux depuis Google Sheets, ajouter de nouvelles lignes ou mettre à jour des plages de cellules. Parfait pour les rapports, les logs ou comme source de données pour les étapes IA en aval. Découvre sa configuration, les entrées et sorties, le test et la résolution des erreurs.

9 min de lectureMis à jour le

Fonction du node

Lire des tableaux depuis Google Sheets, ajouter de nouvelles lignes ou mettre à jour des plages de cellules. Parfait pour les rapports, les logs ou comme source de données pour les étapes IA en aval.

Utilise Google Sheets comme étape clairement définie dans un workflow anymize.

  • Traite 1 entrée.
  • Fournit 1 sortie aux étapes suivantes.
  • S'exécute comme une étape normale du workflow.

Configurer le node

  1. 01Ouvre un workflow et ajoute Google Sheets depuis le catalogue.
  2. 02Dans Secrets des workflows, configure un profil Google OAuth pour ton propre compte Google et donne-lui accès au domaine dont ce node a besoin. Choisis-le ensuite dans le champ « Compte Google ».
  3. 03Renseigne les champs requis et associe les valeurs des étapes précédentes.
  4. 04Teste le node avec un petit jeu de données et vérifie sa sortie.
  5. 05Relie la sortie réussie et active le workflow après un test complet.

Actions et modes

Choisis la fonction voulue dans Action. Le panneau affiche ensuite les paramètres utiles.

  • Ajouter une ligne
  • Lire une plage
  • Mettre à jour une plage
  • Ajouter des lignes par colonnes

Paramètres

ChampSignificationZone
ActionChoix: Ajouter une ligne, Lire une plage, Mettre à jour une plage, Ajouter des lignes par colonnesStandard
Tableau (ID depuis l'URL)Ouvre ton tableau dans Google Sheets et copie le code depuis l'adresse : docs.google.com/spreadsheets/d/ICI/editStandard
PlageQuelle plage de cellules ? Format comme dans Sheets : Feuille1!A:Z (colonnes entières) ou Feuille1!A2:D10. Laisse vide pour la première colonne.Standard
ValeursUne cellule par ligne ou valeur. Pas besoin de saisir du JSON.Standard
Format d’importConfigure cette valeur dans le panneau du node.Standard
Compte GoogleChoisis le profil Google OAuth connecté pour cette feuille de calcul.Protégé
OngletGarde l’onglet du modèle ou saisis son identifiant. Les options permettent de le sélectionner par son nom.Standard
Associer les colonnesAssocie chaque champ à une colonne ou utilise les noms automatiquement. Tous les enregistrements entrants sont écrits ensemble.Standard
Sélectionner le document parChoix: Identifiant, Sélection enregistrée, LienStandard
Sélectionner l’onglet parChoix: Identifiant, Sélection enregistrée, Nom, LienStandard
Ligne des en-têtesConfigure cette valeur dans le panneau du node.Standard
Écrire les valeursSheets peut interpréter les nombres, les dates et les formules. Le mode exact conserve les valeurs fournies.Standard
Écrire les nouveaux en-têtesChoix: Conserver les valeurs exactes, Comme une saisie dans SheetsStandard
Ajouter directementRéduit les requêtes si aucune ligne ou colonne vide ne sépare les données. Sinon, laisse cette option désactivée pour écrire sous la dernière ligne remplie.Standard
Champs supplémentairesS’applique à l’association automatique lorsqu’un champ ne correspond à aucune colonne.Standard
Exécuter une fois par élémentDésactivé (par défaut) : le node s'exécute une fois pour tout l'input. Activé : s'il reçoit plusieurs éléments (par ex. de « Séparer la liste »), il s'exécute une fois PAR élément, et {{ $json }} correspond alors à cet élément. C'est ainsi que tu traites une liste de fichiers entrée par entrée.Standard
Si un élément échoue« Ignorer » écrit un champ `error` pour l'élément en échec et poursuit avec les autres, au lieu de perdre toute l'exécution à cause d'un seul fichier illisible.Standard
Pause entre les éléments (millisecondes)Attente avant chaque exécution sauf la première. 1000 = 1 seconde par élément. Utile si le service distant te limite. Maximum 300000 (5 minutes).Standard

Entrées et sorties

EntréeSignificationType
StandardReçoit le résultat complet de l'étape précédente.JSON
SortieSignificationType
StandardMet le résultat à disposition de l'étape suivante au format JSON.JSON

Ce node peut traiter les listes élément par élément. La gestion des erreurs et la pause se trouvent dans les paramètres avancés.

Exemple et test

Écrire un lead dans un sheet : commence avec un petit jeu de données reconnaissable. Vérifie la sortie et utilise uniquement les champs présents.

Exemple de test

{
  "range": "Leads!A:D",
  "values": [
    "Alice",
    "alice@example.com",
    "2026-04-19",
    "neu"
  ]
}

Accès et sécurité

Le node travaille avec ton propre compte Google. La connexion est un profil Google OAuth dans tes Secrets des workflows, et ce profil doit avoir accès au domaine de ce node. Ce domaine doit aussi être activé dans les paramètres de ta connexion Google sous Connecteurs. Le node ne voit et ne modifie que ce que ce compte a le droit de faire.

Le réglage « Actions autorisées » de ta connexion Google sous Connecteurs s'applique aussi à ce node et il est vérifié à chaque exécution. Avec « Lecture seule » ou « Lire et créer des brouillons », seules les actions de lecture s'exécutent : Lire une plage. Ces actions demandent « Autoriser les modifications » : Ajouter une ligne, Mettre à jour une plage, Ajouter des lignes par colonnes.

Les clés et identifiants ont leur place dans les Secrets des workflows ou dans tes comptes connectés. Ne les colle jamais en texte clair dans les champs, les données de test ou les descriptions.

Résoudre les erreurs

  • Aucune sortie : vérifie la dernière exécution et les champs fournis par le node précédent.
  • Variable vide : ouvre la sortie précédente et utilise un nom de champ réellement présent.
  • Connexion refusée : reconnecte le service avec les autorisations nécessaires.
  • Action bloquée : passe « Actions autorisées » de la connexion sous Connecteurs sur « Autoriser les modifications », ou choisis une action de lecture.
  • Liste traitée une seule fois : active l'exécution par élément.