在启用自动优惠批准功能后,管理非公开优惠的使用权

当客户购买非公开优惠时, Google 会为其创建一项使用权,表明该客户已从 Cloud Marketplace 购买了 优惠。

本文档介绍如何使用 Partner Procurement API 管理已启用自动优惠审批的 非公开优惠 的权益。

如果您尚未为软件即服务 (SaaS) 产品启用自动优惠 审批,那么您收到的 Pub/Sub 消息将与本文档中所述的消息不同。如需详细了解这些 Pub/Sub 消息,请参阅管理非公开优惠的权益

如需详细了解如何将 Partner Procurement API 用于非公开优惠,请访问 参考文档

验证客户的优惠何时生效

为 SaaS 产品启用 自动优惠审批 后,您收到的 Pub/Sub 消息将与 未启用自动审批的 SaaS 产品收到的消息不同。 由于启用自动优惠审批的 SaaS 产品支持计划开始日期,因此在非公开优惠被接受后,您必须验证优惠预计何时开始,以便您可以在正确的时间预配资源。

当客户购买非公开优惠时,Cloud Marketplace 会为其创建一项使用权,并将以下 Pub/Sub 消息发送到您的产品:

{
  "eventId": "...",
  "eventType": "ENTITLEMENT_OFFER_ACCEPTED",
  "entitlement": {
  "id": "ENTITLEMENT_ID",
  "updateTime": "...",
  "newPendingOfferDuration": "", // Contract duration for the offer
  "newOfferStartTime": "...", // Starting time for the offer
  "newOfferEndTime": "...", // Ending time for the offer
  },
}

在此示例中,ENTITLEMENT_ID 是由 Cloud Marketplace 创建的 ID。newOfferStartTimenewOfferEndTime 字段采用 RFC 3339 时间戳格式(以世界协调时间 (UTC) 为准),例如 "2022-01-01T00:00:00Z"如果您使用 Partner Procurement API 检索权益,API 响应也会包含这些 newOfferStartTimenewOfferEndTime 字段。

在您的系统中,更新用户的账号以反映他们购买了优惠。使用 newOfferStartTime 字段验证优惠预计开始的时间,以便您可以根据需要预配资源。

当优惠达到开始日期并生效时,您会收到一条额外的 Pub/Sub 消息,其 eventTypeENTITLEMENT_ACTIVE

后续步骤