# General Translation Integrations: Herramientas MCP de Google Drive URL: https://generaltranslation.com/es/docs/integrations/google-drive/reference/mcp-tools.mdx Docs index: https://generaltranslation.com/llms.txt Description: Traduce Google Docs y Google Slides mediante el MCP server alojado y autenticado. Referencia de API de las herramientas MCP de Google Drive. El servidor alojado en `https://api.gtx.dev/mcp` expone tres herramientas para buscar Projects conectados, iniciar traducciones y sondear su progreso. Estas herramientas utilizan las mismas conexiones de Google Drive y las mismas copias traducidas que la integración del Dashboard. ## Overview [#overview] | Herramienta | Description | Permission | | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | | [Autenticación y acceso](#access) | Elige las credenciales y un modo de conexión con Google Drive. | — | | [`get_google_drive_context`](#drive-context) | Enumera los Projects conectados a los que tienes acceso y resuelve el contexto de archivo opcional. | `project:files:read` | | [`translate_google_drive_file`](#translate-drive-file) | Sincroniza y traduce un Google Doc o una presentación de Google Slides. | `project:files:write` y `project:translations:enqueue` | | [`get_google_drive_translation_status`](#drive-status) | Devuelve el progreso de la traducción, el progreso de la maquetación y las URL de las copias traducidas. | `project:files:read` | ## Autenticación y acceso [#access] Conéctate al [MCP server alojado](/docs/overview/for-coding-agents#mcp) con OAuth o una clave de API admitida: * **OAuth:** las herramientas pueden usar tu Google account personal vinculada o la conexión con la unidad compartida de Organization del Project. Una conexión personal legacy que solo tenga acceso `drive.file` puede llegar a los archivos seleccionados en el Dashboard, pero debe volver a conectarse con acceso completo a Drive para que una herramienta pueda traducir otro archivo. * **Clave de API de Project de Production o de desarrollo:** la clave debe incluir los permisos que exige la herramienta, y el Project debe usar una conexión con una unidad compartida de Organization. * **Clave de API de Organization:** la clave debe incluir los permisos que exige la herramienta y apuntar a un Project que use una conexión con una unidad compartida de Organization. * **Locadex:** el Project debe usar una conexión con una unidad compartida de Organization. Quien haga la llamada con una clave de API no puede usar una Google account personal para acceder a Drive. La Organization necesita la funcionalidad de project integrations, y el acceso a la unidad compartida de Organization requiere además su propia funcionalidad Enterprise. Configura ambos modos de conexión en la [referencia de Connection](/docs/integrations/google-drive/reference/connection). Las llamadas de MCP y de la API aplican el permiso indicado para cada herramienta. Las acciones sobre archivos en el Dashboard requieren `project:files:write` y `project:translations:enqueue`, mientras que la página comprueba por separado `translations:content:write` antes de mostrar los controles de la cuenta personal. ## `get_google_drive_context` [#drive-context] **Solo lectura** · **Permiso** `project:files:read` Llama primero a esta herramienta para listar los Projects a los que puede acceder la credencial actual y obtener sus project IDs y su configuración regional. También puedes resolver el contexto de origen y de configuración regional de un archivo de Google Drive. ### Entradas | Nombre | Descripción | Tipo | Opcional | Predeterminado | | --------- | --------------------------------------------------------------------------------------- | -------------------- | -------- | -------------- | | `fileId` | ID del archivo de Google Drive que aparece en la URL de Docs o Slides después de `/d/`. | `string` | Sí | — | | `hostApp` | Editor de Google al que pertenece el archivo. | `'DOCS' \| 'SLIDES'` | Sí | — | Omite ambas entradas para listar los projects conectados. Proporciona ambas para inspeccionar un source file o una copia traducida gestionada por la integration. ### Devuelve El resultado incluye: * `linked` y `user.email`; actualmente las respuestas correctas devuelven `linked: true`, y `user.email` puede ser `null`. Ninguno de los dos campos indica si hay una cuenta personal de Google conectada. * Las configuraciones regionales admitidas. * Los Projects accesibles con sus ID, nombres, configuraciones regionales de origen predeterminadas, configuraciones regionales actuales, allowlists de locales y estado de la integración. * El contexto de la configuración regional de origen y de destino cuando el archivo solicitado está vinculado o es una copia traducida gestionada. Se omiten los Projects cuyo modo de conexión no puede utilizar quien realiza la llamada. ## `translate_google_drive_file` [#translate-drive-file] **Mutación** · **Permisos** `project:files:write` y `project:translations:enqueue` Sincroniza un Google Doc o una presentación de Google Slides, importa las ediciones de las copias traducidas existentes, encola el trabajo de traducción y aplica las traducciones completadas a las copias gestionadas. ### Entradas | Nombre | Descripción | Tipo | Opcional | Predeterminado | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | -------- | -------------------------------------------------------------- | | `projectId` | ID del Project devuelto por `get_google_drive_context`. | `string` | No | — | | `fileId` | ID del archivo de Google Drive que aparece en la URL de Docs o Slides después de `/d/`. | `string` | No | — | | `hostApp` | Editor de Google al que pertenece el archivo. | `'DOCS' \| 'SLIDES'` | No | — | | `targetLocales` | De uno a 100 códigos de configuración regional del Project. | `string[]` | No | — | | `sourceLocale` | Configuración regional de origen. Recurre a la configuración regional almacenada del archivo y, después, a la predeterminada del Project. | `string` | Sí | Configuración regional almacenada o predeterminada del Project | | `force` | Vuelve a traducir el contenido existente en lugar de reutilizarlo. | `boolean` | Sí | `false` | Cuando `fileId` identifica una copia traducida gestionada, la herramienta resuelve su origen original y usa únicamente la configuración regional de destino de esa copia. Su configuración regional de origen original también reemplaza a `sourceLocale`. ### Devuelve El resultado contiene `accepted`, el `sourceLocale` y los `targetLocales` resueltos, los conteos en `enqueued` y `failed`, y un array `errors`. Revisa los tres campos de resultado, ya que una configuración regional de destino puede fallar mientras otras quedan en cola. Esta herramienta puede consumir créditos de traducción y actualizar copias traducidas existentes. La traducción forzada puede sobrescribir el texto traducido y los cambios de maquetación. ## `get_google_drive_translation_status` [#drive-status] **Solo lectura** · **Permiso** `project:files:read` Consulta esta herramienta de forma periódica después de `translate_google_drive_file` para ver el progreso de la traducción y de la maquetación de cada configuración regional solicitada. ### Entradas | Nombre | Descripción | Tipo | Opcional | Predeterminado | | ----------- | --------------------------------------------------------------------------------------- | -------------------- | -------- | -------------- | | `projectId` | ID del Project devuelto por `get_google_drive_context`. | `string` | No | — | | `fileId` | ID del archivo de Google Drive que aparece en la URL de Docs o Slides después de `/d/`. | `string` | No | — | | `hostApp` | Editor de Google al que pertenece el archivo. | `'DOCS' \| 'SLIDES'` | No | — | ### Devuelve Cada resultado de configuración regional contiene sus detalles de configuración regional, los valores anulables `translationProgress` y `layoutProgress`, y un booleano `done`. Cuando haya una copia gestionada disponible, `targetCopy` contendrá el ID de archivo de Google Drive y la URL correspondientes. Cuando `fileId` identifica una copia traducida gestionada, la herramienta resuelve su fuente y devuelve el estado de la configuración regional de destino de esa copia. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.