促銷資源
適用於
- 合作夥伴中心
適當的角色
- 系統管理代理人
注意
授權型服務的新商務體驗包含許多新功能，且適用於所有 雲端解決方案提供者 （CSP）。 如需詳細資訊，請參閱 新的商務體驗概觀。
描述套用至新商務訂用帳戶交易的促銷資源。
促銷
符合資格準則時購買產品 SKU 時所套用的折扣。
| 屬性 | 類型 | 描述 |
|---|---|---|
| id | 字串 | 升級標識碼。 |
| NAME | 字串 | 促銷的易記名稱。 |
| description | 字串 | 促銷的描述。 |
| startDate | 字串 | 促銷適用的開始日期。 |
| endDate | 字串 | 適用促銷的結束日期。 |
| requiredProducts | requiredProducts 的清單 | 促銷適用的產品、SKU 詳細數據和定價原則。 |
| 內容 | 屬性清單 | 促銷的屬性，包括促銷是否自動適用。 |
RequiredProducts
促銷適用的產品、SKU 詳細數據和定價原則。
| 屬性 | 類型 | 描述 |
|---|---|---|
| productId | 字串 | 促銷可供使用的產品標識碼。 |
| skuId | 字串 | 促銷可供使用之 SKU 的標識碼。 |
| 術語 | 術語 | 包含促銷期間和計費週期的字詞。 |
| pricingPolicies | pricingPolicies 清單 | 定義促銷折扣類型和值的原則清單。 |
術語
代表可以購買促銷的字詞。
| 屬性 | 類型 | 描述 |
|---|---|---|
| duration | 字串 | 詞彙持續時間的 ISO 8601 表示法。 目前的支援值為 P1M（一個月）、P1Y（一年）和 P3Y（三年）。 |
| billingCycle | 字串 | 描述促銷將套用至帳單的頻率。 值可以包含每月、年度、OneTime 或未知。 |
PricingPolicies
描述促銷折扣類型和值。
| 屬性 | 類型 | 描述 |
|---|---|---|
| type | 字串 | 描述折扣是以百分比或一般費率折扣為基礎。 |
| value | 字串 | 定義套用的折扣金額。 |
屬性
升級的屬性。
| 屬性 | 類型 | 描述 |
|---|---|---|
| isAutoApplicable | bool | 指出升級是否自動套用，或是否需要由合作夥伴傳遞。 |
PromotionEligibilitiesRequestItem
代表交易和促銷資格的屬性。
| 屬性 | 類型 | 描述 |
|---|---|---|
| id | int | 促銷資格項目標識碼。 |
| catalogItemId | 字串 | 將套用升階的目錄項目標識碼。 包含產品標識碼、SKU標識碼和可用性識別碼。 |
| 數量 | int | 授權或實例的數目。 |
| termDuration | 字串 | 詞彙持續時間的 ISO 8601 表示法。 目前的支援值為 P1M（一個月）、P1Y（一年）和 P3Y（三年）。 |
| billingCycle | 字串 | 描述促銷將套用至帳單的頻率。 值可以包含每月、年度、OneTime 或未知。 |
| promotionID | 字串 | 升級標識碼。 |
PromotionEligibilities
產品、SKU 及其促銷資格的清單。
| 屬性 | 類型 | 描述 |
|---|---|---|
| id | int | 促銷資格項目標識碼。 |
| catalogItemId | 字串 | 將套用升階的目錄項目標識碼。 包含產品標識碼、SKU標識碼和可用性識別碼。 |
| 數量 | int | 授權或實例的數目。 |
| termDuration | 字串 | 詞彙持續時間的 ISO 8601 表示法。 目前的支援值為 P1M（一個月）、P1Y（一年）和 P3Y（三年）。 |
| billingCycle | 字串 | 描述促銷將套用至帳單的頻率。 值可以包括每月、年度、OneTime 或未知。 |
| 資格 | PromotionEligibilities 清單 | 代表促銷資格結果的清單。 |
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 或未知。 |
| duration | 字串 | 正在購買之字詞的持續時間。 |