Intégration Google Sheets : Lecture, Écriture et Modification de Données

1. Connecter n8n à Google Sheets : OAuth2 vs. Compte de Service

Avant toute chose, il est indispensable de connecter votre compte Google à n8n. Contrairement à de nombreuses autres intégrations, Google propose plusieurs méthodes d'authentification, chacune avec ses avantages et ses inconvénients. Pour un consultant technique comme vous, comprendre cette distinction est crucial pour choisir la bonne architecture en fonction du projet.

Les deux principales méthodes sont :

• OAuth 2.0 : Vous vous connectez en tant qu'utilisateur. n8n agit "en votre nom" pour accéder à vos fichiers. C'est simple et rapide pour des projets personnels ou des tests, mais lie l'automatisation à votre compte personnel.
• Compte de Service (Service Account) : Vous créez un "compte robot" indépendant. Ce compte n'est pas lié à un utilisateur spécifique et possède ses propres permissions. C'est la méthode recommandée pour les workflows de production, car elle est plus robuste et sécurisée. Le "robot" n'accède qu'aux fichiers que vous partagez explicitement avec lui.

La vidéo suivante explique remarquablement bien ces deux méthodes et vous guide à travers la configuration dans la Google Cloud Console.

Pour les exercices de ce cours, la méthode du Compte de Service est recommandée car elle correspond aux bonnes pratiques pour des automatisations fiables. Une fois que vous avez configuré vos identifiants (credentials), vous pouvez passer à la manipulation des données.

Si vous préférez un support écrit, cet article de Hostinger détaille également la configuration via OAuth2.

2. Lire les données d'une feuille (Get row(s))

La première opération consiste à lire les données présentes dans votre feuille de calcul. Le nœud Google Sheets transforme les lignes de votre tableur en une liste d'objets JSON, la structure de données native de n8n.

L'opération à utiliser est Get row(s) in sheet.

La vidéo ci-dessous montre concrètement comment configurer ce nœud.

En résumé, pour lire des données :

1. Ajoutez un nœud Google Sheets.
2. Sélectionnez vos identifiants (credentials) configurés à l'étape 1.
3. Resource: Sheet.
4. Operation: Get Row(s).
5. Sheet ID: Sélectionnez votre document Google Sheets.
6. Sheet Name: Sélectionnez la feuille (l'onglet) spécifique.
7. Vous pouvez laisser les autres options par défaut pour lire toute la feuille. En exécutant le nœud, chaque ligne sera transformée en un item JSON dans la sortie.

3. Ajouter une ligne (Append row)

Pour ajouter des informations, par exemple des données collectées via un formulaire ou une autre API, on utilise l'opération Append Row in Sheet. Cette opération ajoute une nouvelle ligne à la fin de la feuille de calcul.

Points clés pour ajouter une ligne :

1. Ajoutez un nœud Google Sheets.
2. Operation: Append Row.
3. Sélectionnez le document et la feuille.
4. n8n détectera automatiquement les en-têtes de colonnes de votre feuille.
5. Pour chaque colonne, vous pouvez insérer des valeurs statiques ou, plus fréquemment, des expressions pour mapper les données provenant des nœuds précédents (ex: {{ $json.email }}).

4. Mettre à jour une ligne (Update row)

C'est ici que nous retrouvons le concept de la leçon précédente : pour modifier un enregistrement, il faut d'abord l'identifier de manière unique.

Dans Google Sheets, il n'y a pas d'ID système visible comme dans HubSpot. On utilise donc la valeur d'une colonne clé (Key Column) pour trouver la bonne ligne à mettre à jour. Par exemple, une colonne ID Produit, Email Client ou tout autre identifiant unique que vous gérez.

L'opération à utiliser est Update Row in Sheet.

Pour mettre à jour une ligne :

1. Ajoutez un nœud Google Sheets.
2. Operation: Update Row.
3. Sélectionnez le document et la feuille.
4. Key: Choisissez dans la liste déroulante la colonne qui servira d'identifiant unique (ex: 'ID').
5. Value: Renseignez la valeur qui permettra de trouver la ligne. C'est souvent une expression qui récupère cet ID d'un nœud précédent (ex: {{ $json.productId }}).
6. Dans la section Fields to Update, mappez les nouvelles valeurs aux colonnes que vous souhaitez modifier.

5. Rechercher des données

Le nœud Google Sheets n'a pas d'opération Search dédiée comme le nœud HubSpot. La recherche se fait généralement en deux temps :

1. Lire les données avec l'opération Get Row(s).
2. Filtrer les résultats dans n8n à l'aide d'un nœud IF ou Filter.

Par exemple, pour trouver un produit spécifique :

1. Google Sheets Node (Get Row(s)) : Lit tous les produits de la feuille.
2. IF Node : Vérifie pour chaque item si {{ $json.Produit }} est égal au nom du produit que vous cherchez.
   • La branche true du nœud IF contiendra uniquement le produit recherché, que vous pourrez ensuite traiter.

Pour les très grandes feuilles de calcul, cette méthode peut être inefficace. Dans de tels cas, des techniques plus avancées utilisant l'API Google Sheets avec des requêtes spécifiques peuvent être envisagées, mais cela sort du cadre de cette leçon.

6. Exercice d'application rapide

Pour mettre en pratique ce que nous venons de voir, suivez ces étapes :

1. Créez une nouvelle feuille Google Sheets avec les colonnes : ID, Produit, Stock.
2. Ajoutez-y deux lignes :
   • 1, Clavier, 50
   • 2, Souris, 120
3. Dans n8n, créez un workflow :
   • Nœud 1 (Start) : Déclencheur manuel.
   • Nœud 2 (Google Sheets - Lire) : Utilisez Get Row(s) pour lire les deux produits. Exécutez et vérifiez la sortie.
   • Nœud 3 (Google Sheets - Ajouter) : Utilisez Append Row pour ajouter un nouveau produit : ID: 3, Produit: Écran, Stock: 30. Exécutez et vérifiez votre feuille de calcul.
   • Nœud 4 (Google Sheets - Mettre à jour) : Utilisez Update Row. Configurez-le pour trouver la ligne où la colonne ID a la valeur 1 et mettez à jour la colonne Stock avec la nouvelle valeur 45. Exécutez et vérifiez à nouveau votre feuille.

Cet exercice simple vous assure d'avoir bien configuré vos identifiants et de maîtriser les quatre opérations de base.

Conclusion

Félicitations ! Vous maîtrisez désormais les interactions fondamentales entre n8n et Google Sheets. C'est une compétence essentielle qui vous servira dans une multitude de projets d'automatisation.

Points clés à retenir :

• La connexion à Google se fait via OAuth2 (lié à un utilisateur) ou Compte de Service (robot indépendant, recommandé pour la production).
• Les quatre opérations de base sont :
  • Get Row(s) pour lire les données.
  • Append Row pour ajouter de nouvelles lignes à la fin.
  • Update Row pour modifier une ligne existante, identifiée par une colonne clé.
• La recherche s'effectue en lisant les données puis en les filtrant dans n8n.

Vous êtes maintenant parfaitement préparé pour la prochaine leçon : un exercice de synthèse où vous construirez un workflow pour synchroniser les nouvelles lignes d'un Google Sheets vers des contacts HubSpot. À très bientôt