促銷資源

適用於

• 合作夥伴中心

適當的角色

• 全域管理員
• 系統管理代理人

注意

授權型服務的新商務體驗包含許多新功能，並可供所有 雲端解決方案提供者 （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	字串	正在購買之字詞的持續時間。