管理非公开优惠的许可

当客户购买非公开优惠时，Google 会创建一项权益，表明客户已从 Cloud Marketplace 购买了优惠。

本文介绍了如何使用 Partner Procurement API 管理非公开优惠的使用权。

如需详细了解如何使用 Partner Procurement 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 事件，要么保持有效，但不享受折扣价。

后续步骤