# General Translation Integrations: Google Drive MCP ツール URL: https://generaltranslation.com/ja/docs/integrations/google-drive/reference/mcp-tools.mdx Docs index: https://generaltranslation.com/llms.txt Description: 認証済みのホスト型 MCP サーバー経由で Google Docs と Google Slides を翻訳します。Google Drive MCP ツールの API リファレンス。 `https://api.gtx.dev/mcp` でホストされているサーバーは、接続済みプロジェクトの検索、翻訳の開始、進行状況のポーリングを行う 3 つのツールを公開しています。これらのツールは、ダッシュボードのインテグレーションと同じ Google Drive 接続および翻訳済みコピーを使用します。 ## 概要 [#overview] | ツール | 説明 | 権限 | | ------------------------------------------------------ | -------------------------------------------------------- | ------------------------------------------------------ | | [認証とアクセス](#access) | 認証情報と Google Drive の接続モードを選択します。 | — | | [`get_google_drive_context`](#drive-context) | アクセス可能な接続済みプロジェクトを一覧表示し、任意のファイルコンテキストを解決します。 | `project:files:read` | | [`translate_google_drive_file`](#translate-drive-file) | Google ドキュメントまたは Google Slides のプレゼンテーションを 1 つ同期して翻訳します。 | `project:files:write` と `project:translations:enqueue` | | [`get_google_drive_translation_status`](#drive-status) | 翻訳の進捗、レイアウトの進捗、翻訳済みコピーの URL を返します。 | `project:files:read` | ## 認証とアクセス [#access] OAuth または許可された API キーを使用して、[ホスト型 MCP サーバー](/docs/overview/for-coding-agents#mcp) に接続します。 * **OAuth:** ツールは、連携済みの個人 Google アカウント、またはプロジェクトの Organization 共有ドライブ接続を利用できます。`drive.file` アクセスのみを持つ従来型の個人接続でも、ダッシュボードで選択したファイルにはアクセスできますが、ツールで別のファイルを翻訳するには、完全な Drive アクセス権で再接続する必要があります。 * **本番環境または開発環境のプロジェクト API キー:** キーにはツールが要求する権限が含まれている必要があり、プロジェクトは Organization 共有ドライブ接続を使用している必要があります。 * **Organization API キー:** キーにはツールが要求する権限が含まれている必要があり、かつ Organization 共有ドライブ接続を使用しているプロジェクトを対象とする必要があります。 * **Locadex:** プロジェクトが Organization 共有ドライブ接続を使用している必要があります。 API キーによる呼び出し元は、Drive アクセスに個人 Google アカウントを使用できません。Organization にはプロジェクトインテグレーション機能が必要で、Organization 共有ドライブへのアクセスにはさらに別途 Enterprise 機能が必要です。いずれの接続モードも [接続リファレンス](/docs/integrations/google-drive/reference/connection) で設定してください。 MCP および API 呼び出しでは、各ツールに記載された権限が適用されます。ダッシュボードのファイル操作には `project:files:write` と `project:translations:enqueue` が必要で、これとは別に、ページ側では個人アカウント用のコントロールを表示する前に `translations:content:write` を確認します。 ## `get_google_drive_context` [#drive-context] **読み取り専用** · **権限** `project:files:read` まずこのツールを呼び出して、現在のクレデンシャルでアクセスできるプロジェクトを一覧表示し、それぞれのプロジェクト ID とロケール設定を取得してください。Google Drive ファイルのソースおよびロケールのコンテキストを解決することもできます。 ### 入力 | 名前 | 説明 | 型 | 任意 | デフォルト | | --------- | ---------------------------------------------------------- | -------------------- | -- | ----- | | `fileId` | Docs または Slides の URL の `/d/` 以降にある Google Drive のファイル ID。 | `string` | はい | — | | `hostApp` | ファイルを所有する Google のエディタ。 | `'DOCS' \| 'SLIDES'` | はい | — | 両方の入力を省略すると、接続済みのプロジェクトが一覧表示されます。両方を指定すると、インテグレーションが管理するソースファイルまたは翻訳済みコピーを確認できます。 ### 戻り値 結果には次の内容が含まれます。 * `linked` と `user.email`。成功時のレスポンスでは現在 `linked: true` が返され、`user.email` は `null` になる場合があります。どちらのフィールドも、個人の Google アカウントが接続されているかどうかを示すものではありません。 * サポートされているロケール。 * アクセス可能なプロジェクトとその ID、名前、デフォルトのソースロケール、現在のロケール、ロケールの許可リスト、インテグレーションのステータス。 * リクエストされたファイルがリンクされている場合、または管理対象の翻訳済みコピーである場合の、ソースロケールおよび対象ロケールのコンテキスト。 呼び出し元が利用できない接続モードのプロジェクトは省略されます。 ## `translate_google_drive_file` [#translate-drive-file] **変更あり** · **権限** `project:files:write` および `project:translations:enqueue` Google ドキュメントまたは Google Slides のプレゼンテーションを同期し、既存の翻訳済みコピーから編集内容を取り込み、翻訳処理をキューに追加して、完了した翻訳を管理対象のコピーに適用します。 ### Inputs | 名前 | 説明 | 型 | 任意 | Default | | --------------- | --------------------------------------------------------- | -------------------- | --- | ---------------------- | | `projectId` | `get_google_drive_context` が返すプロジェクト ID。 | `string` | いいえ | — | | `fileId` | Docs または Slides の URL の `/d/` 以降にある Google Drive ファイル ID。 | `string` | いいえ | — | | `hostApp` | ファイルを所有する Google のエディタ。 | `'DOCS' \| 'SLIDES'` | いいえ | — | | `targetLocales` | 1〜100 個のプロジェクトのロケールコード。 | `string[]` | いいえ | — | | `sourceLocale` | ソースロケール。保存されたファイルのロケール、次にプロジェクトの既定値にフォールバックします。 | `string` | はい | 保存されたロケールまたはプロジェクトの既定値 | | `force` | 既存のコンテンツを再利用せず、再翻訳します。 | `boolean` | はい | `false` | `fileId` が管理対象の翻訳済みコピーを指している場合、このツールはその元のソースを解決し、そのコピーの対象ロケールのみを使用します。また、元のソースロケールが `sourceLocale` よりも優先されます。 ### 戻り値 結果には `accepted`、解決された `sourceLocale` と `targetLocales`、`enqueued` と `failed` の件数、そして `errors` 配列が含まれます。一部の対象ロケールが失敗しても、他のロケールはキューに入る場合があるため、これら3つの結果フィールドをすべて確認してください。 このツールは翻訳クレジットを消費し、既存の翻訳済みコピーを更新する場合があります。強制翻訳を行うと、翻訳済みのテキストやレイアウトの変更が上書きされる可能性があります。 ## `get_google_drive_translation_status` [#drive-status] **読み取り専用** · **権限** `project:files:read` `translate_google_drive_file` の実行後にこのツールをポーリングして、リクエストした各ロケールの翻訳とレイアウトの進捗状況を確認します。 ### 入力 | 名前 | 説明 | 型 | 任意 | デフォルト | | ----------- | ---------------------------------------------------------- | -------------------- | --- | ----- | | `projectId` | `get_google_drive_context` が返すプロジェクト ID。 | `string` | いいえ | — | | `fileId` | Docs または Slides の URL の `/d/` 以降にある Google Drive のファイル ID。 | `string` | いいえ | — | | `hostApp` | ファイルを所有する Google のエディタ。 | `'DOCS' \| 'SLIDES'` | いいえ | — | ### 戻り値 各ロケールの結果には、そのロケールの詳細、null を取り得る `translationProgress` と `layoutProgress` の値、および `done` ブール値が含まれます。管理対象のコピーが利用可能になると、`targetCopy` にその Google Drive のファイル ID と URL が設定されます。 `fileId` が管理対象の翻訳済みコピーを指している場合、このツールはそのソースを解決し、当該コピーの対象ロケールのステータスを返します。 ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.