为 Gmail 配置 OAuth

本页面介绍了如何配置 OAuth，以将 Gmail 作为数据存储区关联到 Gemini Enterprise。

为 Gmail 设置身份验证和权限

如需启用 Gmail 操作，管理员必须执行以下步骤来启用 Gmail API 并设置身份验证。 Google Cloud

启用 Gmail API

在 Google Cloud 控制台中，启用以下 API：

创建 OAuth 应用并添加范围

如果您没有 OAuth 应用，请按照以下步骤操作。如果您已有 OAuth 应用，请跳至 创建 OAuth 客户端 凭证。

  1. 前往 Google Auth Platform/概览。

  2. 点击开始使用。

  3. 输入 OAuth 应用的名称。

  4. 在用户支持邮箱中，选择一个支持邮箱，供应用用户针对其同意情况与您联系。

  5. 在受众群体下，为您的应用选择用户类型：

    • 外部：如果您要创建的应用供 Google Workspace 组织外部使用，请选择外部。这样，拥有 Google 账号的任何用户都可以公开使用该应用。 如果您为用户类型选择了外部 ，请添加测试用户：
      1. 点击受众群体。
      2. 在测试用户 下，点击 Add users （添加用户）。
      3. 输入您的邮箱和任何其他已获授权的测试用户，然后点击保存。
    • 内部：如果应用仅限特定组织的成员使用，请选择内部，这样只有 Google Workspace 组织成员才能访问该应用。 Google Cloud

  6. 点击下一步。

  7. 在联系信息下，输入一个邮箱，以便您接收有关项目变更的通知。

  8. 点击下一步。

  9. 在完成下，查看《Google API 服务用户数据政策》。如果您同意该政策，请选择我同意 Google API 服务：用户数据政策 。

  10. 点击继续。

  11. 点击创建。

创建应用后，您可以在品牌和受众群体中更新 OAuth 同意屏幕设置。

添加最小范围

如需添加最小必需范围，请按以下步骤操作：

  1. 在 Google Cloud 控制台中，依次点击“菜单”图标 。
  2. 从导航菜单中选择数据访问。
  3. 点击添加或移除范围 。
  4. 在手动添加范围 下，根据您的连接模式粘贴以下 Gmail 范围：
连接模式 范围 用途
联合搜索 https://www.googleapis.com/auth/gmail.readonly 用于搜索邮件。
联合搜索 和操作
  • https://www.googleapis.com/auth/gmail.send
  • https://www.googleapis.com/auth/gmail.readonly
 用于阅读、搜索和发送邮件。
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.compose
 用于管理邮件组织，例如创建和添加标签。
https://www.googleapis.com/auth/gmail.readonly 用于下载附件。

  1. 点击添加到表格 ，然后点击更新 。

  2. 点击保存 。

创建 OAuth 客户端凭证

此过程介绍了如何为 Google Cloud 操作创建新的 OAuth 客户端 ID。如果您已有适用于 Google Cloud 操作的 OAuth 客户端 ID， 则可以将该客户端 ID 和密钥用于 Gmail 操作，而不是 创建新的客户端 ID。

  1. 前往 Google Auth Platform/客户端。

  2. 点击创建客户端。

  3. 在应用类型部分，选择 Web 应用。

  4. 在名称字段中，输入凭证的名称。

  5. 跳过已获授权的 JavaScript 来源 。

  6. 在已获授权的重定向 URI 部分中，点击添加 URI，然后输入以下 URI：https://vertexaisearch.cloud.google.com/oauth-redirect

  7. 点击创建。新创建的凭证会显示在 OAuth 2.0 客户端 ID 下。打开您创建的客户端，然后复制以下信息：

    • 客户端 ID
    • 客户端密钥