将您的应用与 Google Cloud Marketplace 集成

本部分简要介绍了将应用与 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 Web 令牌 (JWT)。您可以使用此账号 ID 将用户在您产品中的账号与其 Google 账号相关联,还可以用于 Identity and Access Management (IAM)。

    • 为客户提供登录页面。

    您可以选择:

    • 集成单点登录 (SSO),以便客户可以使用他们的 Google 账号登录您的应用。如果您集成了 SSO,当用户使用 SSO 登录时,Google 会发送一个包含用户相关信息的 JSON Web 令牌 (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 上的代码实验室