当客户购买非公开优惠时, 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。newOfferStartTime 和 newOfferEndTime 字段采用 RFC 3339 时间戳格式(以世界协调时间 (UTC) 为准),例如 "2022-01-01T00:00:00Z"。如果您使用 Partner Procurement API 检索权益,API 响应也会包含这些 newOfferStartTime 和 newOfferEndTime 字段。
在您的系统中,更新用户的账号以反映他们购买了优惠。使用 newOfferStartTime 字段验证优惠预计开始的时间,以便您可以根据需要预配资源。
当优惠达到开始日期并生效时,您会收到一条额外的 Pub/Sub 消息,其 eventType 为 ENTITLEMENT_ACTIVE。
后续步骤
为您提供的 SaaS 产品 启用自动优惠审批。
针对特定客户 创建非公开优惠。