產品資源

代表可購買商品或服務的資源。 包含描述產品類型和圖形的資源（SKU），以及檢查庫存中產品的可用性。

Products

表示可購買的良好或服務。 產品本身不是可購買的專案。

屬性	類型​	描述
id	String	產品的標識碼。
title	String	產品標題。
description	String	產品描述。
productType	ItemType	物件，描述此產品的型別分類。
isMicrosoftProduct	Bool	指出產品是否為 Microsoft 產品。
publisherName	String	如果有的話，產品發行者的名稱。
連結	ProductLinks	產品中包含的資源連結。

ItemType

表示產品的型別。

屬性	類型​	描述
id	String	類型標識碼。
displayName	String	項目類型的顯示名稱。
subType	ItemType	選擇性。 物件，描述專案類型的子類型分類。

ProductLinks

包含產品的連結清單。

屬性	類型​	描述
skus	連結	存取基礎 SKU 的連結。
連結	ResourceLinks	資源內含的資源連結。

Sku

代表產品下可購買的庫存單位（SKU）。

屬性	類型​	描述
id	String	SKU 的標識碼。 標識碼只有在其父產品的內容中才是唯一的。
title	String	SKU 的標題。
description	String	SKU 的描述。
productId	String	包含 SKU 之父 產品的 識別碼。
minimumQuantity	int	允許購買的最低數量。
maximumQuantity	int	允許購買的最大數量。
isTrial	Bool	指出 SKU 是否為試用專案。
supportedBillingCycles	字串陣列	SKU 支援的計費週期清單。 支援的值是 BillingCycleType 中找到的成員名稱。
purchasePrerequisites	字串陣列	購買專案之前所需的必要步驟或動作清單。 支援的值為： “InventoryCheck” - 表示在嘗試購買專案之前，應該先評估專案的清查。 “AzureSubscriptionRegistration” - 指出需要 Azure 訂用帳戶，而且必須在嘗試購買專案之前註冊。
inventoryVariables	字串陣列	在專案上執行清查檢查所需的變數清單。 支援的值為： “CustomerId” - 購買物件之客戶的標識符。 “AzureSubscriptionId” - 將用於 Azure 保留購買的 Azure 訂用帳戶標識符。 “ArmRegionName” - 要驗證清查的區域。 此值必須符合 SKU DynamicAttributes 中的 “ArmRegionName”。
provisioningVariables	字串陣列	購買專案時，必須提供給購物車明細專案的布建內容中的變數清單。 支援的值為： 範圍 - Azure 保留購買的範圍：「Single」、“Shared” “SubscriptionId” - 將用於 Azure 保留購買的 Azure 訂用帳戶標識符。 “Duration” - Azure 保留的持續時間：“1Year”、“3Year”。
dynamicAttributes	索引鍵/值組	套用至專案的動態屬性字典。 字典中的屬性是動態的，而且可以變更而不通知。 合作夥伴應避免在屬性值中現有的特定索引鍵上建立強式相依性。
連結	ResourceLinks	SKU 中包含的資源連結。
AttestationProperties	AttestationProperties	SKU 的證明屬性。
consumptionType	String	只有在 SKU 支援使用量，例如 超額時，才能使用。
specializedOfferProperties	specializedOfferProperties 的清單	只有在產品是 SpecializedOffer 的 subType 時，才能使用。
minimumPurchaseCommitment	MinimumPurchaseCommitment	計算服務上認可的固定數量。

動態 SKU 屬性

與新商務授權型產品和服務相關的值得注意的屬性。

注意

授權型服務的新商務體驗包含許多新功能，且適用於所有 雲端解決方案提供者 （CSP）。 如需詳細資訊，請參閱 新的商務體驗概觀。

屬性	類型​	描述
hasConstraints	布林值	描述 SKU 是否包含 assetContraints
isAddon	布林值	描述 SKU 是否為附加元件
prerequisiteSkus	字串陣列	描述附加元件可以使用的產品和 SKU
upgradeTargetOffers	字串陣列	項目可升級至的產品和 SKU 清單
conversionInstructions	conversionInstructions 列表	適用於轉換作業的指示清單

specializedOfferProperties

注意

授權型服務的新商務體驗包含許多新功能，並可供所有 雲端解決方案提供者 （CSP） 使用。 如需詳細資訊，請參閱 新的商務體驗概觀。

僅適用於產品子類型 “SpecializedOffers”

屬性	類型​	描述
startDate	String	適用於指示的字詞標識碼
endDate	String	定義更新的選項
pricingPolicies	pricingPolicies 清單	定義促銷折扣類型和值的原則清單。

MinimumPurchaseCommitment

可在計算服務上認可的最小數量屬性。

屬性	類型​	描述
糧食	String	最低購買承諾期。
currencyCode	<字典字串、字串>	可認可的最小金額的「貨幣」和「符號」。
金額	int	計算服務可認可的最小數量。

PricingPolicies

描述促銷折扣類型和值。

屬性	類型​	描述
type	String	描述折扣是以百分比或一般費率折扣為基礎。
value	String	定義套用的折扣金額。

可用性

代表可供購買 SKU 的組態（例如國家/地區、貨幣和產業區段）。

屬性	類型​	描述
id	String	此可用性的識別碼。 此標識碼只在其父 產品和SKU 的內容中是唯一的。 注意 可用性標識碼可能會隨著時間而變更。 合作夥伴只有在擷取此值之後，才應該在短時間內依賴此值。
productId	String	包含此可用性的產品識別碼。
skuId	String	包含此可用性之 SKU 的識別碼。
catalogItemId	String	目錄中此專案的唯一標識符。 購買父 SKU 時，此標識碼必須填入 OrderLineItem.OfferId 或 CartLineItem.CatalogItemId 屬性。 注意 此識別碼可能會隨著時間而變更。 您只應該在擷取此值之後的短時間內依賴此值。 它應該只能在購買時存取及使用。
defaultCurrency	String	此可用性支持的預設貨幣。
segment	String	此可用性的產業區段。 支援的值為：商業、教育、政府、NonProfit。
國家/地區	String	適用此可用性的國家/地區（採用 ISO 國家/地區代碼格式）。
isPurchasable	Bool	指出此可用性是否可購買。
isRenewable	Bool	指出此可用性是否可更新。
RenewalInstructions	RenewalInstruction	表示指定可用性的更新指示。
product	產品	此可用性對應至的產品。
SKU	Sku	此可用性所對應的 SKU。
terms	字詞資源的陣列	適用於此可用性的條款集合。
連結	ResourceLinks	可用性中包含的資源連結。

續約指示

注意

授權型服務的新商務體驗包含許多新功能，且適用於所有 雲端解決方案提供者 （CSP）。 如需詳細資訊，請參閱 新的商務體驗概觀。

表示指定可用性的更新指示。

屬性	類型​	描述
applicableTermIds	字串陣列	適用於指示的字詞標識碼
RenewalOptions	RenewalOption 的陣列	定義更新的選項

RenewalOption

注意

授權型服務的新商務體驗包含許多新功能，且適用於所有 雲端解決方案提供者 （CSP）。 如需詳細資訊，請參閱 新的商務體驗概觀。

表示指定可用性的更新指示。

屬性	類型​	描述
renewToId	String	代表要更新至的產品和 SKU
isAutoRenewable	Bool	是否可自動更新可用性

詞彙

表示可以購買可用性的字詞。

屬性	類型​	描述
duration	String	詞彙持續時間的 ISO 8601 表示法。 目前的支援值為 P1M（一個月）、P1Y（一年）和 P3Y（三年）。
description	String	字詞的描述。

InventoryCheckRequest

表示針對特定目錄項目檢查清查的要求。

屬性	類型​	描述
targetItems	InventoryItem 的 陣列	清查檢查將評估的目錄項目清單。
inventoryContext	索引鍵/值組	執行清查檢查所需的內容值字典。 產品的每個 SKU 都會定義執行這項作業所需的值（如果有的話）。
連結	ResourceLinks	清查檢查要求中包含的資源連結。

InventoryItem

表示清查作業中的單一專案。 此資源用於在輸入要求中指定目標專案，也用來表示清查檢查作業的輸出結果。

屬性	類型​	描述
productId	String	（必要）產品的標識碼。
skuId	String	SKU 的標識碼。 當使用此資源作為清查要求的輸入時，這個值是選擇性的。 如果未提供此值，則產品下的所有 SKU 都會被視為庫存檢查作業的目標專案。
isRestricted	Bool	指出是否已找到此專案具有限制的清查。
限制	InventoryRestriction 的 陣列	針對此專案找到的任何限制詳細數據。 只有當 isRestricted = “true” 時，才會填入此屬性。

InventoryRestriction

表示清查限制的詳細數據。 這些詳細數據僅適用於清查檢查輸出結果，不適用於輸入要求。

屬性	類型​	描述
reasonCode	String	識別限制原因的程序代碼。
description	String	清查限制的描述。
內容	索引鍵/值組	屬性的字典，可提供限制的進一步詳細數據。

BillingCycleType

具有值表示計費周期類型的 [Enum/dotnet/api/system.enum]。

值	位置	描述
未知	0	列舉初始化表達式。
每月	1	指出合作夥伴將每月收費。
每年	2	表示合作夥伴將每年收取費用。
無	3	表示不會向合作夥伴收費。 此值可用於試用專案。
一次性	4	指出合作夥伴將收取一次費用。
三年	5	表示合作夥伴每三年收取一次費用。

AttestationProperties

表示證明類型，如果需要購買，則為 。

屬性	類型​	描述
attestationType	String	表示證明類型。 Windows 365 產品將具有 Windows 365 的值。 Windows 365 證明文字是「我瞭解，每位搭配 Windows Hybrid Benefit 使用 Windows 365 商務版 的人員也必須在其主要工作裝置上安裝有效的 Windows 10/11 專業版複本。
enforceAttestation	布林值	指出購買是否需要證明。