集成您的应用:设置

本部分简要介绍了将应用程序与 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 集成的示例以及示例代码演示,请参阅 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 上的 Codelab

在 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 是托管您的解决方案的项目,由您在设置环境时创建。