将你的代理连接至 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 会显示与你所选访问权限级别对应的云端硬盘权限。Notion 显示 Google 云端硬盘已连接时，就表示连接成功。

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

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

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

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

这将解除你的 Google 帐号与所有正在使用它的代理之间的连接。

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

• 选择 你的帐号。

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

从一个代理中移除 Google 云端硬盘

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

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

3. 选择 解除连接。

将自定义代理连接到 Google 云端硬盘时，你可以设置触发器，让代理检查云端硬盘中的更改。指定一个文件夹或云端硬盘链接，再选择检查频率。如果有更改，代理就会运行。你可以监视文件夹或共享云端硬盘，但只能监视文件夹中的直属文件。子文件夹中的更改不会触发代理，也不能监视整个 “我的云端硬盘”(My Drive)。

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

• “在 Google 云端硬盘中搜索‘产品路线图’并告诉我你找到了什么。”

• “创建一个名为‘每周回顾’的 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 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 登录权限。

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

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

审核应用请求

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

• 该应用为 Custom Agents For Drive。

• 该应用已获准供此人所在群组使用。

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

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

对于 特定 Google 数据，请选择连接所需的所有权限。

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