将你的代理连接到 Google 云端硬盘（测试版）

你可以将 Notion 代理 或 自定义代理 连接到 Google 云端硬盘，让它们实时搜索、读取、写入和更新文件。

此连接与你设置连接时使用的帐号绑定。当你的代理使用 Google 云端硬盘时，它会实时查看你的云端硬盘。Notion 不会保存或索引任何内容。代理只能访问你拥有的文件、与你共享的文件，以及你有权访问的共享云端硬盘。

• 确保你能登录要使用的 Google 帐号。

• 你必须是工作空间成员（而非访客），且工作空间必须开启 Notion AI。

• 连接前，你的 Google Workspace 所有者可能需要批准“Custom Agents For Drive”。如果你的工作空间尚未获批使用 Google 云端硬盘，请让工作空间所有者批准。工作空间所有者连接后，Google 云端硬盘会自动获批供该工作空间使用。

• 在允许访问之前，请查看 Google 显示的权限。

• 如果你的工作空间限制可使用的连接，工作空间所有者可能需要为自定义代理启用 Google 云端硬盘。

• 将自定义代理连接至 Google 云端硬盘，不同于供 Notion 代理 使用的 Notion AI Google 云端硬盘连接器。

连接 Google 云端硬盘有两种方式：你可以先在设置中连接 Google 帐号，再将其添加到任意代理；也可以在使用某个代理时添加 Google 云端硬盘。

从设置中连接

这样，你就可以通过 Notion 代理访问 Google 云端硬盘，并在多个代理中使用同一个 Google 帐号。

1. 前往 设置 → 连接。

2. 选择 Google 云端硬盘。

3. 选择 你的帐号 → 连接你的 Google 云端硬盘帐号。

4. 选择 基础访问权限 或 全部权限，然后选择 连接。

5. 阅读提醒，然后选择 继续前往 Google。

6. 使用你要连接的 Google 帐号登录。

7. 在接下来的 Google 界面中，请勾选“云端硬盘”下的所有选项。如果有任何选项未被勾选，代理将无法正常运行。

你的 Google 帐号现已连接到 Notion。你可以在任意自定义代理的“工具和访问权限”设置中添加 Google 云端硬盘。

从代理连接

1. 打开要更新的自定义代理。

   • Notion 代理使用你在

     设置 → 连接 中连接的 Google 帐号。无需在 Notion 代理中额外设置。

2. 前往代理的 设置 → 工具和访问权限。

3. 选择 + 添加连接 → Google 云端硬盘。

4. 按照步骤登录 Google 并授予访问权限。在接下来的 Google 界面中，请勾选“云端硬盘”下的所有选项。如果有任何选项未被勾选，代理将无法正常运行。

   • 可选：选择特定的共享云端硬盘或文件夹，以限制代理的访问范围。

5. 选择 保存。

连接后，你可以指定代理能访问的内容。在代理的 工具和访问权限 设置中，选择允许代理查看或编辑的云端硬盘文件或文件夹。

为了让代理更准确地完成任务，想让它搜索或更新云端硬盘文件时，请在自定义代理的指令或你发给 Notion 代理的指令中提及 Google 云端硬盘。

添加 Google 云端硬盘时，你需要选择代理的访问权限级别。之后可以更改。

• 基础访问权限：你的代理可以读取你能读取的任何文件，但只能编辑它创建的文件或你选择的文件。

• 全部权限：你的代理拥有与你现有的云端硬盘权限相同的权限，可以读取和编辑你有权读取和编辑的任何文件。

你的访问权限级别适用于你所有的代理。如需更改，请重新连接 Google 云端硬盘并选择 更新云端硬盘访问权限。Notion 代理始终使用你的全部权限。若要将自定义代理的访问范围限制为特定文件或文件夹，请使用其 工具和访问权限 设置。

Google 会要求你批准访问权限：这是正常的设置流程。选择你要使用的 Google 帐号，查看 Google 请求的权限，然后继续。接下来，Google 会显示你所选访问权限级别对应的云端硬盘权限。当 Notion 显示 Google 云端硬盘已连接时，即表示连接成功。

你可能不需要管理员审核：许多 Google Workspace 允许用户自行连接新应用。如果你的管理员没有为“Custom Agents For Drive”设置特殊规则，你或许可以直接连接。一旦管理员为该应用设置了规则，就以该规则为准。

Notion 显示“已连接”，但你没有看到 Google 登录界面：Notion 可能会沿用你之前设置的 Google 云端硬盘连接。只要连接仍然有效，这就是正常的。如果连接到了错误的 Google 帐号，或云端硬盘无法正常使用，请在 工具和访问权限 中移除 Google 云端硬盘，再重新连接并选择你要使用的帐号。

你可以从使用 Google 云端硬盘的每个代理中将其移除，也可以仅从一个代理中移除。

从所有代理中移除你的帐号

这将解除你的 Google 帐号与所有使用该帐号的代理的连接。

• 前往 设置 → 连接，然后选择 Google 云端硬盘。

• 选择 你的帐号。

• 在已连接的帐号旁，选择 解除连接，然后确认。

从单个代理中移除 Google 云端硬盘连接

1. 打开代理，前往 工具和访问权限。

2. 选择 Google 云端硬盘连接旁的三点菜单。

3. 选择 解除连接。

将自定义代理连接到 Google 云端硬盘时，你可以设置触发器，让代理检查其中是否有更改。指定一个文件夹（或云端硬盘链接），再选择检查频率。如果发生更改，代理就会检测到并运行。你可以监视文件夹或共享云端硬盘。只有文件夹内第一层的文件会受到监视。子文件夹中的更改不会触发代理，你也无法监视整个 “我的云端硬盘”。

尝试使用以下文字指令之一，测试你的代理与 Google 云端硬盘的连接：

• “在 Google 云端硬盘中搜索‘roadmap’，然后告诉我找到了什么。”

• “创建一个名为‘每周回顾’的 Google 文档，并简要总结本周内容。”

连接到 Google 云端硬盘后，你的代理可以：

• 搜索你可以访问的 Google 文档、表格和幻灯片。

• 根据你授予的访问权限，编辑现有的 Google 文档、表格和幻灯片。对于 PDF 或 Word 文档等其他文件，代理可以将更新后的版本保存为新文件。

• 复制、移动、重命名文件以及将文件移至垃圾箱。

• 实时读取并总结文件内容。

• 读取 PDF 的文本。

• 创建新文档、表格、演示文稿和文件夹。

• 文件更新时，根据触发器执行操作。

你的代理可以处理的文件类型

你的代理可以读取 Google 文档、表格和幻灯片，以及 PDF、Word、Excel、PowerPoint、CSV 和纯文本文件（包括 HTML、JSON、XML 和 YAML）。上传的文件（如 PDF 和 Office 文件）大小上限为 10 MB。对于非常大的 Google 文档、表格或幻灯片，代理可能一次只能读取文件的一部分。

代理无法读取 Google 绘图、Google 地图、Google 表单、图片、视频、音频或 zip 文件。如果你指定其中一种文件，代理会告诉你无法打开。对于 Google 绘图等 Google 文件，代理会请你改在 Google 云端硬盘中打开。

你的代理只能访问已连接的 Google 帐号有权访问的内容。如果该帐号失去对某个文件或文件夹的访问权限，代理也会失去相应的访问权限。

编辑者可以移除自定义代理的 Google 云端硬盘连接。只有将代理连接到 Google 云端硬盘的人员才能添加更多访问权限（例如添加更多文件夹）。

最好只让自定义代理访问所需的共享云端硬盘或文件夹。这有助于代理专注于任务并降低风险。

对于已共享的自定义代理，任何有权访问该代理的人都可以查询与其连接的 Google 云端硬盘。

• 每个代理无法连接多个 Google 帐号。

• 此连接仅适用于你 Google Workspace 中的文件。如果文件来自其他 Google Workspace，即使已共享给你，自定义代理也无法访问。

• 如果共享了自定义代理，则任何可以使用该代理的人也都可以搜索与其连接的云端硬盘。

“你所在机构的管理员需要审核此应用”

如果你的组织尚未批准该应用所需的一项或多项权限，你就会看到此提示。只有管理员才能解决此问题。

1. 选择 请求访问权限。

2. 你的 Google Workspace 管理员会在 待审核的应用 下收到该请求。

3. 管理员批准该应用及其所有权限后，请再次尝试连接。

“访问被屏蔽：授权错误”

如果管理员针对你的帐号或所属群组屏蔽了该应用，你就会看到此提示。请联系 Google Workspace 管理员。管理员需要先允许你的群组使用 Custom Agents For Drive，你才能连接。

之前可以使用，但现在无法使用了

你的 Google 访问权限可能已过期或被停用，也可能是管理员更改了规则。

1. 在 工具和访问权限 下重新连接 Google 云端硬盘。

2. 如果 Google 显示管理员已屏蔽此应用，请联系你的 Google Workspace 管理员。

3. 如果你可以登录 Google，但 Notion 仍无法连接，请联系 Notion 支持团队，并提供你看到的错误信息。

要让用户连接，请允许其群组（组织单位）使用 Custom Agents For Drive，并批准其访问权限级别所需的所有 Google 权限。

Google 如何决定用户可以连接哪些应用

在管理控制台中，前往 API 控制 → 设置 → 未配置的第三方应用。默认情况下，用户可以自行连接新应用。只要你没有为 Custom Agents For Drive 设置单独的规则，用户无需经过你审核就能连接。

其他设置仅允许获取基本的 Google 登录信息，或屏蔽所有新应用。你为特定应用设置的规则会覆盖默认设置。访客通过各自所属的群组进行管理。

此设置涵盖应用登录访问权限。Google Workspace Marketplace 的安装则单独管理。

设置 Notion Agents For Drive

自行设置该应用后，即使新应用只能获取基本登录信息或遭到屏蔽，用户仍可连接。

1. 打开 管理控制台 → 安全性 → 访问权限和数据控制 → API 控制 → 应用访问权限控制。

2. 打开“已配置的应用”，然后选择 配置新应用。

3. 使用以下 OAuth 客户端 ID 精确搜索：

   69206789846-avkmfeq0epeducrkoutjo361r8p5h103.apps.googleusercontent.com

4. 选择允许其成员进行连接的群组。

5. 选择 受信任，允许应用请求的所有权限；或选择 特定 Google 数据，加入连接所需的所有 Google 云端硬盘和 Google 登录权限。

6. 检查你的选择，然后选择 完成。

7. 更改生效后，让对方重新连接。

审核应用请求

审核请求时，请检查以下内容：

• 该应用为 Custom Agents For Drive。

• 该应用已对该人员所属的群组开放。

• 所有 Google 云端硬盘和 Google 登录权限均已获批准。

• 确认没有子分组规则在不知不觉中阻止该应用。

如果选择 特定 Google 数据，请选中连接请求的所有权限。

Google Workspace 的更改可能需要一些时间才能生效。生效后，让对方重新连接。