# General Translation Integrations: 连接
URL: https://generaltranslation.com/zh/docs/integrations/google-drive/reference/connection.mdx
---

title: 连接
description: 使用个人 Google 账号或组织共享云端硬盘将项目连接到 Google Drive。Google Drive 连接模式、层级和权限参考。

---

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

## 概览 [#overview]

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

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

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

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

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

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

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

`drive.file` 层级将访问权限限制在通过 Google Picker 选择的文件以及该集成创建的翻译后副本，而非账户中的整个 Drive。只有 Google 同时返回该层级和刷新令牌后，才能使用此连接。

## 组织共享云端硬盘 [#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`              | 项目集成          |
| 添加、删除或翻译文件 | `translations:content:write` | 项目集成          |
| 配置组织共享云端硬盘 | `org:manage`                 | Google 共享云端硬盘 |

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

## 切换模式 [#switching]

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

## 断开连接 [#disconnecting]

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

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