# General Translation Integrations: Strumenti MCP di Google Drive URL: https://generaltranslation.com/it/docs/integrations/google-drive/reference/mcp-tools.mdx Docs index: https://generaltranslation.com/llms.txt Description: Traduci Google Docs e Google Slides tramite il server MCP ospitato e autenticato. API reference per gli strumenti MCP di Google Drive. Il server ospitato all'indirizzo `https://api.gtx.dev/mcp` espone tre strumenti per individuare i progetti collegati, avviare le traduzioni ed eseguire il polling del loro avanzamento. Questi strumenti utilizzano le stesse connessioni Google Drive e le stesse copie tradotte dell'integrazione della Dashboard. ## Panoramica [#overview] | Strumento | Descrizione | Permesso | | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------ | | [Autenticazione e accesso](#access) | Scegli le credenziali e una modalità di connessione a Google Drive. | — | | [`get_google_drive_context`](#drive-context) | Elenca i progetti collegati accessibili e risolve il contesto facoltativo del file. | `project:files:read` | | [`translate_google_drive_file`](#translate-drive-file) | Sincronizza e traduce un Google Doc o una presentazione Google Slides. | `project:files:write` e `project:translations:enqueue` | | [`get_google_drive_translation_status`](#drive-status) | Restituisce l'avanzamento della traduzione, l'avanzamento del layout e gli URL delle copie tradotte. | `project:files:read` | ## Autenticazione e accesso [#access] Connettiti al [server MCP ospitato](/docs/overview/for-coding-agents#mcp) tramite OAuth o una chiave API supportata: * **OAuth:** gli strumenti possono usare il tuo account Google personale collegato oppure la connessione al Drive condiviso dell'Organization del progetto. Una connessione personale legacy con il solo accesso `drive.file` può raggiungere i file selezionati dalla Dashboard, ma deve essere ricollegata con accesso completo a Drive prima che uno strumento possa tradurre un altro file. * **Chiave API di progetto di produzione o di sviluppo:** la chiave deve includere le autorizzazioni richieste dallo strumento e il progetto deve usare una connessione al Drive condiviso dell'Organization. * **Chiave API dell'Organization:** la chiave deve includere le autorizzazioni richieste dallo strumento e puntare a un progetto che usa una connessione al Drive condiviso dell'Organization. * **Locadex:** il progetto deve usare una connessione al Drive condiviso dell'Organization. Un chiamante che usa una chiave API non può usare un account Google personale per accedere a Drive. L'Organization deve disporre della funzionalità project integrations e l'accesso al Drive condiviso dell'Organization richiede anche la relativa funzionalità Enterprise separata. Configura entrambe le modalità di connessione nella [Reference sulla connessione](/docs/integrations/google-drive/reference/connection). Le chiamate MCP e API applicano il permesso indicato per ciascuno strumento. Le azioni sui file nella Dashboard richiedono `project:files:write` e `project:translations:enqueue`, mentre la pagina verifica separatamente `translations:content:write` prima di mostrare i controls dell'account personale. ## `get_google_drive_context` [#drive-context] **Sola lettura** · **Permesso** `project:files:read` Chiama questo strumento per primo per elencare i progetti a cui la credenziale corrente può accedere e ottenere i relativi ID progetto e impostazioni regionali. Puoi anche risolvere il contesto di sorgente e impostazione regionale di un file di Google Drive. ### Input | Nome | Description | Type | Optional | Default | | --------- | ------------------------------------------------------------------------------ | -------------------- | -------- | ------- | | `fileId` | ID del file di Google Drive presente nell'URL di Docs o Slides dopo `/d/`. | `string` | Sì | — | | `hostApp` | Editor di Google proprietario del file. | `'DOCS' \| 'SLIDES'` | Sì | — | Ometti entrambi gli input per elencare i progetti collegati. Forniscili entrambi per esaminare un file sorgente o una copia tradotta gestita dall'integrazione. ### Returns Il risultato include: * `linked` e `user.email`; attualmente le risposte con esito positivo restituiscono `linked: true`, mentre `user.email` può essere `null`. Nessuno dei due campi indica se è collegato un account Google personale. * Le impostazioni regionali supportate. * I progetti accessibili con i relativi ID, nomi, impostazioni regionali sorgente predefinite, impostazioni regionali attuali, allowlist di impostazioni regionali e stato dell'integrazione. * Il contesto delle impostazioni regionali sorgente e di destinazione quando il file richiesto è collegato oppure è una copia tradotta gestita. I progetti la cui modalità di connessione non è utilizzabile dal chiamante vengono omessi. ## `translate_google_drive_file` [#translate-drive-file] **Mutazione** · **Autorizzazioni** `project:files:write` e `project:translations:enqueue` Sincronizza un Google Doc o una presentazione Google Slides, importa le modifiche dalle copie tradotte esistenti, accoda il lavoro di traduzione e applica le traduzioni completate alle copie gestite. ### Input | Nome | Descrizione | Tipo | Facoltativo | Predefinito | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | ----------- | ------------------------------------------------------------- | | `projectId` | ID progetto restituito da `get_google_drive_context`. | `string` | No | — | | `fileId` | ID del file di Google Drive presente nell'URL di Docs o Slides dopo `/d/`. | `string` | No | — | | `hostApp` | Editor Google proprietario del file. | `'DOCS' \| 'SLIDES'` | No | — | | `targetLocales` | Da 1 a 100 codici locale del progetto. | `string[]` | No | — | | `sourceLocale` | Impostazione regionale sorgente. Ricade sull'impostazione regionale memorizzata del file e, in seconda battuta, su quella predefinita del progetto. | `string` | Sì | Impostazione regionale memorizzata o predefinita del progetto | | `force` | Ritraduce i contenuti esistenti invece di riutilizzarli. | `boolean` | Sì | `false` | Quando `fileId` identifica una copia tradotta gestita, lo strumento risolve la sorgente originale corrispondente e utilizza soltanto l'impostazione regionale di destinazione di quella copia. Inoltre, l'impostazione regionale sorgente originale prevale su `sourceLocale`. ### Returns Il risultato contiene `accepted`, i valori risolti di `sourceLocale` e `targetLocales`, i conteggi in `enqueued` e `failed` e un array `errors`. Esamina tutti e tre i campi di esito, perché un'impostazione regionale di destinazione può fallire mentre le altre vengono messe in coda. Questo strumento può consumare crediti di traduzione e aggiornare le copie tradotte esistenti. La traduzione forzata può sovrascrivere il testo tradotto e le modifiche al layout. ## `get_google_drive_translation_status` [#drive-status] **Sola lettura** · **Permesso** `project:files:read` Esegui il polling di questo strumento dopo `translate_google_drive_file` per verificare l'avanzamento della traduzione e del layout per ogni impostazione regionale richiesta. ### Input | Nome | Descrizione | Tipo | Facoltativo | Predefinito | | ----------- | ------------------------------------------------------------------------------ | -------------------- | ----------- | ----------- | | `projectId` | ID progetto restituito da `get_google_drive_context`. | `string` | No | — | | `fileId` | ID del file di Google Drive presente nell'URL di Docs o Slides dopo `/d/`. | `string` | No | — | | `hostApp` | Editor Google a cui appartiene il file. | `'DOCS' \| 'SLIDES'` | No | — | ### Returns Ogni risultato per impostazione regionale contiene i dettagli della relativa impostazione regionale, i valori nullable `translationProgress` e `layoutProgress` e un booleano `done`. Quando una copia gestita è disponibile, `targetCopy` contiene l'ID e l'URL del relativo file su Google Drive. Quando `fileId` identifica una copia tradotta gestita, lo strumento ne risolve la sorgente e restituisce lo status dell'impostazione regionale di destinazione di quella copia. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.