プロモーション リソース
適用対象
- パートナー センター
適切なロール
- 管理エージェント
Note
ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。
新しいコマース サブスクリプションのトランザクションに適用されるプロモーションのリソースについて説明します。
プロモーション
資格条件が満たされている場合に製品 SKU を購入するときに適用される割引。
| プロパティ | タイプ | 説明 |
|---|---|---|
| id | string | 昇格識別子。 |
| name | string | プロモーションのフレンドリ名。 |
| description | string | プロモーションの説明。 |
| startDate | string | プロモーションが適用される開始日。 |
| endDate | string | プロモーションが適用される終了日。 |
| requiredProducts | requiredProducts の一覧 | プロモーションが適用される製品、SKU の詳細、および価格ポリシー。 |
| properties | プロパティの一覧 | 昇格が自動適用されるかどうかなど、昇格のプロパティ。 |
RequiredProducts
プロモーションが適用される製品、SKU の詳細、および価格ポリシー。
| プロパティ | タイプ | 説明 |
|---|---|---|
| productId | string | プロモーションが利用可能な製品の識別子。 |
| skuId | string | プロモーションが利用できる SKU の識別子。 |
| の用語 | Term | 期間期間やプロモーション支払いサイクルを含む用語を使用できます。 |
| pricingPolicies | pricingPolicies の一覧 | プロモーション割引の種類と値を定義するポリシーの一覧。 |
Term
プロモーションを購入できる用語を表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| 期間 | string | 期間の ISO 8601 表現。 現在サポートされている値は、P1M (1 か月)、P1Y (1 年)、P3Y (3 年) です。 |
| billingCycle | string | プロモーションが課金に適用される頻度について説明します。 値には、Monthly、Annual、OneTime、または Unknown を含めることができます。 |
PricingPolicies
プロモーション割引の種類と値について説明します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| type | string | 割引がパーセンテージに基づいているか、定額割引に基づいているかを説明します。 |
| 値 | string | 適用される割引の金額を定義します。 |
プロパティ
昇格のプロパティ。
| プロパティ | タイプ | 説明 |
|---|---|---|
| isAutoApplicable | [bool] | 昇格が自動的に適用されるかどうか、またはパートナーがプロモーションを渡す必要があるかどうかを示します。 |
PromotionEligibilitiesRequestItem
トランザクションとプロモーションの適格性を表すプロパティ。
| プロパティ | タイプ | 説明 |
|---|---|---|
| id | int | プロモーションの対象項目識別子。 |
| catalogItemId | string | 昇格が適用されるカタログ アイテム識別子。 製品 ID、SKU ID、および可用性 ID が含まれます。 |
| quantity | int | ライセンスまたはインスタンスの数。 |
| termDuration | string | 期間の ISO 8601 表現。 現在サポートされている値は、P1M (1 か月)、P1Y (1 年)、P3Y (3 年) です。 |
| billingCycle | string | プロモーションが課金に適用される頻度について説明します。 値には、Monthly、Annual、OneTime、または Unknown を含めることができます。 |
| promotionID | string | 昇格識別子。 |
PromotionEligibilities
製品、SKU、およびプロモーションの対象の一覧。
| プロパティ | タイプ | 説明 |
|---|---|---|
| id | int | プロモーションの対象項目識別子。 |
| catalogItemId | string | 昇格が適用されるカタログ アイテム識別子。 製品 ID、SKU ID、および可用性 ID が含まれます。 |
| quantity | int | ライセンスまたはインスタンスの数。 |
| termDuration | string | 期間の ISO 8601 表現。 現在サポートされている値は、P1M (1 か月)、P1Y (1 年)、P3Y (3 年) です。 |
| billingCycle | string | プロモーションが課金に適用される頻度について説明します。 値には、Monthly、Annual、OneTime、Unknown を含めることができます。 |
| eligibilities | PromotionEligibilities の一覧 | 昇格の適格性の結果の一覧を表します。 |
PromotionEligibility
製品、SKU、およびプロモーションの対象の一覧。
| プロパティ | タイプ | 説明 |
|---|---|---|
| promotionId | string | 昇格識別子。 |
| isEligible | [bool] | 昇格が特定の適格性要求項目の対象かどうかを説明します。 |
| エラー | PromotionEligibilityErrors の一覧 | 昇格の資格要求項目が対象ではなかった理由を説明するエラー。 |
PromotionEligibilityError
昇格の資格要求項目が対象ではなかった理由について説明します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| type | string | 昇格の適格性エラーの種類には、InvalidCatalogItemId、InvalidPromotion、PrerequisiteProductOwnership、RedemptionLimit、SeatCount、OfferPurchasedPreviously、または Term を含めることができます。 |
| description | string | 昇格が特定の適格性要求項目の対象かどうかを説明します。 |
RedemptionLimitPromotionEligibilityError
引き換え制限を超えた理由の詳細が含まれます。
| プロパティ | タイプ | 説明 |
|---|---|---|
| maxPromotionRedemptionCount | int | 昇格を取得できる最大回数。 |
| remainingPromotionRedemptionCount | int | プロモーションを取得できる残りの回数。 |
SeatCountPromotionEligibilityError
シート数の上限を超えた理由の詳細が含まれます。 すべての値は null 許容です。
| プロパティ | タイプ | 説明 |
|---|---|---|
| minimumRequiredSeats | int | プロモーションでサポートされる最小ライセンス。 |
| maximumRequiredSeats | int | プロモーションでサポートされる最大ライセンス数。 |
| availableSeats | int | パートナーが特定のプロモーションに対して取得できる残りのライセンス数。 |
TermPromotionEligibilityError
昇格期間が受け入れられなかった理由の詳細が含まれます。
| プロパティ | タイプ | 説明 |
|---|---|---|
| eligibleTerms | PromotionTerm | プロモーションがサポートする対象の条件。 |
PromotionTerm
シート数の上限を超えた理由の詳細が含まれます。
| プロパティ | タイプ | 説明 |
|---|---|---|
| billingCycle | string | プロモーションが課金に適用される頻度について説明します。 値には、Monthly、Annual、OneTime、Unknown を含めることができます。 |
| 期間 | string | 購入中の期間。 |