本部分概述了将应用与 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 会发送包含用户帐号 ID 的 JSON 网络令牌 (JWT)。您可以使用此帐号 ID 将您产品中用户的帐号与其 Google 帐号相关联,还可用于 Identity and Access Management (IAM)。
为客户提供登录页面。
您可以根据需要选择执行以下操作:
- 集成单点登录 (SSO),以便客户可以使用其 Google 帐号登录您的应用。如果您集成了 SSO,那么当用户使用 SSO 登录时,Google 会发送一个包含用户相关信息的 JSON 网络令牌 (JWT),以便您进行验证。
如需详细了解如何将应用的前端与 Cloud Marketplace 集成,请参阅集成应用的前端。
准备工作
- 确认合作伙伴工程师已启用对 Cloud Commerce Partner Procurement 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
例如,如果您要为 Partner Procurement API 构建 Python 客户端库,请使用 build()
方法。如需获取如何构建客户端库的示例代码,请参阅 GitHub 上的代码实验室。
在 Google Cloud 控制台中启用 Partner Procurement API
在合作伙伴工程师向您授予 Partner Procurement API 的访问权限后,您无需执行任何额外步骤即可在 Google Cloud 控制台中启用该 API。