设置 Google 日历数据存储区

本页介绍了如何创建数据存储区并将 Google 日历关联到 Gemini Enterprise。

准备工作

  • 使用您计划用来关联 Google Workspace 的同一账号登录 Google Cloud 控制台。Vertex AI Search 会使用您的 Google Workspace 客户 ID 关联到 Google 日历。

  • 如需在 Gemini Enterprise 中强制执行数据源访问权限控制并保护数据安全，请确保您已配置身份提供方。

  • 在向 Google 日历数据存储区添加操作之前， Google Cloud 管理员必须先完成为 Google 日历设置身份验证和权限部分中的步骤，以配置 OAuth 2.0 身份验证，为您提供客户端 ID 和客户端密钥，并设置范围。

创建 Google 日历数据存储区

如需创建 Google 日历数据存储区，请执行以下步骤：

  1. 在 Google Google Cloud 控制台中，前往 Gemini Enterprise 页面。 Gemini Enterprise

  2. 选择或创建 Google Cloud 项目。

  3. 在导航菜单中，点击数据存储区。

  4. 点击 创建数据存储区。

  5. 在来源中，搜索 Google 日历，然后点击选择。

  6. 在操作部分：

    1. 输入从 OAuth 2.0 应用获取的客户端 ID 和客户端密钥，然后点击确认身份验证。

      如需了解详情，请参阅创建 OAuth 客户端凭据。如需了解搜索和操作所需的范围，请参阅所需范围。

    2. 可选：展开高级设置，然后输入服务名称，即在您的 Google Cloud 项目中的 Service Directory 内创建的服务的资源名称。启用 VPC Service Controls 后，此字段为必填字段。

    3. 从列表中选择相应操作，以针对 Google 日历连接器启用这些操作。

    如需查看操作列表，请参阅查看操作。

  7. 点击继续。

  8. 在配置部分中：

    1. 从多区域列表中，选择数据连接器的位置。
    2. 在数据连接器名称字段中，为连接器输入名称。
    3. 如果您选择 US 或 EU 作为位置，请配置加密设置：
      • 选择 Google-managed encryption key 或 Cloud KMS key。
      • 如果您选择的是 Cloud KMS 密钥：
        • 在密钥管理类型列表中，选择相应的类型。
        • 在 Cloud KMS 密钥列表中，选择相应密钥。
      如需了解详情，请参阅客户管理的加密密钥。

  9. 点击继续。

  10. 在结算部分中，选择一般价格或可配置的价格。如需了解详情，请参阅验证项目的结算状态和许可。

  11. 点击创建。Gemini Enterprise 会为您创建数据存储区，并在数据存储区页面上显示您的数据存储区。

在数据存储区页面上，点击数据存储区名称以查看状态。当数据存储区状态从正在创建变为活跃时， Google 日历连接器即可供使用。

创建数据存储区后，请创建应用并将其与 Google 日历数据存储区相关联，然后再执行查询。

查询执行

在授权 Google 日历后，如果您输入搜索查询：

  1. Gemini Enterprise 会将您的搜索查询发送给 Google 日历 API。

  2. Gemini Enterprise 会将获得的结果与其他来源的结果融合，然后显示出来。

错误消息和问题排查

下表介绍了使用此 Google 数据源时可能会遇到的错误消息，包括 HTTP 错误代码和建议的问题排查步骤。

错误代码 错误消息 说明 问题排查
403 权限遭拒 Google Workspace 数据存储区不支持通过服务账号凭证进行搜索。 被搜索的引擎包含 Google Workspace 数据存储区，且传递的为服务账号凭证。不支持使用服务账号凭证搜索 Google Workspace 数据存储区。 使用用户凭证调用搜索，或从该引擎中移除 Google Workspace 数据存储区。
403 权限遭拒 Google Workspace 数据存储区不支持个人账号。 调用搜索时使用了个人账号 (@gmail.com) 凭证，而 Google Workspace 数据存储区不支持该类凭证。 从该引擎中移除 Google Workspace 数据存储区，或使用受管理的 Google 账号。
403 权限遭拒 数据存储区的客户 ID 与预期不匹配 只有与 Google Workspace 数据存储区属于同一组织的用户才能进行搜索。 从该引擎中移除 Google Workspace 数据存储区，或在用户与数据存储区确实属于不同组织时联系支持团队。
403 权限遭拒 组织管理员已停用 Agentspace 对 Workspace 的访问权限。 Google Workspace 管理员已禁止 Gemini Enterprise 访问 Google Workspace 数据。 请与您的 Google Workspace 管理员联系，以 [启用访问权限](https://support.google.com/a/answer/16479199)。

后续步骤