將應用程式與 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) 產品的程式碼研究室」。

  • 前端整合

    您必須在應用程式的前端設定下列整合作業:

    • 提供註冊頁面,讓透過 Cloud Marketplace 購買產品的新客戶註冊帳戶。使用者造訪這個頁面時,Google 會傳送內含使用者帳戶 ID 的 JSON Web Token (JWT)。您可以使用這個帳戶 ID,將產品中的使用者帳戶連結至他們的 Google 帳戶,並用於 Identity and Access Management (IAM)。

    • 為客戶提供登入頁面。

    您也可以選擇:

    • 整合單一登入 (SSO) 服務,讓客戶可以使用 Google 帳戶登入應用程式。如果您整合單一登入 (SSO),當使用者使用 SSO 登入時,Google 會傳送 JSON Web Token (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

舉例來說,如果您要建構適用於 Partner Procurement API 的 Python 用戶端程式庫,請使用 build() 方法。如需建構用戶端程式庫的程式碼範例,請參閱「GitHub 上的程式碼研究室範例」。