Google Sheets

Avec Google Sheets, ton app enregistre ce que ses visiteurs envoient (une inscription, une commande, un message) comme une nouvelle ligne dans une feuille de ton Google Drive. Pas de base de données à gérer, pas de clé à aller chercher : tu connectes ton compte Google une fois, Highwind crée la feuille, et tu la consultes, la tries ou la partages comme n’importe quelle feuille Google.

C’est la solution la plus simple quand tu veux recevoir des données et les traiter toi-même : liste d’attente, inscriptions à un événement, demandes de devis, réservations, petites commandes.

Ce qu’il te faut

• Un compte Google (Gmail ou Google Workspace).
• C’est tout : le connecteur est gratuit, il utilise ton compte Google, et Highwind ne te facture rien de plus que les crédits du travail de l’agent.

Mettre en place Google Sheets

1. Demande la fonction à l’agent. Par exemple :

   Ajoute une liste d'attente sur la page d'accueil : prénom et e-mail, enregistrés dans une feuille Google Sheets.

   Tu peux aussi mentionner le connecteur avec @ (ou menu + → Connecteurs → Google Sheets). Si tu ne précises pas où ranger les données, l’agent te propose souvent une carte À toi de choisir : choisis Dans une feuille Google Sheets.

2. L’agent écrit le code. Il ajoute le serveur de l’app si besoin et le formulaire qui envoie chaque inscription à la feuille. Une carte Connecte ton compte Google apparaît dans le chat.

3. Connecte ton compte Google. Clique sur Connecter Google. Une fenêtre Google s’ouvre (le bouton affiche En attente de Google…) : choisis ton compte et accepte l’accès demandé. Highwind ne demande que l’accès aux fichiers qu’il crée pour toi.

4. La feuille est créée. La carte affiche Google est connecté : la feuille de ton app est prête. et un lien Ouvrir la feuille. Elle s’appelle « Nom du projet — Highwind » et se trouve dans ton Drive.

5. Teste. Remplis le formulaire dans l’aperçu, puis ouvre la feuille : la ligne apparaît en quelques secondes. Publie ton app pour que les visiteurs puissent s’inscrire.

Une fois pour tous tes projets

Ton compte Google reste connecté pour tout Highwind. Dans tes projets suivants, la feuille est créée dès que l’agent branche Google Sheets, sans repasser par Google. Chaque projet a sa propre feuille.

Tu peux aussi connecter Google avant de demander quoi que ce soit à l’agent : Paramètres du projet → Connecteurs, fiche Google Sheets, bouton Connecter Google.

Ce que contient la feuille

• Une ligne par envoi. Chaque nouvel envoi s’ajoute à la suite, sous les précédents.
• Les colonnes se créent toutes seules. La première ligne de l’onglet sert d’en-têtes (« Date », « Email »…). Si l’app envoie une information nouvelle, une colonne est ajoutée à droite.
• Un onglet par sorte de données. L’agent range par exemple les inscriptions dans un onglet « Inscriptions » et les commandes dans un onglet « Commandes ». Un onglet manquant est créé automatiquement.
• Du texte brut. Les valeurs sont écrites telles quelles : un visiteur qui tape une formule (=…) n’exécute rien, la cellule reste du texte.
• Limites : 50 colonnes par ligne et 5 000 caractères par cellule au plus.

Garde la première ligne et les noms de colonnes

L’app retrouve les colonnes par leur nom, dans la première ligne. Tu peux déplacer les colonnes, trier, filtrer ou colorer les lignes, mais si tu renommes un en-tête, l’app créera une nouvelle colonne avec l’ancien nom au prochain envoi. Ne supprime pas la première ligne.

Afficher les lignes dans l’app (lecture)

Par défaut, ton app peut seulement ajouter des lignes : elle ne peut pas relire la feuille. C’est voulu : si la clé de l’app était exposée par erreur, elle ne permettrait que d’ajouter des lignes, pas de lire tes données.

Si ton app doit afficher des lignes (les derniers avis, la liste des inscrits sur une page d’administration…), demande-le à l’agent : il active la lecture pour ce projet. Tu peux aussi la régler toi-même dans Paramètres du projet → Connecteurs → Google Sheets, case L’app peut relire les lignes (« à activer seulement si elle doit afficher ces données »). L’app lit alors les dernières lignes d’un onglet (100 par défaut, 500 au plus).

Affiche sur la page d'accueil les 5 derniers avis enregistrés dans l'onglet Avis de la feuille.

Attention

Les lignes de ta feuille contiennent souvent des données personnelles (e-mails, téléphones). L’agent ne les affiche jamais aux visiteurs sans que tu le demandes : réfléchis à qui doit pouvoir les voir avant d’activer la lecture.

Gérer Google Sheets dans un projet

Dans Paramètres du projet → Connecteurs, la fiche Google Sheets affiche l’état du projet :

État	Signification
Pas encore utilisé	L’agent n’a pas branché Google Sheets dans cette app.
À connecter	L’agent l’a branché ; il reste à connecter ton compte Google pour que la feuille soit créée.
Connecté	La feuille existe et l’app y écrit. La fiche indique Connecté avec ton adresse.

Actions disponibles :

• Ouvrir la feuille : l’ouvre dans Google Sheets.
• L’app peut relire les lignes : active ou coupe la lecture (voir plus haut).
• Régénérer la clé de l’app : si tu penses que la clé qui relie ton app à la passerelle Highwind a été exposée, crée-en une nouvelle. L’ancienne cesse aussitôt de fonctionner (« Nouvelle clé en place : l’ancienne ne fonctionne plus. »), et l’aperçu comme l’app en ligne passent à la nouvelle sans republier.
• Retirer : retire le lien entre ce projet et sa feuille. La feuille reste dans ton Drive. Si tu reconnectes Google ensuite, une nouvelle feuille est créée.

Déconnecter ton compte Google

Sur la page Connecteurs, ouvre la fiche Google Sheets et clique sur Déconnecter, puis confirme. Ce qui se passe :

• Highwind révoque son accès chez Google et efface ses jetons ;
• tes apps n’écrivent plus dans leurs feuilles jusqu’à ce que tu reconnectes Google depuis un projet ;
• les feuilles restent dans ton Drive, avec toutes leurs lignes.

Tu peux aussi retirer l’accès depuis ton compte Google (myaccount.google.com/permissions). Les apps reçoivent alors une erreur « L’accès Google a été retiré : reconnecte Google depuis Highwind ».

Reconnecter

Clique sur Connecter Google depuis un projet (carte du chat ou Paramètres du projet → Connecteurs). Si le compte que tu choisis a toujours accès à l’ancienne feuille, Highwind reprend la même feuille ; sinon (autre compte Google, feuille supprimée de ton Drive…), il en crée une nouvelle.

Cas d’usage

Liste d'attente

« Ajoute un formulaire de liste d’attente (e-mail seulement) et enregistre chaque inscription dans Google Sheets avec la date. »

Inscriptions à un événement

« Crée la page de mon atelier du 12 mars avec un formulaire d’inscription : nom, e-mail, nombre de places. Range tout dans une feuille Google Sheets. »

Commandes simples

« Ajoute un bouton Commander sur chaque produit : le client laisse son nom, son téléphone et sa quantité, et la commande s’ajoute dans l’onglet Commandes de ma feuille. »

Devis et contact

« Le formulaire de demande de devis doit enregistrer chaque demande dans Google Sheets, avec le type de projet et le budget. »

Bon à savoir

• Accès limité. Highwind demande à Google la seule permission drive.file : il n’accède qu’aux feuilles qu’il a créées pour tes apps, jamais au reste de ton Drive. C’est aussi pourquoi tu ne peux pas brancher une feuille que tu as créée toi-même : la feuille est toujours créée par Highwind.
• L’agent ne voit pas ton compte Google. Il ne voit ni tes identifiants ni tes jetons : le serveur de ton app passe par la passerelle Highwind avec une clé propre au projet, gérée par Highwind (tu ne la vois pas dans les secrets).
• Ni modification ni suppression. L’app ajoute des lignes (et les relit si tu l’actives) ; elle ne modifie ni ne supprime jamais une ligne existante.
• Débit. Une app peut faire jusqu’à 300 écritures ou lectures par minute (600 pour l’ensemble de tes projets). Au besoin, Google Sheets peut être momentanément saturé : l’app reçoit alors une erreur temporaire, à réessayer une minute plus tard.
• Besoin de plus ? Pour des comptes utilisateurs, des données que chacun modifie ou des volumes importants, une vraie base de données convient mieux : voir La base de données.

Voir aussi

Fiche Google SheetsPermissions et facturation du connecteur.

Les choix de donnéesGoogle Sheets, e-mail, Slack ou base de données : que choisir.

ConnecteursTous les services que ton app peut appeler.

SécuritéComment Highwind protège tes données et tes accès.