# General Translation Integrations: 连接
URL: https://generaltranslation.com/zh/docs/integrations/google-drive/reference/connection.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 使用个人 Google 账户或组织共享云端硬盘将项目连接到 Google Drive。Google Drive 连接模式、层级和权限参考。

连接模式决定集成使用的身份、可浏览的文件，以及需要由谁授权。两种模式均可通过 **项目 > 集成 > 目录** 连接。

## 概览 [#overview]

| 主题                           | 描述                      |
| ---------------------------- | ----------------------- |
| [访问模式](#access-modes)        | 个人账户连接和组织共享云端硬盘连接。      |
| [个人账户](#personal-account)    | 对用户可打开的文件进行 OAuth 授权。   |
| [组织共享云端硬盘](#shared-drive)    | 由组织管理员管理的共享翻译账户。        |
| [所需的 Drive 权限](#capabilities) | 活跃身份必须能够在 Drive 中执行的操作。 |
| [方案和权限](#gating)             | 连接和翻译所需满足的条件。           |
| [切换模式](#switching)           | 项目何时可以更改连接模式。           |
| [断开连接](#disconnecting)       | 移除凭据后仍会保留的内容。           |

## 访问模式 [#access-modes]

| 模式       | 身份                   | 可用文件                                          |
| -------- | -------------------- | --------------------------------------------- |
| 个人账户     | 每位用户授权自己的 Google 账户。 | 该用户可打开的 Google Docs 和 Google Slides。          |
| 组织共享云端硬盘 | 一个组织翻译账户。            | 包含该翻译账户的共享云端硬盘中的 Google Docs 和 Google Slides。 |

仅当组织在包含共享云端硬盘访问权限的方案中拥有已验证且处于 Active 状态的共享云端硬盘连接时，仪表板才会询问要使用哪种模式。否则，项目将使用个人账户。

## 个人账户 [#personal-account]

每位用户都需在集成的管理页面中点击 **连接账户**，然后完成 Google 授权。该集成会请求：

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

完整的 Drive 层级让该集成既能访问从 Google Docs 或 Google Slides 加载项中打开的文档，也能访问通过仪表板选择的文件。该集成仅翻译你选择的或通过这些界面明确打开的受支持文件。

在此层级变更之前创建的连接可以保留范围更窄的 `https://www.googleapis.com/auth/drive.file` 授权。它们对通过仪表板选择的文件仍然有效，但在翻译另一个从加载项中打开的文档之前，该集成会要求你重新连接。只有 Google 同时返回受支持的 Drive 层级和刷新令牌时，连接才可使用。

## 组织共享云端硬盘 [#shared-drive]

组织管理员只需在 **组织 > Connections** 中设置一次此连接：点击 **Add connection**，然后为 Google Drive 点击 **Set up**。仪表板会创建一个翻译账户并显示其电子邮件地址。将该电子邮件地址以 **Content manager** 身份添加到每个获授权的共享云端硬盘，然后返回仪表板并点击 **Verify access**。

翻译账户使用 `https://www.googleapis.com/auth/drive` 层级，因此可以浏览已配置的共享云端硬盘。只有当连接处于 **Active** 状态时，项目才能选择此模式。

在此模式下添加的文件必须存储在共享云端硬盘中。**My Drive** 中的文件会被拒绝。

## 所需的 Drive 权限 [#capabilities]

当前处于活动状态的身份必须能够：

* 读取并复制每个源 Google Doc 或 Google Slides 演示文稿。
* 在源文件旁创建翻译后的副本。
* 在后续运行时编辑该副本。

如果无法复制源文件，该文件和对应语言的处理将失败，其余内容则继续处理。可读取但无法编辑的翻译后副本也会失败，因为集成会停止处理，而不会创建无关的重复副本。如果记录的副本已被删除或移至垃圾箱，集成会将其视为失效，并在下次运行时创建替代副本。

## 方案和权限 [#gating]

| 操作                  | 权限                                                                                                    | 方案                   |
| ------------------- | ----------------------------------------------------------------------------------------------------- | -------------------- |
| 连接项目集成              | `project:write`                                                                                       | Starter 或 Enterprise |
| 连接或重新连接个人 Google 账户 | `translations:content:write` 用于显示仪表板控件；`project:files:write` 和 `project:translations:enqueue` 用于授权该连接 | Starter 或 Enterprise |
| 在仪表板中添加、删除或翻译文件     | `project:files:write` 和 `project:translations:enqueue`                                                | Starter 或 Enterprise |
| 配置组织共享云端硬盘          | `org:manage`                                                                                          | Enterprise           |

如果没有项目集成功能，集成目录会显示升级提示，而非连接控件。如果没有所需权限，则无法执行相应操作。

[Google Drive MCP 工具](/docs/integrations/google-drive/reference/mcp-tools)使用的是项目文件和翻译队列权限，而非仪表板的翻译内容权限。

## 切换模式 [#switching]

只要仍有关联的共享云端硬盘文件，项目就无法从组织共享云端硬盘切换为个人账户。请先移除这些文件，然后使用个人访问权限重新连接集成。

## 断开连接 [#disconnecting]

* **断开账户连接**会删除某位用户已保存的 Google 凭据。项目会保留其已关联的文件，但该用户需重新连接后才能翻译这些文件。其他成员仍可通过各自的账户访问。
* 在组织连接中选择**断开连接**会删除共享云端硬盘的翻译凭据。使用该连接的项目将无法访问 Drive，直到组织管理员重新配置。

这两项操作都不会从 Google Drive 中删除源文件或翻译后副本。从集成中移除已关联的文件同样不会影响 Drive 中的源文件和翻译后副本。

## Sitemap

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