本部分简要介绍了将应用与 Google Cloud Marketplace 集成的步骤。概括来讲,您可以通过以下方式将您的应用与 Google Cloud 集成:
后端集成
您必须将应用的后端与以下 Google API 和服务集成:
与 Pub/Sub 集成,以接收来自 Google Cloud Marketplace 的通知,例如当用户注册您的产品时。您的合作伙伴工程师创建一个 Pub/Sub 主题,您必须订阅该主题才能收到通知。
如需了解有关订阅 Pub/Sub 主题的信息,请参阅 Pub/Sub 订阅者指南。
与 Partner Procurement API 集成以便为客户创建帐号,并将这些帐号与客户用这些帐号在 Google Cloud Marketplace 中购买的项目相关联。当用户更改或取消订阅方案时,您还必须使用 Partner Procurement API 更新关联帐号。
如果您选择了基于用量的价格模式,请与 Service Control 集成以报告使用情况信息。
如需详细了解如何将应用的后端与 Google Cloud Marketplace 集成,请参阅集成应用的后端。
如需查看将基本产品的后端与 Google Cloud Marketplace 集成的示例以及示例代码演示,请参阅集成 SaaS 产品的 Codelab。
前端集成
在应用的前端中,您必须设置以下集成:
为通过 Google Cloud Marketplace 购买产品的新客户创建一个激活页面。当新客户被定向到此页面时,Google 还会发送一个 JSON 网络令牌 (JWT),其中包含用户的帐号 ID。您可以使用此帐号 ID 为用户创建新帐号,并将新帐号与用户的 Google 帐号关联。
集成单点登录 (SSO),以便用户可以使用他们的 Google 帐号登录您的应用。要集成 SSO,您的应用必须验证包含用户帐号 ID 的 JWT。您的应用程序必须使用用户的链接帐号检查帐号 ID。
如需详细了解如何将应用的前端与 Google Cloud Marketplace 集成,请参阅集成应用的前端。
准备工作
- 确认合作伙伴工程师已启用对 Cloud Commerce Partner Procurement API 的访问权限。
与 Google API 集成
客户端库支持以编程方式访问 Google 产品,因此您可以使用客户端库将应用与 Google API 集成。客户端库有针对最常用的开发平台(例如 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 上的代码实验室。
在 Cloud Console 中启用 Partner Procurement API
Producer Portal
如果您使用的是 Producer Portal,在合作伙伴工程师授予您对 Partner Procurement API 的访问权限后,您无需执行任何额外步骤即可在 Cloud Console 中启用 API。
合作伙伴门户
如果您使用的是合作伙伴门户,请在合作伙伴工程师授予您对 Partner Procurement API 的访问权限后,请转到以下网址以在 Cloud Console 中启用 API:
https://console.cloud.google.com/apis/api/cloudcommerceprocurement.googleapis.com/overview?project=YOUR_PROJECT_ID
其中,YOUR_PROJECT_ID
是托管您的解决方案的项目,由您在设置环境时创建。