# General Translation Integrations: 接続
URL: https://generaltranslation.com/ja/docs/integrations/google-drive/reference/connection.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 個人の Google アカウントまたは Organization の共有ドライブを使用して、プロジェクトを Google Drive に接続します。Google Drive の接続モード、スコープ、権限に関するリファレンスです。

接続モードによって、インテグレーションで使用する識別情報、参照できるファイル、認可が必要なユーザーが決まります。どちらのモードも **プロジェクト > インテグレーション > カタログ** から接続できます。

## 概要 [#overview]

| トピック                                  | 説明                                  |
| ------------------------------------- | ----------------------------------- |
| [アクセスモード](#access-modes)              | 個人アカウント と Organization の共有ドライブ の接続。 |
| [個人アカウント](#personal-account)          | ユーザーが開けるファイルに対する OAuth 認可。          |
| [Organization の共有ドライブ](#shared-drive) | 管理者 が管理する共有 翻訳アカウント。   |
| [必要な Drive 権限](#capabilities)         | アクティブな 識別情報 に必要な Drive 上での操作権限。     |
| [プランと権限](#gating)                     | 接続と翻訳に必要な要件。                        |
| [モードの切り替え](#switching)                | プロジェクトが接続モードを変更できる条件。               |
| [接続を解除する](#disconnecting)                  | 認証情報 を削除した後も残るもの。                   |

## アクセスモード [#access-modes]

| モード                  | 識別情報                          | 利用可能なファイル                                           |
| -------------------- | ----------------------------- | --------------------------------------------------- |
| 個人アカウント              | 各ユーザーが自分の Google アカウントを認可します。 | そのユーザーが開ける Google Docs と Google Slides。             |
| Organization の共有ドライブ | Organization の翻訳アカウント 1 つ。    | 翻訳アカウントが含まれている共有ドライブ内の Google Docs と Google Slides。 |

Dashboard で使用するモードを尋ねられるのは、Organization に共有ドライブへのアクセスを含むプランで、確認済みかつアクティブな共有ドライブ接続がある場合のみです。それ以外の場合、プロジェクトでは個人アカウントが使用されます。

## 個人アカウント [#personal-account]

各ユーザーはインテグレーションの管理ページで **アカウントを接続** をクリックし、Google の認可を完了します。インテグレーションは以下をリクエストします。

* `openid`
* `https://www.googleapis.com/auth/drive`

Drive の完全なスコープにより、インテグレーションは Dashboard で選択したファイルだけでなく、Google Docs や Google Slides のアドオンから開いたドキュメントにもアクセスできます。インテグレーションが翻訳するのは、これらのサーフェスで選択または明示的に開いたサポート対象のファイルのみです。

このスコープ変更より前に作成された接続は、より狭い `https://www.googleapis.com/auth/drive.file` の許可を保持している場合があります。それらの接続は Dashboard で選択したファイルについては引き続き機能しますが、アドオンから開いた別のドキュメントを翻訳する際には再接続を求められます。接続を利用できるのは、Google からサポート対象の Drive スコープとリフレッシュトークンが返された場合のみです。

## Organization の共有ドライブ [#shared-drive]

管理者は、**Organization > Connections** からこの接続を一度だけ設定します。**Add connection** をクリックし、Google Drive の **Set up** をクリックします。Dashboard で翻訳アカウントがプロビジョニングされ、そのメールアドレスが表示されます。許可する各共有ドライブにそのメールアドレスを **Content manager** として追加し、Dashboard に戻って **Verify access** をクリックします。

翻訳アカウントは `https://www.googleapis.com/auth/drive` スコープを使用するため、設定済みの共有ドライブを参照できます。プロジェクトがこのモードを選択できるのは、接続が **Active** の場合のみです。

このモードで追加するファイルは、共有ドライブ内に配置する必要があります。**My Drive** 内のファイルは受け付けられません。

## 必要な Drive 権限 [#capabilities]

アクティブな識別情報には、次の権限が必要です。

* 各ソース Google ドキュメントまたは Google Slides プレゼンテーションを読み取り、コピーする。
* ソースファイルと同じ場所に翻訳済みコピーを作成する。
* 後続の実行でそのコピーを編集する。

ソースをコピーできない場合、そのファイルと言語の処理は失敗しますが、残りの処理は継続されます。読み取りはできても編集できない翻訳済みコピーも失敗します。インテグレーションは無関係な複製を作成せず、停止するためです。記録されているコピーが削除されているかゴミ箱に移動されている場合、インテグレーションはそれを古いものとして扱い、次回の実行時に置き換えを作成します。

## プランと権限 [#gating]

| アクション                         | 権限                                                                                                                      | プラン                    |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| プロジェクトインテグレーションを接続する          | `project:write`                                                                                                         | Starter または Enterprise |
| 個人の Google アカウントを接続または再接続する   | `translations:content:write` で Dashboard のコントロールが表示され、`project:files:write` と `project:translations:enqueue` で接続が認可されます | Starter または Enterprise |
| Dashboard でファイルを追加、削除、または翻訳する | `project:files:write` と `project:translations:enqueue`                                                                  | Starter または Enterprise |
| Organization の共有ドライブ を設定する    | `org:manage`                                                                                                            | Enterprise             |

プロジェクトインテグレーション機能がない場合、カタログでは接続コントロールの代わりにアップグレードの案内が表示されます。必要な権限がない場合、該当するアクションは利用できません。

[Google Drive MCP ツール](/docs/integrations/google-drive/reference/mcp-tools) は、Dashboard の翻訳コンテンツ権限ではなく、プロジェクトのファイル権限と翻訳キュー権限を使用します。

## モードの切り替え [#switching]

共有ドライブのファイルがリンクされている間は、プロジェクトをOrganization の共有ドライブから個人アカウントに切り替えることはできません。まずそれらのファイルを削除してから、個人アクセスでインテグレーションを再接続してください。

## 接続を解除する [#disconnecting]

* **アカウントの接続を解除**すると、あるユーザーに保存されている Google 認証情報が削除されます。プロジェクトのリンク済みファイルは保持されますが、そのユーザーは再接続するまで翻訳できません。他のメンバーは、それぞれのアカウントを通じて引き続きアクセスできます。
* Organization 接続の **接続を解除**すると、共有ドライブ用の翻訳認証情報が削除されます。これを使用しているプロジェクトは、管理者が再設定するまで Drive にアクセスできなくなります。

どちらの操作でも、Google Drive 上のソースファイルや翻訳済みコピーが削除されることはありません。インテグレーションからリンク済みファイルを削除しても、Drive 上のどちらのファイルもそのまま残ります。

## Sitemap

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