製品リソース

  • [アーティクル]

購入可能な商品またはサービスを表すリソース。 製品の種類と形状 (SKU) を説明し、在庫内の製品の可用性をチェックするためのリソースが含まれています。

Product

購入可能な商品またはサービスを表します。 製品自体は購入可能なアイテムではありません。

プロパティ タイプ 説明
id String 製品の ID。
タイトル String 製品のタイトル。
description String 製品の説明です。
productType アイテムの種類 この製品の型分類を記述するオブジェクト。
isMicrosoftProduct Bool 製品が Microsoft 製品かどうかを示します。
publisherName String 製品の発行元の名前 (使用可能な場合)。
リンク ProductLinks 製品に含まれるリソース リンク。

アイテムの種類

製品の種類を表します。

プロパティ タイプ 説明
id String 型識別子。
displayName String 項目の種類の表示名。
SubType アイテムの種類 省略可能。 項目の種類のサブタイプの分類を記述するオブジェクト。

製品のリンクの一覧が含まれています。

プロパティ タイプ 説明
skus リンク 基になる SKU にアクセスするためのリンク。
リンク ResourceLinks リソース内に含まれるリソース リンク。

Sku

製品の購入可能な在庫保管単位 (SKU) を表します。

プロパティ タイプ 説明
id String SKU の ID。 ID は、親製品のコンテキスト内でのみ一意です。
タイトル String SKU のタイトル。
description String SKU の説明。
productId String SKU を含む親 製品 の ID。
minimumQuantity int 購入可能な最小数量。
maximumQuantity int 購入可能な最大数量。
試用版です Bool SKU が試用版アイテムかどうかを示します。
supportedBillingCycles 文字列の配列 SKU でサポートされている支払いサイクルの一覧。 サポートされる値は、BillingCycleType で検出されたメンバー名です。
purchasePrerequisites 文字列の配列 品目を購入する前に必要な前提条件ステップまたはアクションの一覧。 サポートされる値は次のとおりです。
"InventoryCheck" - アイテムを購入する前に、品目の在庫を評価する必要があることを示します。
"AzureSubscriptionRegistration" - Azure サブスクリプションが必要であり、アイテムの購入を試みる前に登録する必要があることを示します。
inventoryVariables 文字列の配列 アイテムに対してインベントリ チェックを実行するために必要な変数の一覧。 サポートされる値は次のとおりです。
"CustomerId" - 購入対象となる顧客の ID。
"AzureSubscriptionId" - Azure 予約購入に使用される Azure サブスクリプションの ID。
"ArmRegionName" - インベントリを検証するリージョン。 この値は、SKU の DynamicAttributes の "ArmRegionName" と一致する必要があります。
provisioningVariables 文字列の配列 アイテムを購入するときにカートの品目のプロビジョニング コンテキストに指定する必要がある変数の一覧。 サポートされる値は次のとおりです。
スコープ - Azure 予約購入のスコープ: "Single"、"Shared"。
"SubscriptionId" - Azure 予約購入に使用される Azure サブスクリプションの ID。
"Duration" - Azure 予約の期間: "1Year"、"3Year"。
dynamicAttributes キーと値のペア 項目に適用される動的プロパティのディクショナリ。 ディクショナリ内のプロパティは動的であり、予告なしに変更される可能性があります。 パートナーは、プロパティの値に存在する特定のキーに強い依存関係を作成しないようにする必要があります。
リンク ResourceLinks SKU に含まれるリソース リンク。
AttestationProperties AttestationProperties SKU の構成証明プロパティ。
consumptionType String SKU が超過分などの消費をサポートしている場合にのみ使用できます。
specializedOfferProperties specializedOfferProperties の一覧 製品が SpecializedOffer の subType である場合にのみ使用できます。
minimumPurchaseCommitment MinimumPurchaseCommitment コンピューティング サービスでコミットされた固定金額。

動的 SKU 属性

新しいコマース ライセンス ベースの製品とサービスに関連する注目すべきプロパティ。

Note

ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。

プロパティ タイプ 説明
hasConstraints Boolean SKU に assetContraints が含まれているかどうかを説明します
isAddon Boolean SKU がアドオンであるかどうかを説明します
prerequisiteSkus 文字列の配列 アドオンが使用できる製品と SKU について説明します
upgradeTargetOffers 文字列の配列 項目をアップグレードできる製品と SKU の一覧
conversionInstructions conversionInstructions の一覧 変換操作に適用できる手順の一覧

specializedOfferProperties

Note

ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。

製品サブタイプ "SpecializedOffers" にのみ適用されます

プロパティ タイプ 説明
startDate String 指示が適用される用語 ID
endDate String 更新を定義するオプション
pricingPolicies pricingPolicies の一覧 プロモーション割引の種類と値を定義するポリシーの一覧。

MinimumPurchaseCommitment

コンピューティング サービスでコミットできる最小量の属性。

プロパティ タイプ 説明
穀物 String 最小購入コミットメントの期間。
currencyCode ディクショナリ<文字列、文字列> コミットできる最小金額の "currency" と "symbol" です。
金額 int コンピューティング サービスでコミットできる最小量。

PricingPolicies

プロモーション割引の種類と値について説明します。

プロパティ タイプ 説明
type String 割引がパーセンテージに基づいているか、定額割引に基づいているかを説明します。
値 String 適用される割引の金額を定義します。

可用性

SKU を購入できる構成 (国/地域、通貨、業界セグメントなど) を表します。

プロパティ タイプ 説明
id String この可用性の ID。 この ID は、親 製品 と SKU のコンテキスト内でのみ一意です。 注 : 可用性 ID は時間の経過と同時に変化する可能性があります。 パートナーは、取得後の短い期間内にのみこの値に依存する必要があります。
productId String この可用性を 含む製品 の ID。
skuId String この可用性を 含む SKU の ID。
catalogItemId String カタログ内のこのアイテムの一意識別子。 この ID は、親 SKU を購入するときに OrderLineItem.OfferId プロパティまたは CartLineItem.CatalogItemId プロパティに入力する必要があります。 注: この ID は時間の経過と同時に変更される可能性があります。 この値は、取得後短時間でのみ使用する必要があります。 購入時にのみアクセスして使用する必要があります。
defaultCurrency String この可用性でサポートされている既定の通貨。
セグメント String この可用性の業界セグメント。 サポートされる値は、商用、教育、政府機関、非Profit です。
country String この可用性が適用される国または地域 (ISO の国コード形式)。
isPurchasable Bool この可用性が購入可能かどうかを示します。
isRenewable Bool この可用性が更新可能かどうかを示します。
RenewalInstructions RenewalInstruction 特定の可用性の更新手順を表します。
product 製品 この可用性が対応する製品。
sku SKU この可用性が対応する SKU。
terms 用語リソースの配列 この可用性に適用される用語のコレクション。
リンク ResourceLinks 可用性に含まれるリソース リンク。

更新の指示

Note

ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。

特定の可用性の更新手順を表します。

プロパティ タイプ 説明
applicableTermIds 文字列の配列 指示が適用される用語 ID
RenewalOptions RenewalOption の配列 更新を定義するオプション

RenewalOption

Note

ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。

特定の可用性の更新手順を表します。

プロパティ タイプ 説明
renewToId String 更新する製品と SKU を表します。
isAutoRenewable Bool 可用性を自動更新できるかどうか

用語

可用性を購入できる用語を表します。

プロパティ タイプ 説明
期間 String 期間の ISO 8601 表現。 現在サポートされている値は、P1M (1 か月)、P1Y (1 年)、P3Y (3 年) です。
description String 用語の説明。

InventoryCheckRequest

特定のカタログ アイテムに対してインベントリをチェックする要求を表します。

プロパティ タイプ 説明
targetItems InventoryItem の 配列 インベントリチェックが評価するカタログ アイテムの一覧。
inventoryContext キーと値のペア。 インベントリチェックを実行するために必要なコンテキスト値のディクショナリ。 製品の各 SKU は、この操作を実行するために必要な値 (ある場合) を定義します。
リンク ResourceLinks インベントリチェック要求に含まれるリソース リンク。

InventoryItem

インベントリチェック操作の 1 つの項目を表します。 このリソースは、入力要求でターゲット項目を指定するために使用され、インベントリチェック操作の出力結果を表すためにも使用されます。

プロパティ タイプ 説明
productId String (必須)製品の ID。
skuId String SKU の ID。 このリソースをインベントリ要求への入力として使用する場合、この値は省略可能です。 この値が指定されていない場合、製品のすべての SKU は、在庫チェック操作のターゲット項目と見なされます。
isRestricted Bool このアイテムに制限付きインベントリが見つかったかどうかを示します。
制限 InventoryRestriction の 配列 この項目に対して検出された制限の詳細。 このプロパティは、isRestricted = "true" の場合にのみ設定されます。

InventoryRestriction

インベントリ制限の詳細を表します。 これらの詳細は、入力要求ではなく、インベントリチェック出力結果にのみ適用されます。

プロパティ タイプ 説明
reasonCode String 制限の理由を識別するコード。
description String インベントリ制限の説明。
properties キーと値のペア。 制限の詳細を提供できるプロパティのディクショナリ。

BillingCycleType

支払いサイクルの型を示す値を持つ [Enum/dotnet/api/system.enum)。

Value 位置 説明
Unknown 0 列挙型初期化子。
月ごと 1 パートナーが毎月課金されることを示します。
年単位 2 パートナーが毎年課金されることを示します。
なし 3 パートナーが課金されないことを示します。 この値は、試用版アイテムに使用できます。
OneTime 4 パートナーに 1 回課金されることを示します。
トリエンナーレ 5 パートナーが 3 年ごとに課金されることを示します。

AttestationProperties

構成証明の種類と、購入に必要な場合を表します。

プロパティ タイプ 説明
attestationType String 構成証明の種類を示します。 Windows 365 製品の値は Windows 365 になります。 Windows 365 構成証明のテキストは、「Windows ハイブリッド特典で Windows 365 Business を使用する各ユーザーも、プライマリ ワーク デバイスに Windows 10/11 Pro の有効なコピーをインストールする必要があることを理解しています」です。
enforceAttestation Boolean 購入に構成証明が必要かどうかを示します。