.NET SDK sürüm notları

  • Makale
  • Okumak için 4 dakika

Aşağıdaki sürüm notları, Microsoft Iş ortağı merkezi .NET SDK 'sınınyeni sürümlerinde kullanılabilir. GitHub için .NET SDK örnekleri bulabilirsiniz. .NET API tarayıcısında Iş ortağı merkezi .NET API başvurusunu bulabilirsiniz.

Sürüm 3.0.0

Microsoft Iş ortağı merkezi .NET SDK v 3.0.0 artık genel kullanıma sunulmuştur. güncelleştirilmiş GitHub örnekleri de mevcuttur. Bu sürüme aşağıdaki değişiklikler dahildir:

Ortak güncelleştirmeler

Mevcut uyumluluk sorunlarını gidermek için System. ComponentModel. Not açıklamalarını en son 5,0 sürümüne yükseltin.

Transact ve Yönet

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

Ortak sözleşmede 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}

Ortak sözleşmede 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}

Müşteri

Yeni API

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

Denetim ve Web kancası

Denetim, SoftwareAttestation ekleme ve cihaz ve Ilke güncelleştirmeleri ekleme için güncelleştirilmiş yeni işlem türleri eklendi

Kaynakları denetleme-Iş 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 Iş ortağı merkezi .NET SDK v 2.0.1 artık genel kullanıma sunulmuştur. güncelleştirilmiş GitHub örnekleri de mevcuttur. Bu sürüme aşağıdaki değişiklikler dahildir:

Not

Yeni ticari deneyimler ("NCE") kapsamında tanıtılan bazı değişiklikler, yalnızca M365/D365 yeni ticaret deneyimi Technical Preview 'ın parçası olan iş ortakları için davet temel alınarak kullanılabilir. Yeni ticaret özel önizlemesinin parçası olmayan iş ortakları, etkileri fark etmez ve geriye dönük olarak uyumlu olmalıdır.

Common

  • kimlik doğrulama kitaplığı başvurusunda değişiklik – başvuru, Azure Active Directory kimlik doğrulaması kitaplığı (ADAL) ile Microsoft kimlik doğrulama kitaplığı (MSAL) olarak değiştirilir

    MSAL uygulamasının uygulamanızda veya .NET örneğinde düzgün çalışmasını sağlamak için aşağıdaki değişiklikler yapılmalıdır:

    • https://login.microsoftonline.com/common/oauth2/nativeclientMobil ve Masaüstü uygulamaları Için RedirectUrl olarak ekleyin

    • 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: istek zaman aşımı
    • 504: ağ geçidi zaman aşımı

Faturalandırmayı yönetme

  • Fatura satırı-öğeler -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:

    • Productniteleyiciler
    • subscriptionStartDate
    • subscriptionEndDate
    • Referenceıd
    • creditReasonCode (yalnızca NCE için geçerlidir)
    • Promotionıd

  • Günlük dereceli kullanım satırı-öğeler – aşağıdaki API 'ye eklenen yeni öznitelikler:

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

    Yeni öznitelikler:

    • Haspartnerearnedkredisi (yalnızca NCE için geçerlidir)
    • creditType (yalnızca NCE için geçerlidir)
    • Rateofkredisi (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

    • Fromsubscriptionıd

Müşteri hesaplarını yönetme

  • Adresi doğrulama – yanıt, Boole değerinden API için yeni bir modele değiştirilir:

    • POST /validations/address

    Yeni yanıt modeli:

    • AddressValidationResponse

  • Müşterinin nitelik zaman uyumlu API 'SI kullanım dışıdır.

Sürüm 1.17.0

Microsoft Iş ortağı merkezi .NET SDK v 1.17.0 artık genel kullanıma sunulmuştur. güncelleştirilmiş GitHub örnekleri de mevcuttur. Bu sürüme aşağıdaki değişiklikler dahildir:

  • Denetim güncelleştirildi-müşterinin ne zaman onayladığı ve sonlandırıldığı hakkında yeni işlem türleri eklendi

  • Denetim güncelleştirildi – müşteri dizin rolü senaryosunu desteklemek için yeni kaynak ve işlem türleri eklendi

  • Müşteriler için SDK güncelleştirmeleri hesabı-aşağıdaki API 'leri destekler

    • /Customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus al
    • /Customers/{Customer-Tenant-ID}/nitelikler al
    • /Customers/{customer_id}/nitelikler SONRASı? Code = {validationCode}

  • Şu anda, yalnızca M365/D365 yeni ticaret deneyimi teknik önizlemesinin parçası olan iş ortakları için yapılan davet temelinde mevcut olan yeni ticaretin bir parçası olarak tanıtılan değişiklikler. Yeni ticaret özel önizlemesinin parçası olmayan iş ortakları, etkileri fark etmez ve geriye dönük olarak uyumlu olmalıdır.

    • Katalog değişiklikleri:
      • /Products/{product-id}/SKUs/{SKU-id} al
    • Satın alın ve yönetin:
      • /Customers/{CustomerID}/abonelikleri al
      • /Customers/{CustomerID}/Subscriptions/{SubscriptionID} al
      • PATCH/Customers/{CustomerID}/Subscriptions/{SubscriptionID}
      • /Customers/{CustomerID}/Subscriptions/{SubscriptionID}/geçişli tioneligılıklara al
      • /Customers/{CustomerID}/Subscriptions/{SubscriptionID}/geçişlerini al
      • POST/Customers/{CustomerID}/Subscriptions/{SubscriptionID}/geçişlerin

Sürüm 1.16.3

Microsoft Iş ortağı merkezi .NET SDK v 1.16.3 artık genel kullanıma sunulmuştur. güncelleştirilmiş GitHub örnekleri de mevcuttur. Bu sürüme aşağıdaki değişiklikler dahildir:

Sürüm 1.16.2

Microsoft İş Ortağı Merkezi .NET SDK v1.16.2 genel kullanılabilirlik özelliğine sahip. Güncelleştirilmiş GitHub örnekleri de kullanılabilir. Bu sürümde aşağıdaki değişiklikler yer almaktadır:

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

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

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

  • Destek konuları artık kullanım dışıdır

Sürüm 1.16.1

Microsoft İş Ortağı Merkezi .NET SDK v1.16.1 genel kullanılabilirlik özelliğine sahip. Güncelleştirilmiş GitHub örnekleri de kullanılabilir. Bu sürümde aşağıdaki değişiklikler yer almaktadır:

Mevcut Microsoft İş Ortağı Merkezi SDK'sı'.NET Framework .NET Standard 2.0 platformuna geçirildi. Bu, SDK'nın .NET Framework 4.6.1 ve üzerini kullanarak mevcut uygulamalarla uyumlu hale gelecektir. SDK, .NET Core 2.0 ve üzerini destekleyecektir. Mevcut uygulamalara bağlantı noktası olmadan önce .NET uygulama desteğini kontrol edin.

Sürüm 1.15.3

Microsoft İş Ortağı Merkezi .NET SDK v1.15.3 artık genel kullanılabilirlik özelliğidir. Güncelleştirilmiş REST API'GitHub örnekleri de kullanılabilir. Bu sürümde aşağıdaki değişiklikler yer almaktadır:

  • İş Ortağı Sözleşmesi
  • Ürünler
    • Aşağıdaki iki arabirim Yanlış şekilde Microsoft.Store.PartnerCenter.Products ad alanına yerleştirildi. Artık Microsoft.Store.PartnerCenter.Customers.Products ad alanı altında bulunuyorlar.
      • ICustomerProductByReservationScope
      • ICustomerSkuByReservationScope