Fichiers
Google Drive dans votre produit et vos agents IA, via une API
Le toolkit Google Drive couvre fichiers et dossiers, drives partagés, autorisations et commentaires. Votre produit ou agent IA les appelle via Connect, qui gère la connexion OAuth du client et journalise chaque exécution, sans que vous construisiez l'intégration.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/google_drive_create_file/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}Fonctionnement
Du client connecté au premier appel à Google Drive.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Google Drive. 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 Drive.
Dossiers de rapports par client
Un outil d'agence copie un modèle de rapport dans le dossier du client et le partage avec les bonnes personnes via les autorisations.
Relecture de documents partagés
Un SaaS liste les commentaires d'un Google Doc en relecture et ajoute le sien quand une étape du workflow se termine.
Agent qui retrouve des fichiers
Un agent IA recherche des fichiers par nom ou type, lit leurs métadonnées et webViewLink, et les déplace ou renomme à la demande.
Tools
12 tools Google Drive
- Lister les fichiersGETRecherche les fichiers et dossiers que le compte peut voir. Chaque fichier ne contient que id, name et mimeType, sauf si fields en demande plus, comme webViewLink et modifiedTime.
- Obtenir un fichierGETObtient les métadonnées d'un fichier ou dossier, pas le contenu. webViewLink est l'adresse qui l'ouvre dans le navigateur, et parents contient l'id du dossier où il se trouve.
- Créer un fichierPOSTCrée un fichier avec métadonnées seulement, sans contenu : un dossier, ou un Google Doc, Sheet ou présentation Slides vide, choisi par mimeType. Renvoie id, name et mimeType.
- Mettre à jour un fichierPATCHRenomme, décrit, met en favori, déplace ou met à la corbeille un fichier ou dossier ; seuls les champs envoyés changent. Pour déplacer, passez le nouveau dossier dans addParents.
- Copier un fichierPOSTCopie un fichier, comme un modèle de rapport, et renvoie le nouveau fichier. Sans parents la copie reste dans le même dossier que l'original. Les dossiers ne peuvent pas être copiés.
- Lister les drives partagésGETListe les drives partagés dont le compte est membre, avec id et name. L'id va dans driveId de Lister les fichiers. Passez nextPageToken comme pageToken pour la page suivante.
- Lister les autorisationsGETListe qui a accès à un fichier ou dossier. Sans fields chaque autorisation ne contient que des champs de base, comme id, type et role : demandez emailAddress et displayName pour en voir plus.
- Créer une autorisationPOSTPartage un fichier ou dossier et renvoie la nouvelle autorisation avec son id. Google envoie un e-mail aux utilisateurs et groupes, sauf si sendNotificationEmail vaut false.
- Mettre à jour une autorisationPATCHModifie le role ou l'expiration d'un accès existant et renvoie l'autorisation.
- Supprimer une autorisationDELETERetire un accès d'un fichier ou dossier : l'utilisateur, le groupe, le domaine ou le lien perd l'accès.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/google_drive, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Google Drive
Dois-je intégrer l'API Google Drive moi-même ?
Non. Connect fournit 12 tools Google Drive 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 Drive ?
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.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
