将你的代理连接至 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 云端硬盘。

从设置中连接

如果你想在多个代理中使用同一个 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 代理搜索或更新云端硬盘文件时，请分别在自定义代理的指令或发给 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 云端硬盘时，你可以设置一个触发器，让代理检查 Google 云端硬盘中的更改。为此，请指定一个文件夹（或云端硬盘链接），并选择检查频率。如果发生更改，代理会检测到并运行。你可以监视文件夹或共享云端硬盘。仅监视直接位于该文件夹中的文件。子文件夹中的更改不会触发代理，而且你无法监视整个 “我的云端硬盘”。

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

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

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

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

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

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

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

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

• 读取 PDF 的文本。

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

• 文件更新时，响应触发器并运行。

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

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

代理无法读取 Google 绘图、Google 地图、Google 表单、图片、视频、音频或 ZIP 文件。如果你让代理查看其中某个文件，代理会告诉你它无法打开该文件。对于 Google 绘图和其他 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 显示管理员已阻止访问，请联系你的 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 的更改可能需要一些时间才能生效。更改生效后，请让对方重新连接。