管理私密優惠的授權

當客戶購買私密優惠時，Google 會建立授權，表示客戶已透過 Cloud Marketplace 購買優惠。

本文將介紹如何使用 Producer Portal 和合作夥伴採購 API，管理私密優惠的授權。你可以使用製作人入口網站核准優惠授權。如要執行其他優惠授權管理工作，則必須使用合作夥伴採購 API。

使用 Producer Portal 核准授權

你可以透過 Producer Portal 核准私密優惠的授權。如要透過製作人入口網站核准授權，請完成下列步驟：

  1. 在 Producer Portal 中，前往「私密優惠」頁面。

  2. 按一下「管理你的產品/服務」。

使用 Partner Procurement API 管理授權

以下各節將說明如何使用合作夥伴採購 API 管理私人商品的授權。

如要進一步瞭解如何使用合作夥伴採購 API 處理私人商品，請參閱參考文件。

核准授權

當消費者購買私人商品時，Cloud Marketplace 會建立授權，並將下列 Pub/Sub 訊息傳送至您的產品：

{
  "eventId": "...",
  "eventType": "ENTITLEMENT_CREATION_REQUESTED",
  "entitlement": {
  "id": "ENTITLEMENT_ID",
  "updateTime": "...",
  "newOfferDuration": "P1Y6M", // Contract duration for the offer
  "newOfferEndTime": "", // Ending time for the offer
  },
}

在本範例中，ENTITLEMENT_ID 是由 Cloud Marketplace 建立的 ID。

如果是使用期限建立優惠，訊息會以年和月顯示期限，且 newOfferEndTime 欄位為空白。如果優惠是在指定結束時間的情況下建立，訊息會顯示優惠的結束時間，而 newOfferDuration 欄位則會保持空白。

請在您的系統中將使用者帳戶更新為已購買優惠的狀態。接著，如要核准授權，請向 Partner Procurement API 提出 HTTP POST 要求，並傳送您要核准的 ENTITLEMENT_ID：

POST v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID:approve

拒絕授權

如要拒絕授權，請在 HTTP POST 要求中使用 reject 方法：

POST v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID:reject

取代有效優惠

視您設定私密優惠的方式而定，客戶或許可以取代自己的優惠。當客戶選擇新的私人優惠時，您會收到格式如下的 Pub/Sub 訊息：

{
  "eventId": "...",
  "eventType": "ENTITLEMENT_PLAN_CHANGE_REQUESTED",
  "entitlement": {
  "id": "ENTITLEMENT_ID",
  "newPlan": "ultimate",   // New plan for the offer,
  "newOffer": "OFFER2",    // New offer,
  "updateTime": "...",
  "newOfferDuration": "P2Y",   // Contract duration for the new offer
  },
}

在本範例中，OFFER2 是替換的商品，ENTITLEMENT_ID 則是 Cloud Marketplace 建立的 ID。優惠期限以年和月為單位提供。

如要核准商品替換，請向 Partner Procurement API 提出下列 HTTP POST 要求：

POST v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID:approvePlanChange

要求主體必須包含已核准的優惠方案：

{
  "pendingPlanName": PLAN_NAME
}

變更核准後，您會在變更生效時收到另一則 Pub/Sub 訊息，在訊息中，eventType 欄位會變更為 ENTITLEMENT_PLAN_CHANGED。如要檢查方案狀態，請向 Partner Procurement API 提出下列 HTTP GET 要求：

GET v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID

您會收到內容如下的回應，其中的 state 欄位會指出新方案是否已生效，或者方案變更是否仍在處理中：

{
  "name": "providers/PARTNER_ID/entitlements/ENTITLEMENT_ID",
  "provider": "PARTNER_ID",
  "account": "USER_ACCOUNT_ID",
  "product": "example-server",
  "Offer":   "OFFER1",
  "plan": "pro",
  "state": "ENTITLEMENT_PENDING_PLAN_CHANGE",
  "newPendingOffer": "OFFER2",
  "newPendingPlan": "ultimate",
  "newOfferDuration": "P2Y",
  "newOfferEndTime": "",
  ...
}

完成其他授權工作

如需瞭解其他非私人專屬產品的授權作業，請參閱 Cloud Marketplace 公開說明文件：

私密優惠帳戶工作適用的事件類型清單

下表列出產品可能會在 Pub/Sub 訊息中收到的私密優惠 eventType。

如需完整清單，請參閱「帳戶工作事件類型清單」。

eventType 說明
ENTITLEMENT_OFFER_ENDED 表示客戶的私密優惠已結束。優惠會觸發 ENTITLEMENT_CANCELLED 事件，或以非折扣價格保持有效。

後續步驟