集成应用:设置

本部分概述了将应用与 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。