Intégration Google Sheets

Connectez vos feuilles de calcul Google Sheets à Embases via une clé API Google. Contrairement à Notion et Airtable, cette intégration ne passe pas par OAuth — vous générez une clé API dans Google Cloud Console et la saisissez dans Embases.

Fonctionnement

Embases utilise l'API Google Sheets v4 pour lire vos feuilles de calcul. La connexion repose sur une clé API (API Key) que vous générez dans la Google Cloud Console, et non sur un flux OAuth.

Une clé API est une chaîne de caractères au format AIzaXXXXXXX... qui identifie votre projet Google Cloud auprès de l'API. Embases l'utilise pour envoyer des requêtes de lecture à l'API Google Sheets.

Limitation importante : avec une clé API simple (sans OAuth), l'API Google Sheets ne peut accéder qu'aux fichiers que vous avez rendus publics (mode « Tout le monde avec le lien peut voir »). Les fichiers privés ou partagés uniquement avec des personnes spécifiques ne sont pas accessibles. Planifiez votre utilisation en conséquence : créez un fichier Google Sheets dédié à vos graphiques Embases et rendez-le public.

La clé API est chiffrée avec AES-256 avant d'être stockée dans la base de données Embases. Elle n'est jamais exposée en clair dans l'interface.

Important : Google Sheets est la seule intégration Embases qui ne passe pas par OAuth. Si vous avez besoin d'accéder à des fichiers privés, utilisez plutôt Notion ou Airtable.

Obtenir une clé API Google

Vous devez créer un projet dans Google Cloud Console et activer l'API Google Sheets pour obtenir une clé. Voici les étapes :

  1. 1Rendez-vous sur console.cloud.google.com et connectez-vous avec votre compte Google.
  2. 2En haut de la page, cliquez sur le sélecteur de projet → « Nouveau projet ». Donnez-lui un nom (ex: « Embases ») et cliquez sur « Créer ».
  3. 3Dans le menu de gauche, allez dans « API et services » → « Bibliothèque ».
  4. 4Recherchez « Google Sheets API » dans la barre de recherche et cliquez dessus, puis cliquez sur « Activer ».
  5. 5Retournez dans « API et services » → « Identifiants » → cliquez sur « Créer des identifiants » → choisissez « Clé API ».
  6. 6Google génère une clé au format AIzaXXXX... Copiez-la.
  7. 7(Recommandé) Cliquez sur « Modifier la clé » → dans la section « Restrictions d'API », sélectionnez « Restreindre la clé » → choisissez « Google Sheets API » dans la liste. Cela empêche l'utilisation de la clé pour d'autres services Google si elle était compromise.
VisuelGoogle Cloud Console — création d'une clé API

Capture de la page « Identifiants » dans Google Cloud Console : le bouton « Créer des identifiants » est sélectionné, le menu déroulant affiche « Clé API ». En dessous, la clé nouvellement créée est visible sous forme de chaîne masquée avec un bouton « Copier ».

Astuce : La création d'un projet Google Cloud et l'utilisation de l'API Google Sheets dans les quotas gratuits sont gratuites. Vous n'avez pas besoin d'activer la facturation pour un usage standard.

Ajouter la clé API dans Embases

Une fois votre clé API copiée, voici comment la saisir dans Embases :

  1. 1Depuis votre tableau de bord, cliquez sur « Intégrations » dans la barre latérale.
  2. 2Sur la carte Google Sheets, cliquez dans le champ de saisie de la clé API.
  3. 3Collez votre clé API (format AIzaXXXX...).
  4. 4Cliquez sur « Enregistrer ».
  5. 5La carte affiche désormais un badge vert « Connecté » avec les premiers et derniers caractères de la clé masqués (ex: AIza****XYZ) pour confirmer que la bonne clé est enregistrée.

Astuce : Si vous souhaitez remplacer la clé par une nouvelle (par exemple après une rotation de sécurité), cliquez à nouveau sur le champ de saisie, entrez la nouvelle clé et sauvegardez. L'ancienne clé est écrasée.

Rendre vos fichiers accessibles

Comme mentionné dans la section Fonctionnement, la clé API ne peut lire que les fichiers Google Sheets publics. Avant de créer un embed, rendez votre fichier accessible :

Dans Google Sheets, cliquez sur le bouton « Partager » (en haut à droite) → dans la section « Accès général », changez « Limité » en « Tout le monde avec le lien » → assurez-vous que le rôle est « Lecteur » (pas Éditeur).

Le fichier est maintenant accessible par l'API avec votre clé. Copiez ensuite l'URL du fichier depuis la barre d'adresse du navigateur — vous en aurez besoin lors de la création de l'embed.

Note : rendre un fichier public en lecture seule ne permet pas à d'autres personnes de le modifier. Vos données restent en lecture seule pour quiconque a le lien, y compris Embases.

Astuce : Créez un fichier Google Sheets dédié à vos embeds plutôt que d'utiliser un fichier de travail existant. Cela vous permet de contrôler exactement quelles données sont exposées et de garder le reste de vos documents privés.

Créer un embed depuis Google Sheets

Une fois la clé API enregistrée et votre fichier rendu public, voici comment créer un embed :

  1. 1Depuis le tableau de bord, cliquez sur « Nouvel embed ».
  2. 2Dans le panneau de configuration, choisissez « Google Sheets » comme source de données.
  3. 3Collez l'URL complète de votre fichier Google Sheets (ex: https://docs.google.com/spreadsheets/d/ABC123/edit) — Embases en extrait automatiquement l'identifiant du fichier.
  4. 4Sélectionnez la feuille (onglet) dans le menu déroulant. Si votre fichier contient plusieurs onglets, ils apparaissent tous.
  5. 5Les colonnes de la première ligne de votre feuille sont détectées comme en-têtes et apparaissent comme options pour les axes X et Y.
  6. 6Choisissez la colonne pour l'axe X et la colonne pour l'axe Y.
  7. 7Le graphique se prévisualise en temps réel.

Format des données dans la feuille

Pour qu'Embases lise correctement vos données, votre feuille doit respecter quelques règles de structure.

Première ligne obligatoirement en en-têtes : Embases utilise la première ligne comme noms de colonnes. Ces noms apparaissent dans les menus de sélection des axes. Si votre première ligne contient des données plutôt que des en-têtes, ajoutez une ligne de titres en haut.

Colonnes pour l'axe X (catégories) : valeurs textuelles, dates, ou toute valeur servant d'étiquette. Exemples : « Mois », « Produit », « Région ».

Colonnes pour l'axe Y (valeurs) : valeurs numériques. Les cellules doivent contenir des nombres purs (entiers ou décimaux). Les formats monétaires (1 500 €, $1,000) sont acceptés — Embases ignore les symboles de devise automatiquement. Les pourcentages (42%) sont également supportés.

À éviter : • Lignes de total ou de sous-total en bas du tableau — elles faussent les graphiques. • Cellules fusionnées dans les colonnes de données. • Lignes vides au milieu des données — elles interrompent la lecture. • Formules retournant du texte dans une colonne censée être numérique.

Astuce : Si vos données changent régulièrement (nouvelles lignes ajoutées chaque semaine, par exemple), le graphique se mettra à jour automatiquement à chaque chargement de l'embed — tant que la structure (en-têtes, colonnes) reste la même.

Utilisation dans un espace d'équipe

L'intégration Google Sheets fonctionne différemment dans un workspace Embases par rapport à Notion et Airtable.

Dans un workspace, une seule clé API Google Sheets est partagée pour l'ensemble du workspace — il n'y a pas de connexion par membre. Le propriétaire du workspace (ou tout membre ayant accès à la page d'intégration du workspace) peut saisir ou modifier cette clé.

Tous les membres du workspace peuvent ensuite créer des embeds en utilisant des fichiers Google Sheets publics, sans avoir besoin de configurer leur propre clé API.

Conséquence pratique : si la clé API du workspace est supprimée ou devient invalide (par exemple parce que le projet Google Cloud a été désactivé), tous les embeds Google Sheets du workspace cessent de fonctionner simultanément. Veillez à conserver une clé valide à tout moment si des embeds Google Sheets sont en production.

Supprimer la clé API

Pour supprimer la connexion Google Sheets de votre compte (ou du workspace) :

  1. 1Allez sur la page Intégrations.
  2. 2Sur la carte Google Sheets, cliquez sur « Déconnecter ».
  3. 3Confirmez la suppression.
  4. 4La clé API est immédiatement effacée d'Embases.

Important : Les embeds basés sur Google Sheets afficheront une erreur dès la suppression de la clé. Pour les restaurer, saisissez une nouvelle clé API valide dans le champ de connexion.

Astuce : Pour une sécurité maximale, supprimez également la clé API depuis la Google Cloud Console (API et services → Identifiants → sélectionnez la clé → Supprimer). Cela la désactive côté Google, ce qui empêche toute utilisation même si la clé avait été copiée ailleurs.

À voir aussi