将您的 AI 代理与 Google Cloud Marketplace 集成

如需通过 Google Cloud Marketplace 提供 AI 智能体产品，您必须将产品与 Google Cloud集成。此技术集成涉及产品后端和前端的多个步骤。

准备工作

• 确认合作伙伴工程师已启用对 Cloud Commerce Partner Procurement API 的访问权限。在合作伙伴工程师授予您对 Partner Procurement API 的访问权限后，您无需执行任何额外步骤即可在 Google Cloud 控制台中启用该 API。

后端集成

您必须将应用的后端与以下 Google API 和服务集成：

• 与 Pub/Sub 集成，以接收来自 Cloud Marketplace 的通知，例如当用户注册您的产品时。您的合作伙伴工程师会创建一个 Pub/Sub 主题，您必须订阅此主题才能收到通知。

  如需了解有关订阅 Pub/Sub 主题的信息，请参阅 Pub/Sub 订阅者指南。

• 与 Partner Procurement API 集成。这样一来，您将能够执行以下操作：

  • 为客户创建账号。
  • 将客户的账号与其在 Cloud Marketplace 中的购买交易相关联。
  • 当用户更改或取消订阅方案时，更新关联的账号。

• 如果您选择了基于用量的价格模式，请与 Service Control 集成以报告使用情况信息。

  如需详细了解如何将应用的后端与 Cloud Marketplace 集成，请参阅配置应用的后端。

  如需查看将基本产品的后端与 Cloud Marketplace 集成的示例以及示例代码演示，请参阅集成软件即服务 (SaaS) 产品的 Codelab。

前端集成

在应用的前端中，您必须设置以下集成：

• 为通过 Cloud Marketplace 购买产品的新客户提供注册页面，以便他们注册账号。当用户访问此页面时，Google 会发送一个包含用户账号 ID 的 JSON Web 令牌 (JWT)。您可以使用此账号 ID 将用户在您产品中的账号与其 Google 账号相关联，还可以用于 Identity and Access Management (IAM)。

  注意： 单个用户可以有多个 Google Cloud账号 ID，多个用户也可以共用一个 Google Cloud账号 ID，具体取决于用户或其组织如何配置 Google Cloud的使用方式。

• 为客户提供登录页面。

您也可以选择：

• 集成单点登录 (SSO)，以便您的客户可以使用其 Google 账号登录您的应用。如果您集成 SSO，当用户通过 SSO 登录时，Google 会发送一个 JSON Web 令牌 (JWT)，其中包含有关用户的信息，供您进行验证。

  如需详细了解如何将应用的前端与 Cloud Marketplace 集成，请参阅集成应用的前端。

与 Google API 集成

您可以通过使用客户端库将 AI 代理产品与 Google API 集成，从而以编程方式访问 Google 产品。客户端库有针对最常用的开发平台（例如 Java、Python 和 .NET）的版本。

从 API 客户端库页面为您的平台安装客户端库。 使用客户端库，您可以执行以下操作：

• 连接到您的 Pub/Sub 订阅，并处理传入的邮件。
• 如果您选择了基于用量的价格，可连接到 Service Control API 以向 Google 报告使用情况数据。

要为客户创建关联账号，以及发送和接收有关用户账号的更新，您还必须与 Partner Procurement API 集成。由于 Partner Procurement API 受到限制，因此您必须为 API 构建新的客户端库。

如需构建新的客户端库，您必须安装 Google 客户端库，并通过 API 发现文档构建新库。Partner Procurement API 的发现文档位于以下网址：

https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1

例如，如果要为合作伙伴采购 API 构建 Python 客户端库，请使用 build() 方法。如需获取如何构建客户端库的示例代码，请参阅 GitHub 上的代码实验室。

后续步骤

• 配置应用的后端。
• 集成应用的前端。
• 将 AI 智能体发布到 Cloud Marketplace。