促销资源
适用于
- 合作伙伴中心
相应的角色
- 管理员代理
注意
基于许可证的服务的新商业体验涵盖许多新功能，可供所有云解决方案提供商 (CSP) 使用。 有关详细信息，请参阅新商业体验概述。
介绍应用于新商务订阅交易的促销资源。
Promotion
如果符合资格条件，则购买产品 SKU 时应用的折扣。
| properties | 类型 | 描述 |
|---|---|---|
| id | string | 升级标识符。 |
| name | string | 升级的友好名称。 |
| description | string | 促销的说明。 |
| startDate | string | 促销适用的开始日期。 |
| endDate | string | 促销适用的结束日期。 |
| requiredProducts | requiredProducts 列表 | 促销适用的产品、SKU 详细信息和定价策略。 |
| properties | 属性列表 | 升级的属性，包括升级是否自动适用。 |
RequiredProducts
促销适用的产品、SKU 详细信息和定价策略。
| properties | 类型 | 描述 |
|---|---|---|
| productId | string | 促销可用的产品的标识符。 |
| skuId | string | 促销可用的 SKU 的标识符。 |
| term | Term | 包括期限期限和计费周期促销的术语可供使用。 |
| pricingPolicies | pricingPolicies 列表 | 定义促销折扣类型和值的策略列表。 |
Term
表示可购买促销的术语。
| properties | 类型 | 描述 |
|---|---|---|
| duration | string | 术语持续时间的 ISO 8601 表示形式。 当前支持的值为 P1M（一个月）、P1Y（一年）和 P3Y（三年）。 |
| billingCycle | string | 描述促销将应用于计费的频率。 值可以包括 Monthly、Year、OneTime 或 Unknown。 |
PricingPolicies
描述促销折扣类型和值。
| properties | 类型 | 说明 |
|---|---|---|
| type | string | 描述折扣是基于百分比还是固定费率折扣。 |
| value | string | 定义应用的折扣金额。 |
属性
升级的属性。
| properties | 类型 | 描述 |
|---|---|---|
| isAutoApplicable | 布尔 | 指示是否自动应用促销，还是需要合作伙伴传递促销。 |
PromotionEligibibilityRequestItem
表示事务和促销资格的属性。
| properties | 类型 | 描述 |
|---|---|---|
| id | int | 促销资格项标识符。 |
| catalogItemId | string | 将应用于升级的目录项标识符。 包括产品 ID、SKU ID 和可用性 ID。 |
| quantity | int | 许可证或实例数。 |
| termDuration | string | 术语持续时间的 ISO 8601 表示形式。 当前支持的值为 P1M（一个月）、P1Y（一年）和 P3Y（三年）。 |
| billingCycle | string | 描述促销将应用于计费的频率。 值可以包括 Monthly、Year、OneTime 或 Unknown。 |
| promotionID | string | 升级标识符。 |
PromotionEligibibility
产品、SKU 及其促销资格的列表。
| properties | 类型 | 描述 |
|---|---|---|
| id | int | 促销资格项标识符。 |
| catalogItemId | string | 将应用于升级的目录项标识符。 包括产品 ID、SKU ID 和可用性 ID。 |
| quantity | int | 许可证或实例数。 |
| termDuration | string | 术语持续时间的 ISO 8601 表示形式。 当前支持的值为 P1M（一个月）、P1Y（一年）和 P3Y（三年）。 |
| billingCycle | string | 描述促销将应用于计费的频率。 值可以包括每月、年度、OneTime 或 Unknown。 |
| 合格性 | PromotionEligibibility 列表 | 表示提升资格结果的列表。 |
PromotionEligibility
产品、SKU 及其促销资格的列表。
| properties | 类型 | 描述 |
|---|---|---|
| promotionId | string | 升级标识符。 |
| isEligible | 布尔 | 描述促销是否符合给定资格请求项的条件。 |
| errors | PromotionEligibilityErrors 列表 | 描述升级资格请求项目不符合条件的原因的错误。 |
PromotionEligibilityError
说明促销资格请求项目不符合条件的原因。
| properties | 类型 | 说明 |
|---|---|---|
| type | string | 升级资格错误类型可以包括 InvalidCatalogItemId、InvalidPromotion、PrerequisiteProductOwnership、RedemptionLimit、SeatCount、OfferPurchasedPreviously 或 Term。 |
| description | string | 描述促销是否符合给定资格请求项的条件。 |
RedemptionLimitPromotionEligibilityError
包括有关如何超出兑换限制的详细信息。
| properties | 类型 | 描述 |
|---|---|---|
| maxPromotionRedemptionCount | int | 可以获取促销的最大次数。 |
| remainingPromotionRedemptionCount | int | 可以获取促销的剩余次数。 |
SeatCountPromotionEligibilityError
包括有关超出席位计数限制的原因的详细信息。 所有值都是可为 null 的。
| properties | 类型 | 描述 |
|---|---|---|
| minimumRequiredSeats | int | 促销将支持的最低许可证。 |
| maximumRequiredSeats | int | 促销支持的最大许可证数。 |
| availableSeats | int | 合作伙伴可以获取的许可证的剩余数量用于给定的促销。 |
TermPromotionEligibilityError
包括有关为何不接受促销术语的详细信息。
| properties | 类型 | 描述 |
|---|---|---|
| eligibleTerms | PromotionTerm | 促销将支持的符合条件的条款。 |
PromotionTerm
包括有关超出席位计数限制的原因的详细信息。
| properties | 类型 | 描述 |
|---|---|---|
| billingCycle | string | 描述促销将应用于计费的频率。 值可以包括每月、年度、OneTime 或 Unknown。 |
| duration | string | 要购买的期限的持续时间。 |