# General Translation Integrations: Outils MCP Google Drive URL: https://generaltranslation.com/fr/docs/integrations/google-drive/reference/mcp-tools.mdx Docs index: https://generaltranslation.com/llms.txt Description: Traduisez des Google Docs et des Google Slides via le MCP server hébergé et authentifié. Référence d'API pour les outils MCP Google Drive. Le serveur hébergé à l'adresse `https://api.gtx.dev/mcp` expose trois outils permettant de trouver les projets connectés, de lancer des traductions et d'en suivre la progression par interrogation. Ces outils s'appuient sur les mêmes connexions Google Drive et les mêmes copies traduites que l'intégration du Dashboard. ## Aperçu [#overview] | Outil | Description | Permission | | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | | [Authentification et accès](#access) | Choisissez des credentials et un mode de connexion Google Drive. | — | | [`get_google_drive_context`](#drive-context) | Liste les projets connectés accessibles et résout le contexte de fichier facultatif. | `project:files:read` | | [`translate_google_drive_file`](#translate-drive-file) | Synchronise et traduit un Google Doc ou une présentation Google Slides. | `project:files:write` et `project:translations:enqueue` | | [`get_google_drive_translation_status`](#drive-status) | Renvoie l'avancement de la traduction, l'avancement de la mise en page et les URL des copies traduites. | `project:files:read` | ## Authentification et accès [#access] Connectez-vous au [MCP server hébergé](/docs/overview/for-coding-agents#mcp) avec OAuth ou une API Key acceptée : * **OAuth :** les outils peuvent utiliser votre Google account personnel lié ou la connexion Organization shared drive du projet. Une connexion personnelle legacy disposant uniquement de l'accès `drive.file` permet d'atteindre les fichiers sélectionnés dans le Dashboard, mais elle doit être reconnectée avec un accès complet à Drive pour qu'un outil puisse traduire un autre fichier. * **API Key de projet Production ou development :** la clé doit inclure les permissions requises par l'outil, et le projet doit utiliser une connexion Organization shared drive. * **Organization API key :** la clé doit inclure les permissions requises par l'outil et cibler un projet qui utilise une connexion Organization shared drive. * **Locadex :** le projet doit utiliser une connexion Organization shared drive. Un appelant utilisant une API Key ne peut pas se servir d'un Google account personnel pour accéder à Drive. L'Organization doit disposer de la fonctionnalité project integrations, et l'accès Organization shared drive requiert en outre sa propre fonctionnalité Enterprise. Configurez les deux modes de connexion dans la [référence Connection](/docs/integrations/google-drive/reference/connection). Les appels MCP et API appliquent la permission indiquée pour chaque outil. Les actions sur les fichiers dans le Dashboard nécessitent `project:files:write` et `project:translations:enqueue`, tandis que la page vérifie séparément `translations:content:write` avant d'afficher les controls du compte personnel. ## `get_google_drive_context` [#drive-context] **Lecture seule** · **Permission** `project:files:read` Appelez cet outil en premier pour lister les projets auxquels le credential actuel a accès et obtenir leurs project IDs ainsi que leurs paramètres régionaux. Vous pouvez également résoudre le context de source et de paramètre régional d'un fichier Google Drive. ### Entrées | Nom | Description | Type | Facultatif | Valeur par défaut | | --------- | --------------------------------------------------------------------------------------- | -------------------- | ---------- | ----------------- | | `fileId` | ID du fichier Google Drive figurant après `/d/` dans l'URL Docs ou Slides. | `string` | Oui | — | | `hostApp` | Éditeur Google auquel appartient le fichier. | `'DOCS' \| 'SLIDES'` | Oui | — | Omettez les deux entrées pour lister les projets connectés. Renseignez-les toutes les deux pour inspecter un fichier source ou une copie traduite gérée par l'intégration. ### Returns Le résultat comprend : * `linked` et `user.email` ; les réponses réussies renvoient actuellement `linked: true`, et `user.email` peut valoir `null`. Aucun de ces deux champs n'indique si un compte Google personnel est connecté. * Les paramètres régionaux pris en charge. * Les projets accessibles, avec leurs identifiants, leurs noms, leurs paramètres régionaux sources par défaut, leurs paramètres régionaux actuels, leurs listes des paramètres régionaux autorisés et l'état de leur intégration. * Le contexte des paramètres régionaux source et cible lorsque le fichier demandé est lié ou qu'il s'agit d'une copie traduite gérée. Les projets dont le mode de connexion n'est pas utilisable par l'appelant sont omis. ## `translate_google_drive_file` [#translate-drive-file] **Mutation** · **Permissions** `project:files:write` et `project:translations:enqueue` Synchronise un Google Doc ou une présentation Google Slides, importe les modifications apportées aux copies traduites existantes, met en file d'attente le travail de traduction et applique les traductions terminées aux copies gérées. ### Entrées | Nom | Description | Type | Facultatif | Valeur par défaut | | --------------- | -------------------------------------------------------------------------------------------------------------------------- | -------------------- | ---------- | ------------------------------------------------------------ | | `projectId` | ID de projet renvoyé par `get_google_drive_context`. | `string` | Non | — | | `fileId` | ID du fichier Google Drive figurant dans l'URL Docs ou Slides après `/d/`. | `string` | Non | — | | `hostApp` | Éditeur Google propriétaire du fichier. | `'DOCS' \| 'SLIDES'` | Non | — | | `targetLocales` | De 1 à 100 codes de langue du projet. | `string[]` | Non | — | | `sourceLocale` | Paramètre régional source. Se replie sur le paramètre régional enregistré du fichier, puis sur celui par défaut du projet. | `string` | Oui | Paramètre régional enregistré ou valeur par défaut du projet | | `force` | Retraduit le contenu existant au lieu de le réutiliser. | `boolean` | Oui | `false` | Lorsque `fileId` désigne une copie traduite gérée, l'outil résout sa source d'origine et n'utilise que le paramètre régional cible de cette copie. Le paramètre régional source de cette source d'origine prévaut également sur `sourceLocale`. ### Returns Le résultat contient `accepted`, le `sourceLocale` et les `targetLocales` résolus, les décomptes dans `enqueued` et `failed`, ainsi qu'un tableau `errors`. Examinez ces trois champs de résultat, car un paramètre régional cible peut échouer alors que d'autres sont mis en file d'attente. Cet outil peut consommer des crédits de traduction et mettre à jour les copies traduites existantes. Une traduction forcée peut écraser le texte traduit ainsi que les modifications de mise en page. ## `get_google_drive_translation_status` [#drive-status] **Lecture seule** · **Permission** `project:files:read` Interrogez cet outil après `translate_google_drive_file` pour suivre l'avancement de la traduction et de la mise en page de chaque paramètre régional demandé. ### Entrées | Nom | Description | Type | Facultatif | Valeur par défaut | | ----------- | ------------------------------------------------------------------------- | -------------------- | ---------- | ----------------- | | `projectId` | ID du projet renvoyé par `get_google_drive_context`. | `string` | Non | — | | `fileId` | ID du fichier Google Drive, issu de l'URL Docs ou Slides après `/d/`. | `string` | Non | — | | `hostApp` | Éditeur Google auquel appartient le fichier. | `'DOCS' \| 'SLIDES'` | Non | — | ### Returns Chaque résultat de paramètre régional contient les détails du paramètre régional, les valeurs `translationProgress` et `layoutProgress` (pouvant être nulles), ainsi qu'un booléen `done`. Dès qu'une copie gérée est disponible, `targetCopy` contient l'ID du fichier Google Drive et l'URL de celle-ci. Lorsque `fileId` désigne une copie traduite gérée, l'outil résout sa source et renvoie l'état pour le paramètre régional cible de cette copie. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.