# Add-on Google Sheets : extraire des données dans votre feuille de calcul

> Installez l'add-on ImageToTable.ai depuis le Google Workspace Marketplace, connectez-le à votre compte existant avec la connexion Google ou une API Key, puis téléversez, traitez et écrivez les lignes extraites directement dans la feuille de calcul ouverte — en utilisant les mêmes crédits que l'application web.

L'**add-on ImageToTable.ai pour Google Sheets** place l'outil d'extraction dans un panneau latéral à côté de votre feuille de calcul. Vous téléversez des documents, les traitez et écrivez les lignes extraites dans la feuille sur laquelle vous travaillez — en utilisant le même compte, les mêmes [modèles](/docs/reference/glossary#template) et les mêmes [crédits](/docs/reference/glossary#credits) que le site web.

## Installer l'add-on

Installez-le depuis le Google Workspace Marketplace :

[ImageToTable.ai — Extract Data from Image](https://workspace.google.com/marketplace/app/imagetotableai_%E2%80%94_extract_data_from_image/758062068256?flow_type=2)

Une fois installé, ouvrez n'importe quelle feuille Google et allez dans **Extensions → ImageToTable.ai → Open**. Le panneau latéral apparaît à droite de la feuille de calcul ; rouvrez-le de la même manière chaque fois que vous en avez besoin.

## Connecter votre compte

L'add-on utilise votre compte ImageToTable.ai existant — aucun compte séparé à créer ni abonnement supplémentaire à souscrire. La section **Account** en haut du panneau latéral propose deux façons de le connecter :

- **Sign in with Google.** Cliquez sur **Sign in with Google** et approuvez la demande. Si ce compte Google est déjà lié à un compte ImageToTable.ai, le panneau latéral l'ouvre ; sinon, un compte est créé pour lui.
- **Paste an API Key.** Saisissez ou collez la clé dans le champ **Paste API Key** et cliquez sur **Save**. Le champ vous indique où la trouver : la section **API Key** de votre page de profil sur le site web.

L'API Key est ce qui relie le panneau latéral à votre compte, alors traitez-la comme un mot de passe — toute personne qui la possède peut agir au nom de votre compte. Pour en obtenir une, ou pour remplacer une clé que vous ne souhaitez plus utiliser, consultez [Gestion des API Key](/docs/guides/api-key-management).

Une fois connecté, la section Account affiche votre nom d'utilisateur, votre forfait et votre **Balance** en crédits. **Switch Account** connecte un autre compte via une API Key, et **Sign out** déconnecte le panneau latéral sans affecter quoi que ce soit dans la feuille de calcul.

Comme il s'agit du même compte, le panneau latéral partage tout avec l'application web :

- La liste **Files** affiche les lots de votre compte, y compris ceux téléversés ou traités sur le site web.
- La section **Data Columns** fonctionne avec les modèles que vous avez déjà enregistrés sur le site web.
- Le traitement utilise le même solde de crédits que celui affiché sur votre profil.

## Ce que vous pouvez faire depuis le panneau latéral

### Téléverser des documents

Dans la section **Your Uploads**, utilisez le bouton **Upload** de l'onglet **Files** pour ajouter des fichiers depuis votre ordinateur. Les images, PDF, documents Word (`.docx`) et fichiers texte brut (`.txt`) sont acceptés, et vous pouvez en sélectionner plusieurs à la fois. L'ajout d'un PDF ouvre d'abord une boîte de dialogue **Select PDF Pages**, afin que vous choisissiez les pages à envoyer plutôt que de prendre tout le document. Voir [Téléversement de documents](/docs/guides/uploading-documents) pour savoir ce que chaque type de fichier fait à son arrivée.

### Choisir quoi extraire

La section **Data Columns** fonctionne comme celle du tableau de bord. Saisissez un nom de colonne dans le champ (il suggère *Column name, e.g. Invoice Number*) et cliquez sur **Add** ; **New**, **Switch** et **Settings** créent, choisissent et configurent des modèles. Tout modèle enregistré sur le site est disponible ici, vous pouvez donc définir vos colonnes une fois et les utiliser depuis l'un ou l'autre endroit — voir [Modèles et colonnes](/docs/concepts/templates-and-columns). Si vous lancez le traitement d'un lot sans colonnes définies et contenant plus d'un fichier, le panneau latéral peut proposer une liste **AI-Suggested Columns** avant de démarrer.

### Traiter un lot

Chaque lot de la liste Files possède une commande de lecture qui lance son traitement. Le panneau latéral vérifie d'abord votre solde de crédits ; s'il ne suffit pas pour chaque fichier, il affiche une boîte de dialogue **Insufficient Credits** proposant **Get More Credits** ou le traitement des fichiers couverts par le solde. Un lot déjà traité peut être relancé, et le panneau latéral demande s'il faut soumettre à nouveau uniquement les fichiers en échec et non traités ou tout retraiter.

### Écrire les résultats dans la feuille

**Insert** écrit les lignes extraites dans la feuille actuellement ouverte. Vous pouvez insérer le résultat d'un fichier unique, d'un lot entier ou de plusieurs lots à la fois — les résultats partageant les mêmes colonnes sont écrits sous un seul en-tête, quel que soit le lot d'origine. Chaque ligne insérée porte son **File Name** et son **Batch** sources, afin que les lignes restent traçables une fois dans la feuille.

Si les colonnes d'une insertion correspondent à la dernière insertion dans cette feuille, les lignes sont ajoutées sous l'en-tête existant. Si le jeu de colonnes est différent, une nouvelle ligne d'en-tête est ajoutée au-dessus des nouvelles lignes au lieu de les mélanger à l'ancien tableau.

Avant d'insérer, vous pouvez ouvrir un aperçu montrant le tableau extrait en regard du document original et vous permettant de parcourir les fichiers du lot. Le panneau latéral traite les fichiers en mode To Table, le résultat écrit est donc le tableau extrait ; un lot sans résultat de tableau n'a rien à insérer. Pour un document que vous souhaitez récupérer en sortie Word modifiable plutôt qu'en tableau, utilisez le mode To Word de l'application web et [Export](/docs/guides/export).

## Comment fonctionnent les crédits

Le add-on n'a pas de quota séparé qui lui est propre. Le traitement depuis le panneau latéral est facturé sur les mêmes [crédits](/docs/reference/glossary#credits) que l'application web, au même taux : un débit par fichier traité, défini par le [Model Tier](/docs/concepts/model-tier) de votre compte. Comme chaque page d'un fichier PDF, Word ou texte compte comme un fichier distinct, un document multipage utilise plusieurs crédits.

La section Account affiche toujours votre solde actuel, et **Get more** vous mène à la page des forfaits. L'utilisation du add-on ne génère ni ne consomme un type de crédit différent — un solde dépensé ici est le même solde que vous dépenseriez sur le site web. Les détails par forfait sont sur [Plans & Credits](/docs/guides/plans-and-points).

## Questions fréquentes

### Ai-je besoin d'un compte ou d'un abonnement séparé pour le add-on ?

Non. Le add-on se connecte au compte que vous possédez déjà, et il n'a pas de quota séparé. Tout forfait que vous détenez s'applique également ici.

### Verrai-je les mêmes fichiers et modèles que sur le site web ?

Oui. La liste Files, les modèles dans Data Columns et le solde de crédits proviennent tous de votre compte, donc un lot téléversé sur le site web peut être traité ici et les résultats insérés dans votre feuille de calcul.

### Dans quelle feuille les résultats sont-ils insérés ?

Celle qui est active lorsque vous insérez — l'onglet que vous avez sélectionné dans la feuille de calcul à laquelle le panneau latéral est attaché. Si vous insérez un nouveau jeu de colonnes, une ligne d'en-tête est ajoutée au-dessus des données.

### Que se passe-t-il si je manque de crédits ?

Le traitement ne démarre pas. Le panneau latéral indique combien de crédits vous avez et combien le lot nécessite, et vous permet d'en obtenir plus ou de traiter uniquement les fichiers couverts par votre solde. Voir [Plans & Credits](/docs/guides/plans-and-points).

---

Source: https://imagetotable.ai/fr/docs/guides/google-sheets-add-on