Share via

.NET SDK sürüm notları

  • Makale

Aşağıdaki sürüm notları, Microsoft İş Ortağı Merkezi .NET SDK'sının yeni sürümleri için kullanılabilir. .NET SDK örneklerini GitHub'da bulabilirsiniz. İş Ortağı Merkezi .NET API başvurusunu .NET API Tarayıcısı'nda bulabilirsiniz.

Önemli

Haziran 2023 itibarıyla en son İş Ortağı Merkezi .NET SDK sürümü 3.4.0 arşivlenmiştir. SDK sürümünü, yararlı bilgiler içeren bir benioku dosyasıyla birlikte GitHub'dan indirebilirsiniz.

İş ortaklarının İş Ortağı Merkezi REST API'lerini kullanmaya devam etmesi teşvik edilir.

Sürüm 3.4.0

Microsoft İş Ortağı Merkezi .NET SDK v3.4.0 artık kullanılabilir. Güncelleştirilmiş GitHub örnekleri de mevcuttur.

Bu sürümde aşağıdaki değişiklikler bulunur:

İşlem ve yönetme

Aşağıdaki API'ler terim bitiş tarihi saat özelliklerini sağlayacak şekilde güncelleştirilir:

Pricing object şimdi aşağıdaki API yanıtında bulunur:

Promosyonlar

Kısıtlamaları kullanıma sunma:

Sürüm 3.3.0

Microsoft İş Ortağı Merkezi .NET SDK v3.3.0 artık kullanılabilir. Güncelleştirilmiş GitHub örnekleri de mevcuttur.

Bu sürümde aşağıdaki değişiklikler bulunur:

İşlem ve yönetme

Aşağıdaki API'ler, bir müşterinin güvenliği aşılırsa (dolandırıcılık) Azure aboneliği iptallerini etkinleştirecek şekilde güncelleştirilir:

'OperationId' artık aşağıdaki API yanıtlarında bulunur:

Yeni GDAP hata iletileri:

Denetle

Aşağıdakiler için yeni 'AzureEntitlement' ve 'IndirectProviderIndirectResellerDap' kaynak türü eklendi:

Sürüm 3.2.0

Microsoft İş Ortağı Merkezi .NET SDK v3.2.0 artık genel kullanıma hazırdır. Güncelleştirilmiş GitHub örnekleri de mevcuttur.

Bu sürümde aşağıdaki değişiklikler bulunur:

.NET SDK v 3.2.0'ı kullanmak için iş ortaklarının Newtonsoft.Json 13.0.1 ve üzeri olması gerekir. v13.0.1'in önceki sürümlerinde yüksek güvenlik açığı olan hatalar olduğundan.

Yeni API Sözleşmeleri

NCE geçiş zamanlamasını desteklemek için aşağıdaki API'ler kullanıma sunulmuştur:

API sözleşmesine Güncelleştirmeler

Sürüm 3.1.2

Microsoft İş Ortağı Merkezi .NET SDK v3.1.2 artık genel kullanıma hazırdır. Güncelleştirilmiş GitHub örnekleri de mevcuttur. Bu sürümde aşağıdaki değişiklikler bulunur:

Genel sözleşmeye Güncelleştirmeler

AddOnMigrations alanı nesnesine NewCommerceEligibility eklendi
Aboneliği geçiş için doğrulama

Sürüm 3.1.1

Önemli

Sürüm 3.1.0 kullanım dışıdır. .NET SDK v.3.1.0'ı indirmeyin

Microsoft İş Ortağı Merkezi .NET SDK v3.1.1 artık genel kullanıma hazırdır. Güncelleştirilmiş GitHub örnekleri de mevcuttur. Bu sürümde aşağıdaki değişiklikler bulunur:

İşlem ve yönetme

Genel sözleşmedeki yeni alan

Zamanlanmış değişikliğe yükseltme kimliği ekleme
Yeni ticaret abonelikleri için zamanlanmış değişiklikleri yönetme

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

'Devre dışı' abonelik durum değeri için yeni SDK desteği.

İş Ortağı Merkezi API'leri, v3.1.1 SDK sürümünden 90 gün sonra yeni 'devre dışı' durumlarını döndürmeye başlar. İş ortaklarının, SDK'larını güncelleştirmeleri ve değişiklik yönetimi ilkelerine uymaları için onlara zaman tanımak için API'nin "devre dışı" durumunu döndürmeden önce 90 günü vardır.

Yeni API Güncelleştirmeler

Geçirilen abonelikleri sorgulama, iş ortaklarının belirli bir giriş ölçütü için tüm geçirilen alt dosyaları sorguladığı API'dir.

  • GET {baseURL}/v1/migrations/newcommerce

Get New Commerce migration events API'si, geçerli abonelik kimliğine veya geçiş kimliğine göre geçiş olaylarının ayrıntılarını getirmek için kullanılır.

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

Sürüm 3.0.1

Microsoft İş Ortağı Merkezi .NET SDK v3.0.1 artık genel kullanıma hazırdır. Güncelleştirilmiş GitHub örnekleri de mevcuttur. Bu sürümde aşağıdaki değişiklikler bulunur:

İşlem ve yönetme

Genel sözleşmedeki yeni alan

  • 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}
    • Modele Subscription özellik eklendi RefundableQuantity
    • Modele ScheduledNextTermInstructions özellik eklendi CustomTermEndDate
    • Modele Subscription özellik eklendi MigratedFromSubscriptionId
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
    • Modele NewCommerceMigration özellik eklendi AddOnMigrations
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
    • Modele NewCommerceMigration özellik eklendi AddOnMigrations
  • GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration_id}
    • Modele NewCommerceMigration özellik eklendi AddOnMigrations
  • POST {baseURL}/v1/customers/{customer_id}/carts
    • Yeni CartErrorCode sabit listesi değerleri eklendi
    • Modele CartError yeni AdditionalInformation model eklendi
    • Modele CartLineItem özellik eklendi CustomTermEndDate
  • GET/PUT {baseURL}/v1/customers/{customer_id}/carts/{cart_id}
    • Yeni CartErrorCode sabit listesi değerleri eklendi
    • Modele CartError yeni AdditionalInformation model eklendi
    • Modele CartLineItem özellik eklendi CustomTermEndDate
  • GET/POST {baseURL}/v1/customers/{customer_id}/orders
    • Modele OrderLineItem özellik eklendi CustomTermEndDate
  • GET/PATCH {baseURL}/v1/customers/{customer_id}/orders/{order_id}
    • Modele OrderLineItem özellik eklendi CustomTermEndDate

NCE Batch Geçiş Aracı

Büyük miktarda aboneliği verimli bir şekilde geçirmek için iş ortağı gereksinimlerini kolaylaştırmak için bir Batch Geçişi (BAM) aracını etkinleştirdik. BAM aracı, iş ortaklarının aşağıdaki yaklaşımı kullanarak abonelikleri NCE'ye geçirmesine olanak tanır:

  • .NET SDK örnek uygulama deneyimi açık kaynak kolaylaştırılmış
  • Geçiş düzenlemelerini yönetmek için Excel'i kullanır
  • Toplu işlerde yüksek kalite, yinelenebilir ve özelleştirilebilir geçiş senaryolarını destekleyen basit araç

Ayrıntılı yönergeler için bkz . Yeni Ticaret Deneyimi Toplu Geçiş Aracı (BAM).

Güvenlik

Yeni API

  • {baseURL}/v1/customers/{customer-tenant-id} düzeltme eki uygulama
    • DAP API'sini kaldırma – DAP küme AllowDelegatedAccess özelliğini false olarak kaldırmak için

Denetim ve web kancası

Denetim Güncelleştirildi - "Fazla Kullanımı Yönet", "DAP Yönetici İlişkisi Microsoft Tarafından Sonlandırıldı" ve "Azure Sahtekarlık Olayı Algılandı" için yeni işlem türleri eklendi.

Kaynakları denetleme

Sürüm 3.0.0

Microsoft İş Ortağı Merkezi .NET SDK v3.0.0 artık genel kullanıma hazırdır. Güncelleştirilmiş GitHub örnekleri de mevcuttur. Bu sürümde aşağıdaki değişiklikler bulunur:

Ortak Güncelleştirmeler

Mevcut uyumluluk sorunlarını çözmek için System.ComponentModel.Annotations'ı en son 5.0 sürümüne yükseltin.

İşlem ve yönetme

Yeni 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

Genel sözleşmedeki yeni alan

  • 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}

Katalog/Fiyat/Promosyon

Yeni 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}

Genel sözleşmedeki yeni alan

  • 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}

Customer

Yeni API

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

Denetim ve web kancası

Güncelleştirilmiş Denetimi - Yazılım EkleAttestation ve Cihaz ve İlke Ekle Güncelleştirmeler için yeni işlem türleri eklendi

Kaynakları denetleme - İş Ortağı Merkezi uygulama geliştiricisi | 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

Sürüm 2.0.1

Microsoft İş Ortağı Merkezi .NET SDK v2.0.1 artık genel kullanıma hazırdır. Güncelleştirilmiş GitHub örnekleri de mevcuttur. Bu sürümde aşağıdaki değişiklikler bulunur:

Not

Yeni Ticaret Deneyimleri ("NCE") kapsamında sunulan ve şu anda yalnızca Microsoft 365/Microsoft Dynamics 365 yeni ticaret deneyimi teknik önizlemesinin parçası olan iş ortaklarının davetine bağlı olarak sunulan bazı değişiklikler. Yeni ticaret özel önizlemesinin parçası olmayan iş ortakları etkileri fark etmemelidir ve geriye dönük olarak uyumlu olmalıdır.

Yaygın

  • Kimlik doğrulama kitaplığı başvurusunda değişiklik - Başvuru Azure Active Directory Kimlik Doğrulama Kitaplığı'ndan (ADAL) Microsoft Kimlik Doğrulama Kitaplığı'na (MSAL) değiştirildi

    MSAL'nin uygulamanızda veya .NET örneğinde doğru çalıştığından emin olmak için aşağıdaki değişiklikler yapılmalıdır:

    • Mobil ve masaüstü uygulamaları için RedirectUrl olarak ekleme https://login.microsoftonline.com/common/oauth2/nativeclient

    • Uygulama yapılandırma dosyanızdaki UserAuthentication bölümüne Etki Alanı ekleyin.

      Etki alanı, Azure AD uygulamasının oluşturulduğu Azure Active Directory etki alanı veya kiracı kimliğidir

  • Hata kodları – Yeni hata kodu eklendi

    • 408: İstek zaman aşımı
    • 504: Ağ geçidi zaman aşımı

Faturalandırmayı yönetme

  • Fatura satır öğeleri - Aşağıdaki API'lere eklenen yeni öznitelikler:

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

    Yeni öznitelikler:

    • productQualifiers
    • subscriptionStartDate
    • subscriptionEndDate
    • referenceId
    • creditReasonCode (Yalnızca NCE için geçerlidir)
    • promotionId

  • Günlük derecelendirilmiş kullanım Satır öğeleri – aşağıdaki API'ye eklenen yeni öznitelikler:

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

    Yeni öznitelikler:

    • hasPartnerEarnedCredit (Yalnızca NCE için geçerlidir)
    • creditType (Yalnızca NCE için geçerlidir)
    • rateOfCredit (Yalnızca NCE için geçerlidir)

Siparişleri yönetme

  • Abonelik Kaynakları – Yeni özellik eklendi.

    • CancellationAllowedUntilDate - (Yalnızca NCE için geçerlidir)

  • Geçiş Kaynakları (Yalnızca NCE için geçerlidir) – Yeni özellik eklendi

    • FromSubscriptionId

Müşteri hesaplarını yönetme

  • Adresi doğrulama – Yanıt Boole'dan API için yeni bir modele değiştirildi:

    • POST /validations/address

    Yeni yanıt modeli:

    • AddressValidationResponse

  • Müşterinin niteleme zaman uyumlu API'si kullanım dışıdır.

Sürüm 1.17.0

Microsoft İş Ortağı Merkezi .NET SDK v1.17.0 artık genel kullanıma hazırdır. Güncelleştirilmiş GitHub örnekleri de mevcuttur. Bu sürümde aşağıdaki değişiklikler bulunur:

  • Güncelleştirilmiş Denetim - Müşterinin DAP'ı ne zaman onaylayıp sonlandırıldığını bilmek için yeni işlem türleri eklendi

  • Denetim Güncelleştirildi – Müşteri dizini rol senaryolarını desteklemek için yeni kaynak ve işlem türleri eklendi

  • SDK'nın Müşteri Hesabına Güncelleştirmeler - Aşağıdaki API'ler için destek

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

  • Yeni Ticaret kapsamında sunulan ve şu anda yalnızca Microsoft 365/Microsoft Dynamics 365 yeni ticaret deneyimi teknik önizlemesinin parçası olan iş ortaklarının davetine bağlı olarak sunulan değişikliklerden sonra. Yeni ticaret özel önizlemesinin parçası olmayan iş ortakları, etkileri fark etmemeli ve geriye dönük olarak uyumlu olmalıdır.

    • Katalog Değişiklikleri:
      • GET /products/{product-id}/skus/{sku-id}
    • Satın Alma ve Yönetme:
      • 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

Sürüm 1.16.3

Microsoft İş Ortağı Merkezi .NET SDK v1.16.3 artık genel kullanıma hazırdır. Güncelleştirilmiş GitHub örnekleri de mevcuttur. Bu sürümde aşağıdaki değişiklikler bulunur:

Sürüm 1.16.2

Microsoft İş Ortağı Merkezi .NET SDK v1.16.2 artık genel kullanıma hazırdır. Güncelleştirilmiş GitHub örnekleri de mevcuttur. Bu sürümde aşağıdaki değişiklikler bulunur:

  • Denetim Kaydı için desteklenen işlem türlerini güncelleştirin. Yeni eklenenler şunlardır:

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

  • Hizmet isteği oluşturma artık kullanım dışı bırakıldı

  • Destek konuları artık kullanım dışı bırakıldı

Sürüm 1.16.1

Microsoft İş Ortağı Merkezi .NET SDK v1.16.1 artık genel kullanıma hazırdır. Güncelleştirilmiş GitHub örnekleri de mevcuttur. Bu sürümde aşağıdaki değişiklikler bulunur:

Mevcut Microsoft İş Ortağı Merkezi SDK'sını .NET Framework'ten .NET Standard 2.0 platformuna geçirdik. Bu geçiş, SDK'nın .NET Framework 4.6.1 ve üzerini kullanan mevcut uygulamalarla uyumlu olmasını sağlar. SDK, .NET Core 2.0 ve üzerini destekler. .NET uygulama desteğini mevcut uygulamalara taşımadan önce denetleyin.

Sürüm 1.15.3

Microsoft İş Ortağı Merkezi .NET SDK v1.15.3 artık genel kullanıma hazırdır. Güncelleştirilmiş REST API'leri ve GitHub örnekleri de mevcuttur. Bu sürümde aşağıdaki değişiklikler bulunur:

  • İş Ortağı Sözleşmesi
    • Dolaylı sağlayıcıların dolaylı kurumsal bayilerin Microsoft İş Ortağı Sözleşmesi durumunu doğrulama özelliği eklendi.
  • Ürünler
    • Aşağıdaki iki arabirim Microsoft.Store.PartnerCenter.Products ad alanının altına yanlış yerleştirilmiştir. Artık Microsoft.Store.PartnerCenter.Customers.Products ad alanının altında bulunurlar.
      • ICustomerProductByReservationScope
      • ICustomerSkuByReservationScope