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écouvrez 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.
Utilisez 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
- 01Ouvrez un workflow et ajoutez Google Sheets depuis le catalogue.
- 02Sélectionnez votre connexion google_byo. Vous pouvez la créer directement dans le workflow.
- 03Renseignez les champs requis et associez les valeurs des étapes précédentes.
- 04Testez le node avec un petit jeu de données et vérifiez sa sortie.
- 05Reliez la sortie réussie et activez le workflow après un test complet.
Actions et modes
Choisissez 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
| Champ | Signification | Zone |
|---|---|---|
| Action | Choix: Ajouter une ligne, Lire une plage, Mettre à jour une plage, Ajouter des lignes par colonnes | Standard |
| Tableau (ID depuis l'URL) | Ouvre ton tableau dans Google Sheets et copie le code depuis l'adresse : docs.google.com/spreadsheets/d/ICI/edit | Standard |
| Plage | Quelle 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 |
| Valeurs | Une cellule par ligne ou valeur. Pas besoin de saisir du JSON. | Standard |
| Format d’import | Configurez cette valeur dans le panneau du node. | Standard |
| Compte Google | Choisis le profil Google OAuth connecté pour cette feuille de calcul. | Protégé |
| Onglet | Garde l’onglet du modèle ou saisis son identifiant. Les options permettent de le sélectionner par son nom. | Standard |
| Associer les colonnes | Associe chaque champ à une colonne ou utilise les noms automatiquement. Tous les enregistrements entrants sont écrits ensemble. | Standard |
| Sélectionner le document par | Choix: Identifiant, Sélection enregistrée, Lien | Standard |
| Sélectionner l’onglet par | Choix: Identifiant, Sélection enregistrée, Nom, Lien | Standard |
| Ligne des en-têtes | Configurez cette valeur dans le panneau du node. | Standard |
| Écrire les valeurs | Sheets peut interpréter les nombres, les dates et les formules. Le mode exact conserve les valeurs fournies. | Standard |
| Écrire les nouveaux en-têtes | Choix: Conserver les valeurs exactes, Comme une saisie dans Sheets | Standard |
| Ajouter directement | Ré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émentaires | S’applique à l’association automatique lorsqu’un champ ne correspond à aucune colonne. | Standard |
| Exécuter une fois par élément | Dé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ée | Signification | Type |
|---|---|---|
| Standard | Reçoit le résultat complet de l'étape précédente. | JSON |
| Sortie | Signification | Type |
|---|---|---|
| Standard | Met 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: commencez avec un petit jeu de données reconnaissable. Vérifiez la sortie et utilisez 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é
Ce node utilise une connexion google_byo. Vérifiez les autorisations demandées et accordez uniquement les accès requis.
Stockez les clés et identifiants dans le gestionnaire protégé. Ne les insérez jamais dans les champs, données de test ou descriptions.
Résoudre les erreurs
- Aucune sortie: vérifiez la dernière exécution et les champs fournis par le node précédent.
- Variable vide: ouvrez la sortie précédente et utilisez un nom de champ réellement présent.
- Connexion refusée: reconnectez le service avec les autorisations nécessaires.
- Liste traitée une seule fois: activez l'exécution par élément.