La v1 API s'adresse aux développeurs qui souhaitent exécuter l'extraction depuis leur propre code — une application, un script ou un pipeline back-office — au lieu de lancer chaque tâche depuis ce site. Il s'agit d'une interface différente de l'Google Sheets Add-on, qui couvre le cas des feuilles de calcul. Cette page explique qui peut utiliser l'API et où se trouve sa documentation ; la référence de l'API elle-même se trouve ailleurs.
À qui s'adresse l'API
Utilisez l'API lorsque les données extraites doivent arriver dans votre propre système plutôt que dans une feuille de calcul ou un fichier téléchargé. Elle permet à un programme de soumettre des documents, de lancer le traitement et de récupérer les résultats sans qu'une personne pilote l'application web pour chaque lot. Si vous avez seulement besoin de lignes extraites dans une feuille où vous travaillez déjà, l'Add-on Sheets est la voie la plus simple.
Ce qu'il vous faut avant de commencer
L'API est disponible sur tout plan payant, et non sur le plan Free. Un compte Free est refusé : les appels renvoient un message indiquant qu'un plan payant est requis, même avec une clé valide. Les plans éligibles sont :
- Basic, Pro ou Max — les plans payants personnels.
- Growth, Scale ou Enterprise — les plans d'équipe. Un membre d'équipe est couvert par le plan du propriétaire de l'équipe, donc un membre d'une équipe payante a accès à l'API via ce plan.
L'accès est vérifié à chaque appel, et une clé qui n'appartient pas à un compte actif est rejetée.
La clé elle-même est un identifiant de votre compte, créé et remplacé depuis votre page de profil. Consultez Gestion des clés API pour savoir où la trouver et comment la régénérer. Vous n'avez pas besoin d'une clé distincte pour l'API — la même clé connecte également le Google Sheets Add-on.
Où se trouve la documentation complète
Tout ce qui va au-delà de l'accès se trouve sur le site de documentation développeur, pas ici. Cela couvre les formats de requête et de réponse, les points de terminaison, les paramètres acceptés par chacun, et des exemples concrets. Commencez par :
- Vue d'ensemble de l'API — ce que couvre l'API et comment elle est organisée.
- Démarrage rapide de l'API — le chemin le plus court d'une clé à un premier résultat.
Cette page ne répète délibérément aucun de ces éléments.