Créer un fichier avec l'API Google Drive
Cré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.
- Identifiant
- google_drive_create_file
L'appel
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>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| name | string | Non | Name of the new file or folder. Without it Google names it Untitled. |
| mimeType | string | Non | What to create: a folder, a Google Doc, a Google Sheet or a Google Slides presentation.Valeurs : application/vnd.google-apps.folder, application/vnd.google-apps.document, application/vnd.google-apps.spreadsheet, application/vnd.google-apps.presentation |
| parents | array | Non | The folder to create it in, as a one-item list with a folder id from List files. Without it the file goes to the top of My Drive. |
| description | string | Non | Short description of the file. |
| fields | string | Non | Fields to return, such as id,name,webViewLink. |
| supportsAllDrives | boolean | Non | Set to true when the folder in parents can be in a shared drive. |
Connexions possibles
Votre client connecte son compte Google Drive une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
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.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/google_drive_create_file. Il devient la définition de tool de votre agent sans conversion.
Autres 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.
- 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.
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.
