Productivité
Google Docs dans votre produit et vos agents IA, via une API
Le toolkit Google Docs couvre trois opérations sur les documents d'un compte Google : créer un document vierge, lire son titre et son contenu, et appliquer des modifications à son texte, y compris remplacer des marqueurs pour remplir un modèle. Avec Connect, votre produit ou agent IA les appelle par un seul endpoint, pendant que Connect stocke et renouvelle les identifiants OAuth et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/google_docs_create_document/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"title": "<title>"
}
}Fonctionnement
Du client connecté au premier appel à Google Docs.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Google Docs. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Google Docs.
Générer des documents depuis des données
Créez un Doc pour chaque proposition ou rapport produit par votre application, puis insérez le texte avec Update document dans le Drive du client.
Remplir des modèles
Utilisez replaceAllText pour remplacer des marqueurs, comme le nom d'un client ou une date, dans un document, sans calculer de positions.
Agent qui lit et modifie
Un agent IA lit un document avec Get document, comprend son texte et applique un lot de modifications qui réussit ou échoue en entier.
Tools
3 tools Google Docs
- Créer un documentPOSTCrée un Google Doc vierge à la racine de Mon Drive et le renvoie avec son documentId. Ajoutez le contenu ensuite avec Update document. Pour partir d'un modèle ou d'un dossier précis, copiez ou créez le fichier avec Google Drive.
- Obtenir un documentGETRécupère un document avec titre, revisionId et contenu. Le texte est dans body.content : chaque paragraphe a des elements dont textRun.content contient le texte, avec startIndex et endIndex que Update document utilise comme positions, comptées en unités de code UTF-16.
- Mettre à jour un documentPOSTApplique une liste de modifications à un document, dans l'ordre et en tout ou rien : si une requête est invalide, aucune n'est appliquée. Chaque élément de requests a exactement un type de modification. replaceAllText remplit un modèle sans positions ; les autres types utilisent les index de Get document. Envoyez les modifications avec des index du plus grand au plus petit, pour que l'une ne décale pas la suivante.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/google_docs, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Google Docs
Dois-je intégrer l'API Google Docs moi-même ?
Non. Connect fournit 3 tools Google Docs décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Google Docs ?
Avec le mode accepté par le toolkit : OAuth avec l'app de votre produit. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
