本部分简要介绍了将应用与 Cloud Marketplace 集成的步骤。概括来讲,您可以通过以下方式将您的应用与 Google Cloud 集成:
后端集成
您必须将应用的后端与以下 Google API 和服务集成:
与 Pub/Sub 集成,以接收来自 Cloud Marketplace 的通知,例如当用户注册您的产品时。您的合作伙伴工程师创建一个 Pub/Sub 主题,您必须订阅该主题才能收到通知。
如需了解有关订阅 Pub/Sub 主题的信息,请参阅 Pub/Sub 订阅者指南。
与 Partner Procurement API 集成,以便为 以及将这些账号与其 Cloud Marketplace 相关联 购买。当用户更改或取消订阅方案时,您还必须使用 Partner Procurement API 更新关联账号。
如果您选择了基于用量的价格模式,请集成 用于报告使用情况信息的 Service Control。
如需详细了解如何将应用的后端与 Cloud Marketplace 集成,请参阅配置应用的后端。
有关将基本产品的后端与 Cloud Marketplace 以及示例代码演示,请参阅 用于集成 SaaS 产品的 Codelab。
前端集成
在应用的前端中,您必须设置以下集成:
提供注册页面,以便为购买了您的 通过 Cloud Marketplace 购买产品当用户访问此网页时,Google 发送 JSON 网络令牌 (JWT) 包含用户的账号 ID。您可以使用此账号 ID 将用户在您产品中的账号与其 Google 账号相关联,还可以用于身份和访问管理 (IAM)。
为客户提供登录页面。
您可以选择:
- 集成单点登录 (SSO),以便客户登录到您的 使用其 Google 账号访问应用。如果您集成了单点登录,当用户登录时 使用单点登录,Google 会将 JSON 网络令牌 (JWT) 包含用户相关信息以供您验证。
如需详细了解如何将应用的前端与 Cloud Marketplace 集成,请参阅集成应用的前端。
准备工作
- 确认合作伙伴工程师已启用对 Cloud Commerce Partner Procurement API。在合作伙伴工程师向您授予访问权限后, Partner Procurement API,因此您无需执行任何额外步骤 在 Google Cloud 控制台中启用该 API。
与 Google API 集成
您可以通过执行以下操作,将您的应用与 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 上的代码实验室。