Tutoriels vidéo
La vidéo est en anglais (voix off et sous-titres).
L'API v1 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 web. 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 collecter 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 tous les plans payants, 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 sur votre compte, créé et remplacé depuis votre page de profil. Voir 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é séparée 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. Elle couvre les formats de requête et de réponse, les endpoints, 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 volontairement aucun de ces contenus.