# 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, des Google Sheets 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&#39;adresse `https://api.gtx.dev/mcp` expose trois outils permettant de trouver les projets connectés, de lancer des traductions et d&#39;en suivre la progression par interrogation. Ces outils s&#39;appuient sur les mêmes connexions Google Drive et les mêmes copies traduites que l&#39;intégration du Dashboard, et prennent en charge les Google Docs, les Google Sheets et les Google Slides.

## 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 fichier Google Docs, Google Sheets ou Google Slides.                                  | `project:files:write` et `project:translations:enqueue` |
| [`get_google_drive_translation_status`](#drive-status) | Renvoie l&#39;avancement de la traduction, l&#39;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&#39;accès `drive.file` permet d&#39;atteindre les fichiers sélectionnés dans le Dashboard, mais elle doit être reconnectée avec un accès complet à Drive pour qu&#39;un outil puisse traduire un autre fichier.
* **API Key de projet :** la clé doit inclure les permissions requises par l&#39;outil, et le projet doit utiliser une connexion Organization shared drive.
* **Organization API key :** la clé doit inclure les permissions requises par l&#39;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&#39;un Google account personnel pour accéder à Drive. L&#39;Organization doit disposer de la fonctionnalité project integrations, et l&#39;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&#39;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&#39;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&#39;URL Docs, Sheets ou Slides. | `string`                         | Oui        | —                 |
| `hostApp` | Éditeur Google auquel appartient le fichier.                                           | `'DOCS' \| 'SLIDES' \| 'SHEETS'` | 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&#39;intégration.

### Renvoie

Le résultat comprend :

* `user.email`, qui peut valoir `null` et n&#39;indique pas si un Google account 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&#39;état de leur intégration.
* Le contexte des paramètres régionaux source et cible lorsque le fichier demandé est lié ou qu&#39;il s&#39;agit d&#39;une copie traduite gérée.

Les projets dont le mode de connexion n&#39;est pas utilisable par l&#39;appelant sont omis.

## `translate_google_drive_file` [#translate-drive-file]

**Mutation** · **Permissions** `project:files:write` et `project:translations:enqueue`

Synchronise un fichier Google Docs, Google Sheets ou Google Slides, importe les modifications apportées aux copies traduites existantes, met en file d&#39;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`     | Identifiant de projet renvoyé par `get_google_drive_context`.                                                                                                                  | `string`                         | Non        | —                                                            |
| `fileId`        | ID du fichier Google Drive figurant dans l&#39;URL Docs, Sheets ou Slides après `/d/`.                                                                                | `string`                         | Non        | —                                                            |
| `hostApp`       | Éditeur Google propriétaire du fichier.                                                                                                                               | `'DOCS' \| 'SLIDES' \| 'SHEETS'` | Non        | —                                                            |
| `targetLocales` | De 1 à 100 codes de paramètres régionaux pris en charge. Si le projet dispose d&#39;une liste des paramètres régionaux autorisés, chaque code doit y figurer. | `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&#39;outil résout sa source d&#39;origine et n&#39;utilise que le paramètre régional cible de cette copie. Le paramètre régional source de cette source d&#39;origine prévaut également sur `sourceLocale`.

L&#39;outil ignore tout code cible strictement identique à la source résolue. La requête échoue avant toute mise en file d&#39;attente s&#39;il ne reste aucune cible, ou si une cible est un code plus général ou plus spécifique de la langue source, comme `en` et `en-GB`. Pour traduire d&#39;une variante à une autre, utilisez deux codes qui diffèrent par la région ou le système d&#39;écriture, comme `en-US` et `en-GB`.

### Renvoie

Le résultat contient `accepted`, le `sourceLocale` et les `targetLocales` résolus, les décomptes dans `enqueued` et `failed`, ainsi qu&#39;un tableau `errors`. Examinez ces trois champs de résultat, car un paramètre régional cible peut échouer alors que d&#39;autres sont mis en file d&#39;attente.

Les erreurs de validation des paramètres régionaux font échouer l&#39;ensemble de la requête au lieu de renvoyer ce résultat.

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&#39;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` | Identifiant de projet renvoyé par `get_google_drive_context`.                              | `string`                         | Non        | —                 |
| `fileId`    | ID du fichier Google Drive, issu de l&#39;URL Docs, Sheets ou Slides après `/d/`. | `string`                         | Non        | —                 |
| `hostApp`   | Éditeur Google auquel appartient le fichier.                                      | `'DOCS' \| 'SLIDES' \| 'SHEETS'` | Non        | —                 |

### Renvoie

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&#39;un booléen `done`. Seul Google Slides comporte une passe de mise en page ; `layoutProgress` reste donc `null` pour Google Docs et Google Sheets. Dès qu&#39;une copie gérée est disponible, `targetCopy` contient l&#39;ID du fichier Google Drive ainsi qu&#39;une URL qui l&#39;ouvre dans l&#39;éditeur indiqué par `hostApp`.

Lorsque `fileId` désigne une copie traduite gérée, l&#39;outil résout sa source et renvoie l&#39;état pour le paramètre régional cible de cette copie.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
