Comment connecter Google Sheets à votre application

Pour connecter Google Sheets à votre application, activez l'API Google Sheets dans un projet Google Cloud, créez un compte de service, partagez la feuille de calcul avec l'adresse courriel du compte de service, puis conservez sa clé comme secret côté serveur. Votre serveur lit ensuite les lignes avec spreadsheets.values.get et en ajoute avec spreadsheets.values.append. Si les utilisateurs doivent connecter leurs propres feuilles, utilisez plutôt OAuth ; si la feuille est entièrement publique, une simple clé API suffit pour la lecture.

Ce guide explique quelle méthode convient, les appels nécessaires, les quotas et pièges à éviter, ainsi que des requêtes à donner à un outil de création d'applications par IA. Les détails sur Google proviennent de sa documentation pour développeurs, en date de septembre 2026.

Pourquoi connecter une feuille de calcul

Les raisons courantes sont les suivantes :

• Conserver le fonctionnement de l'équipe. Le personnel continue de modifier une liste de prix ou un horaire dans Sheets, et l'application les affiche.
• Recueillir les données là où les gens regardent déjà. Les nouvelles inscriptions, commandes ou réponses de formulaire arrivent sous forme de lignes.
• Produire des rapports. Exportez les données de l'application vers une feuille pour les personnes qui travaillent surtout avec des tableurs.
• Une étape intermédiaire. Partez de la feuille, puis passez à une vraie base de données. Voir comment transformer un tableur en application.

Choisir comment votre application s'authentifie auprès de Google

Le guide des identifiants de Google décrit trois types :

Pour la plupart des applications, un compte de service est le bon choix : un seul ensemble d'identifiants, qui vous appartient, avec un accès limité aux feuilles que vous partagez explicitement.

Étape par étape avec un compte de service

1. Créez ou choisissez un projet Google Cloud et activez l'API Google Sheets.
2. Créez un compte de service ainsi qu'une clé pour ce compte. La clé est un fichier JSON ; traitez-la comme un mot de passe.
3. Partagez la feuille de calcul avec l'adresse courriel du compte de service, à titre de lecteur pour une lecture seule ou d'éditeur pour écrire. Le guide de Google précise que cela se fait par l'écran de partage habituel.
4. Conservez la clé comme secret sur votre serveur, par exemple GOOGLE_SERVICE_ACCOUNT_JSON, ainsi que l'identifiant de la feuille (la longue chaîne dans l'URL de la feuille) sous le nom SHEET_ID.
5. Appelez l'API depuis le serveur avec la bibliothèque cliente de Google pour votre langage.
6. Mettez les lectures en cache si beaucoup de visiteurs voient les mêmes données, pour ne pas atteindre le quota.

Les appels que vous utiliserez

D'après le guide de Google sur la lecture et l'écriture de valeurs :

Les plages utilisent la notation A1. Google précise qu'une plage sans nom d'onglet, comme A1:B2, s'applique au premier onglet ; nommez donc l'onglet explicitement pour éviter les surprises lorsque quelqu'un réorganise les onglets.

RAW ou USER_ENTERED

Les écritures exigent un valueInputOption :

• RAW enregistre exactement ce que vous envoyez, sous forme de texte. =1+2 est enregistré comme le texte =1+2.
• USER_ENTERED traite la saisie comme si elle avait été tapée dans Sheets : les dates deviennent des dates et =1+2 devient une formule.

Si vous écrivez du texte saisi par les utilisateurs de votre application, utilisez RAW. Avec USER_ENTERED, une personne pourrait soumettre une formule qui s'exécute lorsqu'un collègue ouvre la feuille.

Quotas et erreurs

En septembre 2026, la page des limites de l'API Sheets de Google indique :

Il n'y a pas de limite quotidienne tant que vous respectez les quotas par minute. Un dépassement renvoie 429 : Too many requests, et Google recommande un recul exponentiel tronqué : attendre de plus en plus longtemps après chaque échec, avec un délai aléatoire, jusqu'à un maximum. Une requête unique qui dure plus de 180 secondes expire.

En pratique : n'appelez pas l'API à chaque affichage de page. Mettez en cache les données de la feuille pendant au moins une minute, regroupez les lectures avec batchGet et regroupez les écritures lorsque c'est possible.

Options et compromis

Pour tout ce qui concerne de nombreux utilisateurs ou des données sensibles, une base de données est une meilleure source de vérité. Voir ce qu'est une base de données.

Requêtes à donner à votre outil de création par IA

Lire une feuille :

Affichez l'onglet « Menu » de notre feuille Google sur la page du menu. Utilisez l'API Google Sheets depuis le serveur avec un compte de service dont la clé JSON se trouve dans le secret GOOGLE_SERVICE_ACCOUNT_JSON, et l'identifiant de la feuille dans SHEET_ID. Lisez la plage Menu!A2:D (nom, description, prix, catégorie). Mettez le résultat en cache pendant 5 minutes. Si l'API échoue, affichez la dernière version en cache. N'envoyez jamais la clé au navigateur.

Écrire des lignes :

Lorsqu'une personne envoie le formulaire de contact, enregistrez-le dans notre base de données et ajoutez aussi une ligne à l'onglet « Leads » (date, nom, courriel, message) avec spreadsheets.values.append et valueInputOption RAW. Si Google renvoie une erreur 429, réessayez avec un recul exponentiel ; si l'échec persiste, conservez le prospect dans la base de données et réessayez plus tard.

Erreurs courantes

• Oublier de partager la feuille avec l'adresse courriel du compte de service. L'API renvoie alors une erreur de permission, même si la clé est correcte.
• Clé dans l'interface ou dans le dépôt de code. La clé JSON donne accès à toutes les feuilles qui lui sont partagées. Voir comment protéger vos clés API.
• Utiliser USER_ENTERED pour la saisie des utilisateurs, ce qui permet l'injection de formules.
• Appeler l'API à chaque requête et atteindre le quota par minute au premier pic de trafic.
• Dépendre de la position des colonnes. Quelqu'un insère une colonne et l'application lit les mauvaises données. Lisez la ligne d'en-tête et associez les données par nom, ou verrouillez les en-têtes.
• Partager la feuille plus largement que nécessaire. « Toute personne disposant du lien » la rend publique.
• Utiliser une feuille comme base de données multi-utilisateurs. Les écritures simultanées et les permissions manquantes provoquent des pertes ou des fuites de données.

Liste de vérification

• API Sheets activée ; compte de service créé
• Feuille partagée avec l'adresse courriel du compte de service, au rôle le plus restreint nécessaire
• Clé et identifiant de feuille conservés comme secrets côté serveur
• Tous les appels effectués depuis le serveur
• Noms d'onglets utilisés dans les plages
• RAW utilisé pour le texte fourni par les utilisateurs
• Lectures mises en cache ; erreurs 429 gérées avec un recul
• L'application se dégrade proprement si Sheets est indisponible
• Source de vérité déterminée

Google Sheets dans Mythex

Mythex propose deux façons différentes de travailler avec Sheets. Les connecteurs relient votre compte Google à Mythex afin que l'agent puisse l'utiliser pendant la création, par exemple pour lire une feuille et construire un tableau de bord à partir de ses données ; selon la documentation, les identifiants restent auprès du service de connexion de Mythex et n'apparaissent jamais dans votre code (voir Connectors, et approuvez chaque autorisation demandée par Google). Pour que l'application publiée puisse lire ou écrire dans une feuille de manière autonome, la solution fiable est celle de ce guide : une clé de compte de service stockée comme secret de projet et des appels à l'API Sheets depuis votre serveur, comme dans Integrate any API. Si vous dépassez les capacités de la feuille, demandez à l'agent de déplacer les données dans la base de données du projet et de construire un tableau de bord par-dessus.

Questions