Share via

.NET SDK 版本資訊

  • 發行項

下列版本資訊適用於新版的 Microsoft 合作夥伴中心 .NET SDK。 您可以在 GitHub 上找到 .NET SDK 範例 。 您可以在 .NET API 瀏覽器中找到 合作夥伴中心 .NET API 參考 。

重要

自 2023 年 6 月起，最新的合作夥伴中心 .NET SDK 3.4.0 版現已封存。 您可以從 GitHub 下載 SDK 版本，以及 包含實用資訊的自述檔 。

鼓勵合作夥伴繼續使用 合作夥伴中心 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 訂用帳戶取消功能（詐騙）：

'OperationId' 現在會出現在下列 API 回應中：

新的 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 之前的版本有高弱點 Bug。

新的 API 合約

引進下列 API 以支援 NCE 移轉排程：

#DCFAE083A09F54CD9930F3143208F9153 至 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 範例。 下列變更包含在此版本中：

交易和管理

公用合約中的新欄位

將升級標識元新增至排程變更
管理新商務訂閱的排程變更

  • 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

取得新的商務移轉事件 API 可用來根據目前的訂用帳戶標識碼或移轉標識符來擷取移轉事件的詳細數據。

  • 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}
    • 已將 屬性新增 RefundableQuantity 至 Subscription 模型
    • 已將 屬性新增 CustomTermEndDate 至 ScheduledNextTermInstructions 模型
    • 已將 屬性新增 MigratedFromSubscriptionId 至 Subscription 模型
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
    • 已將 屬性新增 AddOnMigrations 至 NewCommerceMigration 模型
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
    • 已將 屬性新增 AddOnMigrations 至 NewCommerceMigration 模型
  • GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration_id}
    • 已將 屬性新增 AddOnMigrations 至 NewCommerceMigration 模型
  • POST {baseURL}/v1/customers/{customer_id}/carts
    • 已新增新的 CartErrorCode 列舉值
    • 已將新的 AdditionalInformation 模型新增至 CartError 模型
    • 已將 屬性新增 CustomTermEndDate 至 CartLineItem 模型
  • GET/PUT {baseURL}/v1/customers/{customer_id}/carts/{cart_id}
    • 已新增新的 CartErrorCode 列舉值
    • 已將新的 AdditionalInformation 模型新增至 CartError 模型
    • 已將 屬性新增 CustomTermEndDate 至 CartLineItem 模型
  • GET/POST {baseURL}/v1/customers/{customer_id}/orders
    • 已將 屬性新增 CustomTermEndDate 至 OrderLineItem 模型
  • GET/PATCH {baseURL}/v1/customers/{customer_id}/orders/{order_id}
    • 已將 屬性新增 CustomTermEndDate 至 OrderLineItem 模型

NCE 批次移轉工具

為了協助合作夥伴有效率地移轉大量訂用帳戶的需求，我們已啟用 Batch 移轉 （BAM） 工具。 BAM 工具可讓合作夥伴使用下列方法將訂用帳戶移轉至 NCE：

  • 簡化 開放原始碼 .NET SDK 範例應用程式體驗
  • 使用 Excel 管理移轉編輯
  • 簡單的工具，可批次支持高品質、可重複且可自定義的移轉案例

如需詳細指示，請參閱 新的商務體驗批次移轉工具 （BAM） 。

安全性

新增 API

  • 修補程序 {baseURL}/v1/customers/{customer-tenant-id}
    • 拿掉 DAP API – 若要將 DAP 設定 AllowDelegatedAccess 屬性移除為 false

稽核和 Webhook

稽核更新 - 已新增「管理超額」、「DAP 管理員 Microsoft 終止的關聯性」和「偵測到 Azure 詐騙事件」的新作業類型。

稽核資源

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 範例。 下列變更包含在此版本中：

注意

目前僅邀請屬於 Microsoft 365/Microsoft Dynamics 365 新商務體驗技術預覽的合作夥伴，推出一些新商務體驗（「NCE」的變更。 不屬於新商務私人預覽版的合作夥伴不應該注意到影響，而且應該回溯相容。

常見

  • 對驗證連結庫的參考變更 – 參考已從 Azure Active Directory 驗證連結庫 （ADAL） 變更為 Microsoft 驗證連結庫 （MSAL）

    應該進行下列變更，以確保 MSAL 會在您的應用程式或 .NET 範例上正確執行：

    • 新增 https://login.microsoftonline.com/common/oauth2/nativeclient 為Mobile和Desktop應用程式的RedirectUrl

    • 將網域新增至應用程式組態檔中的UserAuthentication區段。

      網域是建立 Azure AD 應用程式的 Azure Active Directory 網域或租使用者標識符

  • 錯誤碼 – 新增錯誤碼

    • 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 新商務體驗技術預覽的合作夥伴，推出新商務的變更。 不屬於新商務私人預覽版的合作夥伴不應該注意到影響，而且應該回溯相容。

    • 目錄變更：
      • 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 實作支援移植到現有的應用程式之前，請先檢查 .NET 實作支援 。

1.15.3 版

Microsoft 合作夥伴中心 .NET SDK v1.15.3 現已正式推出。 您也可以使用更新的 REST API 和 GitHub 範例 。 下列變更包含在此版本中：

  • 合作夥伴合約
    • 已新增間接提供者驗證間接轉銷商 Microsoft 合作夥伴合約 狀態的功能。
  • 產品
    • 下列兩個介面錯誤地放在 Microsoft.Store.PartnerCenter.Products 命名空間之下。 現在，它們位於 Microsoft.Store.PartnerCenter.Customers.Products 命名空間底下。
      • ICustomerProductByReservationScope
      • ICustomerSkuByReservationScope