Share via


パートナー センター REST API の最近の変更

この記事では、パートナー センター REST API に加えられた変更の概要を示します。

2022 年 11 月

機能 変更の種類 API/オブジェクト
NCE 移行 パートナーは、API、UX、BAM ツールを使用して移行をスケジュールできるようになりました。 新しいコマース移行

をスケジュールする 新しいコマース移行

をキャンセルする 新しいコマース移行

を更新する 新しいコマース移行


の新しいコマース エクスペリエンスのバッチ移行ツールを取得する

2022 年 10 月

API の変更では、新しい機能がサポートされ、フィールド benefitOrderId、benefitId、benefitType が課金および未請求の毎日の使用状況データに追加されます。

機能 変更の種類 API/オブジェクト
セルフサービス ポリシーの機能強化 Azure の節約計画に対する新しいセルフサービス ポリシーのサポート。 セルフサービス ポリシーを作成する セルフサービス ポリシーの一覧を取得する セルフサービス ポリシーを取得する セルフサービス ポリシーリソース セルフサービス ポリシーを更新する
請求日単位の使用状況データ フィールド benefitOrderId、benefitId、および benefitType を、請求日単位の評価済み使用状況 API に追加します。 請求書の請求済み商用消費明細を取得する
未請求の日次評価使用状況データ フィールド benefitOrderId、benefitId、および benefitType を、毎日評価されていない使用状況 API に追加します。 請求未請求の商用消費明細を取得する

2022 年 9 月

PI が変更され、フィールド firstObserved と lastObserved が Fraud イベントに追加されます。

機能 変更の種類 API/オブジェクト
NCE 移行 CustomTermEndDate が移行 API に追加される 新しいコマース移行を作成する
Azure 不正行為の通知 firstObserved フィールドと lastObserved フィールドを不正行為イベントに追加する 詐欺イベントを取得する

2021 年 7 月

API の変更では、新しい機能がサポートされます。

機能 変更の種類 API/オブジェクト
昇格を伴うスケジュールされた変更 スケジュールされた変更が利用可能なプロモーションに合わせて調整されている場合は、昇格 ID を公開します。 スケジュールされた変更を作成する

2022 年 6 月

API の変更は、NCE Migration でサポート パートナーを変更します。

機能 変更の種類 API/オブジェクト
移行の検証 新しいコマース エクスペリエンスへの移行のサブスクリプションを検証する新しい API 移行のためにサブスクリプションを検証する
新しい移行を作成する 新しいコマース エクスペリエンスへのサブスクリプションの移行を作成する新しい API 新しいコマース移行を作成する
新しいコマース サブスクリプションの移行を取得する 移行の状態をチェックするために、新しいコマース エクスペリエンスへのサブスクリプションの移行を取得する新しい API 新しいコマース サブスクリプションの移行を取得する

2022 年 5 月

API は、DAP を監視し、非アクティブな DAP を削除するためのサポート パートナーを変更します。

機能 変更の種類 API/オブジェクト
DAP の削除 管理する必要がなくなった顧客との代理管理者 (DAP) 関係を削除します。 顧客との DAP 関係の削除
委任された管理リレーションシップを一覧表示する パートナーのすべての顧客の一覧を返す新しい API。顧客が DAP/DAP 以外の関係を持っているかどうかも示します 委任された管理の顧客を一覧表示する
委任された管理統計情報を取得する すべての顧客のパートナーに関連付けられている、確立またはアクティブな委任された管理者 (DAP) 関係の数に関する情報を返します。 委任された管理統計情報を取得する

2022 年 3 月

3 月の変更には、新しいコマース ライセンスベースの機能をサポートするための機能強化が含まれています。

機能 変更の種類 API/オブジェクト
DAP の削除 管理する必要がなくなった顧客との代理管理者 (DAP) 関係を削除します。 顧客との DAP 関係の削除
新しいコマース カート CartLineItem 応答に availableQuantity を追加しました プロモーション リソース
新しいコマースの移行 遷移応答に promotionId を追加しました リソースの切り替え

2021 年 12 月

12 月の変更には、新しいコマース ライセンスベースの機能をサポートするための機能強化が含まれています。

機能 変更の種類 API/オブジェクト
新しいコマース プロモーション シート数に availableSeats を追加しました プロモーション リソース
新しいコマース プロモーション シート数に availableSeats を追加しました POST {baseURL}/v1/customers/{customerId}/promotionEligibilities
Azure 不正行為の通知 新しい API 詐欺イベントを取得する
Azure 不正行為の通知 新しい API 不正アクセス イベントの状態を更新する
新しいコマース サブスクリプション ID API によるサブスクリプションの取得に refundableQuantity を追加しました ID でサブスクリプションを取得する

2021 年 10 月

10 月の変更は、新しいコマース ライセンスベースの機能と CSP の新しい ISV マージン割引をサポートすることです。

機能 変更の種類 API/オブジェクト
新しいコマース サブスクリプション管理 パブリック コントラクトの新しいフィールド PATCH {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}
新しいコマースのアップグレードと試用版の変換 パブリック コントラクトの新しいフィールド POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transition
新しいコマースの移行 パブリック コントラクトの新しいフィールド GET {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transitions
新しいコマースへの移行 新しい API POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
新しいコマースへの移行 新しい API POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
新しいコマースへの移行 新しい API GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration-id}
新しいコマースの購入 パブリック コントラクトの新しいフィールド POST {baseURL}/v1/customers/{customer-id}/orders"
新しいコマースの購入 パブリック コントラクトの新しいフィールド POST{baseURL}/v1/customers/{customer-id}/carts
新しいコマースの購入 パブリック コントラクトの新しいフィールド PUT{baseURL}/v1/customers/{customer-id}/carts/{cart-id}
新しいコマース プロモーション 新しい API POST {baseURL}/v1/customers/{customerId}/promotionEligibilities
新しいコマース プロモーション 新しい API GET {baseURL}/v1/productpromotions/{promotion-id}?country={country-code}
新しいコマース プロモーション 新しい API GET {baseURL}/v1/productpromotions?country={country-code}>segment={segment}
新しいコマース プロモーション 新しいリソース プロモーション リソース
新しいコマースのカタログ更新 パブリック コントラクトの新しいフィールド GET {baseURL}/v1/products?country={country}>targetView={targetView}>targetSegment={targetSegment}
新しいコマースのカタログ更新 パブリック コントラクトの新しいフィールド POST {baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView}
新しいコマースのカタログ更新 パブリック コントラクトの新しいフィールド GET {baseURL}/v1/products/{product-id}?country={country}
新しいコマースのカタログ更新 パブリック コントラクトの新しいフィールド POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus
新しいコマースのカタログ更新 パブリック コントラクトの新しいフィールド GET {baseURL}/v1/products/{product-id}/skus?country={country-code}>targetSegment={target-segment}
新しいコマースのカタログ更新 パブリック コントラクトの新しいフィールド GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
新しいコマースのカタログ更新 パブリック コントラクトの新しいフィールド GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities?country={country-code}>targetSegment={target-segment}
新しいコマースのカタログ更新 パブリック コントラクトの新しいフィールド POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus/{sku-id}
新しいコマースのカタログ更新 パブリック コントラクトの新しいフィールド GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code}
新しいコマースのカタログ更新 パブリック コントラクトの新しいフィールド 製品リソース
CSP の ISV マージン割引 新しいリソース Margin リソース
CSP の ISV マージン割引 新しい API GET {baseURL}/v1/margins
CSP の ISV マージン割引 新しい API GET {baseURL}/v1/margins/download
新しいコマースでの Telco 従量課金制 新しい API PUT {baseURL}/customers/{customerId}/subscriptions/overage
新しいコマースでの Telco 従量課金制 新しい API GET {baseURL}/customers/{customerId}/subscriptions/overage
新しいコマースでの Telco 従量課金制 パブリック コントラクトの新しいフィールド Sku モデルに ConsumptionType を追加する

2021 年 7 月

7 月の変更は、一部の Windows 365 SKU でのみ必要な Windows 365 構成証明をサポートすることでした。

機能 変更の種類 API/オブジェクト
Windows 365 構成証明 パブリック コントラクトの新しいフィールド SKU リソース
Windows 365 構成証明 パブリック コントラクトの新しいフィールド リソースを提供する
Windows 365 構成証明 パブリック コントラクトの新しいフィールド カートの品目リソース
Windows 365 構成証明 パブリック コントラクトの新しいフィールド GET {baseURL}/v1/products/{product-id}/skus?country={country-code}>targetSegment={target-segment}
Windows 365 構成証明 パブリック コントラクトの新しいフィールド GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
Windows 365 構成証明 パブリック コントラクトの新しいフィールド PUT {baseURL}/v1/customers/{customer-id}/carts/{cart-id} HTTP/1.1

2020 年 12 月

2 つの新しい GET および POST 修飾 API が導入されました。 新しい API では、修飾ではなく、修飾が使用されます。 API は、21 年度第 2 四半期にテストに使用できるようになります。

機能 変更の種類 API/オブジェクト
顧客の資格 新しい API GET {baseURL}/v1/customers/{customer-tenant-id}/qualifications
顧客の資格 新しい API POST {baseURL}/v1/customers/{customer_id}/qualifications?code={validationCode}

どのような点が変わりましたか?

現在、パートナー センター API には、教育機関のお客様の資格を確認するための GET および PUT の資格があります。 GET Qualification API に変更はありません。 ただし、PUT Qualification API にリターン ケースを追加しました。

  • GET - 変更されません。
  • PUT - 戻り値のケースが追加されます。

これらの API は 2021 年 2 月末に廃止され、以下で説明するように新しい API に置き換えられます。

影響を受けたシナリオ:

一部の SKU での教育機関向け価格に対する顧客の資格

詳細な説明

2 つの新しい GET および POST 修飾 API が導入されます。 新しい API では、修飾ではなく、修飾使用されます。 API は、21 年度第 2 四半期にテストに使用できるようになります。

GET の資格

GET {customer_id}/qualifications

応答の例:

{
  "Qualification": "Education",
  "VettingStatus": "Denied",
  "VettingReason": "Not an education customer",
  "VettingCreatedDate": "07/09/2020: 00:00:00" //UTC
}

応答フィールド:

  • VettingStatus 値: Approved、Denied、InReview など。

  • VettingReason 値:

    • 教育機関のお客様ではない
    • 教育機関のお客様ではなくなりました
    • 教育機関のお客様ではない - レビュー後
    • 教育機関のお客様に制限がある
    • 学術的な仕事ではありませんメイン
    • 対象となるライブラリではありません
    • 対象の博物館ではありません

POST 資格

POST {customer_id}/qualifications
    [
            "Qualification": "Education"
    ]

応答の例:

{
  "Qualification": "Education",
  "VettingStatus": "InReview",
  "VettingCreatedDate": "07/09/2020: 00:00:00" //UTC
}

次のステップ

パートナー センター REST API リファレンス