# 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, Google Sheets e Google Slides tramite il server MCP ospitato e autenticato. API reference per gli strumenti MCP di Google Drive.

Il server ospitato all&#39;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&#39;integrazione della Dashboard e supportano Google Docs, Google Sheets e Google Slides.

## 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 singolo file di Google Docs, Google Sheets o Google Slides.                         | `project:files:write` e `project:translations:enqueue` |
| [`get_google_drive_translation_status`](#drive-status) | Restituisce l&#39;avanzamento della traduzione, l&#39;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&#39;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 del progetto:** la chiave deve includere le autorizzazioni richieste dallo strumento e il progetto deve usare una connessione al Drive condiviso dell&#39;Organization.
* **Chiave API dell&#39;Organization:** la chiave deve includere le autorizzazioni richieste dallo strumento e puntare a un progetto che usa una connessione al Drive condiviso dell&#39;Organization.
* **Locadex:** il progetto deve usare una connessione al Drive condiviso dell&#39;Organization.

Un chiamante che usa una chiave API non può usare un account Google personale per accedere a Drive. L&#39;Organization deve disporre della funzionalità project integrations e l&#39;accesso al Drive condiviso dell&#39;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&#39;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                                                                            | Tipo                             | facoltativo | Predefinito |
| --------- | -------------------------------------------------------------------------------------- | -------------------------------- | -------- | ------- |
| `fileId`  | ID del file di Google Drive presente nell&#39;URL di Docs, Sheets o Slides dopo `/d/`. | `string`                         | Sì       | —       |
| `hostApp` | Editor di Google proprietario del file.                                                | `'DOCS' \| 'SLIDES' \| 'SHEETS'` | Sì       | —       |

Ometti entrambi gli input per elencare i progetti collegati. Forniscili entrambi per esaminare un file sorgente o una copia tradotta gestita dall&#39;integrazione.

### Restituisce

Il risultato include:

* `user.email`, che può essere `null` e non 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, elenchi di impostazioni regionali consentite e stato dell&#39;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 file Google Docs, Google Sheets o 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&#39;URL di Docs, Sheets o Slides dopo `/d/`.                                                                     | `string`                         | No          | —                                                             |
| `hostApp`       | Editor Google proprietario del file.                                                                                                                       | `'DOCS' \| 'SLIDES' \| 'SHEETS'` | No          | —                                                             |
| `targetLocales` | Da 1 a 100 codici delle impostazioni locali supportati. Se il progetto prevede un elenco di impostazioni regionali consentite, ogni codice deve figurarvi. | `string[]`                       | No          | —                                                             |
| `sourceLocale`  | Impostazione regionale sorgente. Ricade sull&#39;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&#39;impostazione regionale di destinazione di quella copia. Inoltre, l&#39;impostazione regionale sorgente originale prevale su `sourceLocale`.

Lo strumento scarta qualsiasi codice di destinazione che corrisponda esattamente alla sorgente risolta. La richiesta non va a buon fine, prima ancora che venga accodato qualcosa, se non rimane alcuna destinazione oppure se una destinazione è un codice più generico o più specifico per la lingua di origine, come `en` ed `en-GB`. Per tradurre tra varianti, usa due codici che differiscono per regione o sistema di scrittura, come `en-US` ed `en-GB`.

### Restituisce

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&#39;impostazione regionale di destinazione può fallire mentre le altre vengono messe in coda.

Gli errori di convalida delle impostazioni regionali fanno fallire l&#39;intera richiesta anziché restituire questo risultato.

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&#39;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&#39;URL di Docs, Sheets o Slides dopo `/d/`. | `string`                         | No          | —           |
| `hostApp`   | Editor Google a cui appartiene il file.                                                | `'DOCS' \| 'SLIDES' \| 'SHEETS'` | No          | —           |

### Restituisce

Ogni risultato per impostazione regionale contiene i dettagli della relativa impostazione regionale, i valori nullable `translationProgress` e `layoutProgress` e un booleano `done`. Solo Google Slides prevede un passaggio di layout, quindi `layoutProgress` resta `null` per Google Docs e Google Sheets. Quando una copia gestita è disponibile, `targetCopy` contiene l&#39;ID del relativo file su Google Drive e un URL che lo apre nell&#39;editor indicato da `hostApp`.

Quando `fileId` identifica una copia tradotta gestita, lo strumento ne risolve la sorgente e restituisce lo stato dell&#39;impostazione regionale di destinazione di quella copia.

## Sitemap

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