促销资源

  • 项目

适用于

  • 合作伙伴中心

相应的角色

  • 全局管理员
  • 管理员代理

注意

基于许可证的服务的新商业体验涵盖许多新功能，可供所有云解决方案提供商 (CSP) 使用。 有关详细信息，请参阅新商务体验概述。

介绍应用于新商务订阅交易的促销资源。

Promotion

如果符合资格条件，则购买产品 SKU 时应用折扣。

属性 类型 说明
id string 促销标识符。
name 字符串 促销的友好名称。
description 字符串 促销的说明。
startDate string 促销适用的开始日期。
endDate string 促销适用的结束日期。
requiredProducts requiredProducts 列表 促销适用的产品、SKU 详细信息和定价策略。
properties 属性列表 促销的属性，包括促销是否自动适用。

RequiredProducts

促销适用的产品、SKU 详细信息和定价策略。

属性 类型 说明
productId 字符串 促销可用的产品的标识符。
skuId string 促销可用的 SKU 的标识符。
关键词 术语 一个术语，包括促销的期限和计费周期。
pricingPolicies pricingPolicies 列表 定义促销折扣类型和值的策略列表。

术语

表示可购买促销的术语。

属性 类型 说明
duration 字符串 术语持续时间的 ISO 8601 表示形式。 当前支持的值为 P1M (一个月) 、P1Y (一年) 和 P3Y (三年) 。
billingCycle string 描述促销将应用于计费的频率。 值可以包括 Monthly、Year、OneTime 或 Unknown。

PricingPolicies

描述促销折扣类型和值。

属性 类型 说明
type 字符串 描述折扣是基于百分比还是平面费率折扣。
value 字符串 定义应用的折扣金额。

属性

升级的属性。

属性 类型 说明
isAutoApplicable bool 指示是自动应用促销还是需要合作伙伴传递促销。

PromotionEligibibilityRequestItem

表示事务和促销资格的属性。

属性 类型 说明
id int 促销资格项标识符。
catalogItemId string 将应用于促销的目录项标识符。 包括产品 ID、SKU ID 和可用性 ID。
quantity int 许可证或实例数。
termDuration 字符串 术语持续时间的 ISO 8601 表示形式。 当前支持的值为 P1M (一个月) 、P1Y (一年) 和 P3Y (三年) 。
billingCycle string 描述促销应用于计费的频率。 值可以包括 Monthly、Year、OneTime 或 Unknown。
promotionID 字符串 升级标识符。

PromotionEligibibility

产品、SKU 及其促销资格列表。

属性 类型 说明
id int 促销资格项标识符。
catalogItemId string 将应用于促销的目录项标识符。 包括产品 ID、SKU ID 和可用性 ID。
quantity int 许可证或实例数。
termDuration string 术语持续时间的 ISO 8601 表示形式。 当前支持的值为 P1M (一个月) 、P1Y (一年) 和 P3Y (三年) 。
billingCycle 字符串 描述促销应用于计费的频率。 值可以包括每月、年度、OneTime 或 Unknown。
合格性 PromotionEligibibility 列表 表示促销资格结果的列表。

PromotionEligibility

产品、SKU 及其促销资格列表。

属性 类型 说明
promotionId 字符串 升级标识符。
isEligible bool 描述促销是否符合给定资格请求项的条件。
错误 PromotionEligibilityErrors 列表 描述促销资格请求项目不符合条件的原因的错误。

PromotionEligibilityError

解释促销资格请求项目不符合条件的原因。

属性 类型 说明
type 字符串 提升资格错误类型可以包括 InvalidCatalogItemId、InvalidPromotion、PrerequisiteProductOwnership、RedemptionLimit、SeatCount、OfferPurchasedPreviously 或 Term。
description 字符串 描述促销是否符合给定资格请求项的条件。

RedemptionLimitPromotionEligibilityError

包括有关超过兑换限制的原因的详细信息。

属性 类型 说明
maxPromotionRedemptionCount int 可以获取促销的最大次数。
remainingPromotionRedemptionCount int 可以获取促销的剩余次数。

SeatCountPromotionEligibilityError

包括有关超出席位计数限制的原因的详细信息。 所有值都是可为 null 的。

属性 类型 说明
minimumRequiredSeats int 促销将支持的最低许可证。
maximumRequiredSeats int 促销将支持的最大许可证。
availableSeats int 合作伙伴可以为给定促销获取的剩余许可证数。

TermPromotionEligibilityError

包括有关为何不接受促销术语的详细信息。

属性 类型 说明
eligibleTerms PromotionTerm 促销将支持符合条件的条款。

PromotionTerm

包括有关超出席位计数限制的原因的详细信息。

属性 类型 说明
billingCycle 字符串 描述促销应用于计费的频率。 值可以包括每月、年度、OneTime 或 Unknown。
duration 字符串 要购买的术语的持续时间。