.NET SDK のリリース ノート

  • [アーティクル]

次のリリース ノートは、Microsoft パートナー センター .NET SDK の新しいバージョンで使用できます。 .NET SDK のサンプルは GitHub にあります。 パートナー センターの .NET API リファレンス は、.NET API ブラウザーで確認できます。

重要

2023 年 6 月の時点で、最新のパートナー センター .NET SDK リリース 3.4.0 がアーカイブされるようになりました。 SDK リリースは、有用な情報が記載された readme ファイルと一緒に GitHub からダウンロードできます。

パートナーの皆様には、パートナー センター REST API を引き続き使用することをお勧めします。

バージョン 3.4.0

Microsoft パートナー センター .NET SDK v3.4.0 が利用可能になりました。 更新された GitHub サンプルもご利用いただけます。

このバージョンには、次の変更が含まれています。

トランザクションと管理

用語の終了日時プロパティを提供するために、次の API が更新されます。

Pricing object は、次の API 応答に存在します。

プロモーション

制約を公開する:

バージョン 3.3.0

Microsoft パートナー センター .NET SDK v3.3.0 が利用可能になりました。 更新された GitHub サンプルもご利用いただけます。

このバージョンには、次の変更が含まれています。

トランザクションと管理

次の API が更新され、お客様が侵害された場合 (不正行為) に対する Azure サブスクリプションの取り消しが有効になります。

次の API 応答に 'OperationId' が存在するようになりました。

新しい GDAP エラー メッセージ:

監査

次の新しいリソースの種類 'AzureEntitlement' と 'IndirectProviderIndirectResellerDap' が追加されました。

バージョン 3.2.0

Microsoft パートナー センター .NET SDK v3.2.0 が一般公開されました。 更新された GitHub サンプルもご利用いただけます。

このバージョンには、次の変更が含まれています。

.NET SDK v 3.2.0 を使用するには、パートナーに Newtonsoft.Json 13.0.1 以降が必要です。 v13.0.1 より前のバージョンでは、脆弱なバグが多くなっています。

新しい API コントラクト

NCE 移行スケジュールをサポートするために、次の API が導入されています。

API コントラクトへの更新

バージョン 3.1.2

Microsoft パートナー センター .NET SDK v3.1.2 が一般公開されました。 更新された GitHub サンプルもご利用いただけます。 このバージョンには、次の変更が含まれています。

公開契約への更新

オブジェクトに AddOnMigrations フィールドを NewCommerceEligibility 追加しました
移行のためにサブスクリプションを検証する

バージョン 3.1.1

重要

バージョン 3.1.0 は非推奨です。 .NET SDK v.3.1.0 をダウンロードしないでください

Microsoft パートナー センター .NET SDK v3.1.1 が一般公開されました。 更新された GitHub サンプルもご利用いただけます。 このバージョンには、次の変更が含まれています。

トランザクションと管理

パブリック コントラクトの新しいフィールド

スケジュールされた変更にプロモーション ID を追加する
新しいコマース サブスクリプションのスケジュールされた変更を管理する

  • Patch {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}

サブスクリプションの状態値 'disabled' に対する新しい SDK のサポート。

パートナー センター API は、v3.1.1 SDK リリースから 90 日後に新しい "無効" 状態の返しを開始します。 パートナーは、API が "無効" 状態を返す 90 日前に SDK を更新し、変更管理原則に準拠する時間を与えます。

新しい API 更新

移行されたサブスクリプションの クエリは、パートナーが特定の入力条件について移行されたすべてのサブに対してクエリを実行できる API です。

  • GET {baseURL}/v1/migrations/newcommerce

Get New Commerce migration events API は、現在のサブスクリプション ID または移行 ID に基づいて移行イベントの詳細をフェッチするために使用されます。

  • GET {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/events

バージョン 3.0.1

Microsoft パートナー センター .NET SDK v3.0.1 が一般公開されました。 更新された GitHub サンプルもご利用いただけます。 このバージョンには、次の変更が含まれています。

トランザクションと管理

パブリック コントラクトの新しいフィールド

  • POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transition
  • GET {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transitions
  • GET/PATCH {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}
    • モデルにプロパティをSubscription追加しましたRefundableQuantity
    • モデルにプロパティをScheduledNextTermInstructions追加しましたCustomTermEndDate
    • モデルにプロパティをSubscription追加しましたMigratedFromSubscriptionId
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
    • モデルにプロパティをNewCommerceMigration追加しましたAddOnMigrations
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
    • モデルにプロパティをNewCommerceMigration追加しましたAddOnMigrations
  • GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration_id}
    • モデルにプロパティをNewCommerceMigration追加しましたAddOnMigrations
  • POST {baseURL}/v1/customers/{customer_id}/carts
    • 新しい CartErrorCode 列挙型の値を追加しました
    • モデルに新しい AdditionalInformation モデルを CartError 追加しました
    • モデルにプロパティをCartLineItem追加しましたCustomTermEndDate
  • GET/PUT {baseURL}/v1/customers/{customer_id}/carts/{cart_id}
    • 新しい CartErrorCode 列挙型の値を追加しました
    • モデルに新しい AdditionalInformation モデルを CartError 追加しました
    • モデルにプロパティをCartLineItem追加しましたCustomTermEndDate
  • GET/POST {baseURL}/v1/customers/{customer_id}/orders
    • モデルにプロパティをOrderLineItem追加しましたCustomTermEndDate
  • GET/PATCH {baseURL}/v1/customers/{customer_id}/orders/{order_id}
    • モデルにプロパティをOrderLineItem追加しましたCustomTermEndDate

NCE Batch Migration Tool

大量のサブスクリプションを効率的に移行するパートナーのニーズを容易にするために、Batch Migration (BAM) ツールを有効にしました。 BAM ツールを使用すると、パートナーは次の方法を使用してサブスクリプションを NCE に移行できます。

  • .NET SDK サンプル アプリ エクスペリエンスオープンソース合理化
  • Excel を使用して移行の編集を管理する
  • 高品質、反復可能、カスタマイズ可能な移行シナリオをバッチでサポートするシンプルなツール

詳細な手順については、「New Commerce Experience Batch Migration Tool (BAM)」を参照してください。

セキュリティ

新しい API

  • パッチ {baseURL}/v1/customers/{customer-tenant-id}
    • DAP API の削除 – DAP set AllowDelegatedAccess プロパティを false に削除するには

監査と webhook

Audit Updated - "Manage Overage"、"DAP 管理 Relationship Terminated by Microsoft"、および "Azure Fraud Event Detected" の新しい操作の種類が追加されました。

リソースの監査

バージョン 3.0.0

Microsoft パートナー センター .NET SDK v3.0.0 が一般公開されました。 更新された GitHub サンプルもご利用いただけます。 このバージョンには、次の変更が含まれています。

一般的な更新

既存の互換性の問題を解決するために、System.ComponentModel.Annotations を最新の 5.0 バージョンにアップグレードします。

トランザクションと管理

新しい API

  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
  • GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration-id}
  • GET {baseURL}/customers/{customerId}/subscriptions/overage

パブリック コントラクトの新しいフィールド

  • 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
  • POST/PUT {baseURL}/v1/customers/{customer-tenant-id}/cart
  • POST {baseURL}/v1/customers/{customer-tenant-id}/orders
  • PUT {baseURL}/v1/customers/{customer-id}/carts/{cart-id}

カタログ/価格/プロモーション

新しい API

  • POST {baseURL}/v1/customers/{customerId}/promotionEligibilities
  • GET {baseURL}/v1/productpromotions/{promotion-id}?country={country-code}
  • GET {baseURL}/v1/productpromotions?country={country-code}&segment={segment}

パブリック コントラクトの新しいフィールド

  • GET {baseURL}/v1/offers/{offer-id}?country={country-code}
  • 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?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}

顧客

新しい API

  • GET {baseURL}/v1/customers/{customer-id}/validationStatus?type=account

監査と webhook

監査の更新 - SoftwareAttestation の追加とデバイスとポリシーの追加更新の新しい操作の種類を追加しました

監査リソース - パートナー センター アプリ開発者 | Microsoft Docs

  • 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?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}
  • PUT {baseURL}/customers/{customerId}/subscriptions/overage
  • GET {baseURL}/customers/{customerId}/subscriptions/overage

バージョン 2.0.1

Microsoft パートナー センター .NET SDK v2.0.1 が一般公開されました。 更新された GitHub サンプルもご利用いただけます。 このバージョンには、次の変更が含まれています。

Note

新しいコマース エクスペリエンス ("NCE") の一部として導入された変更の一部。現在は、Microsoft 365/Microsoft Dynamics 365 の新しいコマース エクスペリエンスのテクニカル プレビューの一部であるパートナーへの招待のみに基づいて利用できます。 新しいコマース プライベート プレビューに参加していないパートナーは、影響に気付かないようにし、下位互換性を持つ必要があります。

共通

  • 認証ライブラリへの参照の変更 – リファレンスは Azure Active Directory 認証ライブラリ (ADAL) から Microsoft Authentication Library (MSAL) に変更されます

    アプリケーションまたは .NET サンプルで MSAL が正しく実行されるように、次の変更を行う必要があります。

    • Mobile およびデスクトップ アプリケーションの RedirectUrl として追加 https://login.microsoftonline.com/common/oauth2/nativeclient する

    • アプリケーション構成ファイルの UserAuthentication セクションに Doメイン を追加します。

      Doメイン は、Azure AD アプリケーションが作成された Azure Active Directory doメイン またはテナント ID です

  • エラー コード – 新しいエラー コードが追加されました

    • 408: 要求のタイムアウト
    • 504: ゲートウェイのタイムアウト

課金を管理する

  • 請求書明細 - 次の API に追加された新しい属性:

    • GET /invoices/{invoice-id}/lineitems?provider={provider}&invoicelineitemtype=billinglineitems
    • GET /invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=billinglineitems

    新しい属性:

    • productQualifiers
    • subscriptionStartDate
    • subscriptionEndDate
    • referenceId
    • creditReasonCode (NCE にのみ適用)
    • promotionId

  • 毎日評価される使用状況の行項目 – 次の API に追加された新しい属性:

    • GET /invoices/{invoice-id}/lineitems?provider=onetime&invoicelineitemtype=usagelineitems

    新しい属性:

    • hasPartnerEarnedCredit (NCE にのみ適用)
    • creditType (NCE にのみ適用)
    • rateOfCredit (NCE にのみ適用)

注文の管理

  • サブスクリプション リソース – 新しいプロパティが追加されました。

    • CancellationAllowedUntilDate - (NCE にのみ適用)

  • 移行リソース (NCE にのみ適用) – 新しいプロパティが追加されました

    • FromSubscriptionId

顧客のアカウントを管理する

  • アドレス を検証する – 応答がブール値から API の新しいモデルに変更されます。

    • POST /validations/address

    新しい応答モデル:

    • AddressValidationResponse

  • お客様の修飾同期 API は非推奨です。

バージョン 1.17.0

Microsoft パートナー センター .NET SDK v1.17.0 が一般公開されました。 更新された GitHub サンプルもご利用いただけます。 このバージョンには、次の変更が含まれています。

  • 監査の更新 - 顧客が DAP を承認して終了したタイミングを把握するための新しい操作の種類を追加しました

  • 監査の更新 – 顧客ディレクトリ ロール シナリオをサポートするための新しいリソースと操作の種類が追加されました

  • 顧客アカウントへの SDK 更新 - 次の API のサポート

    • GET /customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus
    • GET /customers/{customer-tenant-id}/qualifications
    • POST /customers/{customer_id}/qualifications?code={validationCode}

  • Microsoft 365/Microsoft Dynamics 365 の新しいコマース エクスペリエンスのテクニカル プレビューの一部であるパートナーへの招待のみに基づいて現在利用できる、New Commerce の一部として導入された次の変更。 新しいコマース プライベート プレビューに参加していないパートナーは、影響に気付かず、下位互換性を持つ必要があります。

    • カタログの変更:
      • GET /products/{product-id}/skus/{sku-id}
    • 購入と管理:
      • GET /customers/{customerId}/subscriptions
      • GET /customers/{customerId}/subscriptions/{subscriptionId}
      • PATCH /customers/{customerId}/subscriptions/{subscriptionId}
      • GET /customers/{customerId}/subscriptions/{subscriptionId}/transitioneligibilities
      • GET /customers/{customerId}/subscriptions/{subscriptionId}/transitions
      • POST /customers/{customerId}/subscriptions/{subscriptionId}/transitions

バージョン 1.16.3

Microsoft パートナー センター .NET SDK v1.16.3 が一般公開されました。 更新された GitHub サンプルもご利用いただけます。 このバージョンには、次の変更が含まれています。

バージョン 1.16.2

Microsoft パートナー センター .NET SDK v1.16.2 が一般公開されました。 更新された GitHub サンプルもご利用いただけます。 このバージョンには、次の変更が含まれています。

  • 監査レコードに対してサポートされている操作の種類を更新します。 新しく追加されたものは次のとおりです。

    • CreateSelfServePolicy
    • UpdateSelfServePolicy
    • DeleteSelfServePolicy
    • RemovePartnerRelationship
    • DeleteTipCustomer
    • CreateRelatedReferral
    • UpdateRelatedReferral

  • サービス要求の作成は非推奨になりました

  • サポート トピックは非推奨になりました

バージョン 1.16.1

Microsoft パートナー センター .NET SDK v1.16.1 が一般公開されました。 更新された GitHub サンプルもご利用いただけます。 このバージョンには、次の変更が含まれています。

既存の Microsoft パートナー センター SDK を .NET Framework から .NET Standard 2.0 プラットフォームに移行しました。 この移行により、SDK は .NET Framework 4.6.1 以降を使用する既存のアプリケーションと互換性があります。 SDK では、.NET Core 2.0 以降がサポートされています。 既存のアプリケーションに移植する前に、.NET 実装のサポートを確認してください。

バージョン 1.15.3

Microsoft パートナー センター .NET SDK v1.15.3 が一般公開されました。 更新された REST API と GitHub サンプル も利用できます。 このバージョンには、次の変更が含まれています。

  • パートナー契約
  • Products
    • 次の 2 つのインターフェイスが、Microsoft.Store.PartnerCenter.Products 名前空間の下に誤って配置されました。 これで、Microsoft.Store.PartnerCenter.Customers.Products 名前空間の下に配置されます。
      • ICustomerProductByReservationScope
      • ICustomerSkuByReservationScope