Informacje o wersji zestawu .NET SDK

  • Artykuł

Poniższe informacje o wersji są dostępne dla nowych wersji zestawu MICROSOFT Partner Center .NET SDK. Przykłady zestawu .NET SDK można znaleźć w witrynie GitHub. Dokumentacja interfejsu API .NET Centrum partnerskiego znajduje się w przeglądarce interfejsu API platformy .NET.

Ważne

Od czerwca 2023 r. najnowsza wersja zestawu .NET SDK Centrum partnerskiego 3.4.0 jest teraz archiwizowana. Możesz pobrać wersję zestawu SDK z usługi GitHub wraz z plikiem readme zawierającym przydatne informacje.

Zachęcamy partnerów do dalszego korzystania z interfejsów API REST Centrum partnerskiego.

Wersja 3.4.0

Zestaw .NET SDK programu Microsoft Partner Center w wersji 3.4.0 jest teraz dostępny. Dostępne są również zaktualizowane przykłady usługi GitHub.

W tej wersji uwzględniono następujące zmiany:

Transakcje i zarządzanie

Następujące interfejsy API są aktualizowane w celu zapewnienia właściwości daty zakończenia terminu:

Pricing object Jest teraz obecny w poniższej odpowiedzi interfejsu API:

Promocje

Uwidaczniaj ograniczenia:

Wersja 3.3.0

Zestaw .NET SDK programu Microsoft Partner Center w wersji 3.3.0 jest teraz dostępny. Dostępne są również zaktualizowane przykłady usługi GitHub.

W tej wersji uwzględniono następujące zmiany:

Transakcje i zarządzanie

Następujące interfejsy API są aktualizowane w celu włączenia anulowania subskrypcji platformy Azure w przypadku naruszenia zabezpieczeń klienta (oszustwa):

Element "OperationId" jest teraz obecny w poniższych odpowiedziach interfejsu API:

Nowe komunikaty o błędach GDAP:

Audit

Dodano nowy typ zasobu "AzureEntitlement" i "IndirectProviderIndirectResellerDap" dla następujących elementów:

Wersja 3.2.0

Zestaw .NET SDK programu Microsoft Partner Center w wersji 3.2.0 jest teraz ogólnie dostępny. Dostępne są również zaktualizowane przykłady usługi GitHub.

W tej wersji uwzględniono następujące zmiany:

Aby korzystać z zestawu .NET SDK w wersji 3.2.0, partnerzy muszą mieć pakiet Newtonsoft.Json 13.0.1 i nowsze. Ponieważ wersje wcześniejsze niż wersja 13.0.1 mają wysoce podatne na zagrożenia błędy.

Nowe kontrakty interfejsów API

Wprowadzono następujące interfejsy API do obsługi harmonogramu migracji usługi NCE:

Aktualizacje do kontraktu interfejsu API

Wersja 3.1.2

Zestaw .NET SDK programu Microsoft Partner Center w wersji 3.1.2 jest teraz ogólnie dostępny. Dostępne są również zaktualizowane przykłady usługi GitHub. W tej wersji uwzględniono następujące zmiany:

Aktualizacje do umowy publicznej

AddOnMigrations Dodano pole do NewCommerceEligibility obiektu
Weryfikowanie subskrypcji na potrzeby migracji

Wersja 3.1.1

Ważne

Wersja 3.1.0 jest przestarzała. Nie pobieraj zestawu .NET SDK w wersji 3.1.0

Zestaw .NET SDK programu Microsoft Partner Center w wersji 3.1.1 jest teraz ogólnie dostępny. Dostępne są również zaktualizowane przykłady usługi GitHub. W tej wersji uwzględniono następujące zmiany:

Transakcje i zarządzanie

Nowe pole w umowie publicznej

Dodawanie identyfikatora promocji do zaplanowanej zmiany
Zarządzanie zaplanowanymi zmianami dla nowych subskrypcji handlowych

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

Nowa obsługa zestawu SDK dla wartości stanu subskrypcji "disabled".

Interfejsy API Centrum partnerskiego zaczną zwracać nowe stany "wyłączone" po upływie 90 dni od wersji 3.1.1 zestawu SDK. Partnerzy mają 90 dni, zanim interfejs API zwróci stan "wyłączony", aby dać im czas na zaktualizowanie zestawów SDK i przestrzeganie zasad zarządzania zmianami.

Nowa Aktualizacje interfejsu API

Subskrypcje zmigrowane za pomocą zapytań to interfejs API, w którym partnerzy mogą wykonywać zapytania dotyczące wszystkich zmigrowanych podsieci dla podanych kryteriów wejściowych.

  • GET {baseURL}/v1/migrations/newcommerce

Interfejs API zdarzeń migracji nowego handlu służy do pobierania szczegółów zdarzeń migracji na podstawie bieżącego identyfikatora subskrypcji lub identyfikatora migracji.

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

Wersja 3.0.1

Zestaw .NET SDK programu Microsoft Partner Center w wersji 3.0.1 jest teraz ogólnie dostępny. Dostępne są również zaktualizowane przykłady usługi GitHub. W tej wersji uwzględniono następujące zmiany:

Transakcje i zarządzanie

Nowe pole w umowie publicznej

  • 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}
    • Dodano RefundableQuantity właściwość do Subscription modelu
    • Dodano CustomTermEndDate właściwość do ScheduledNextTermInstructions modelu
    • Dodano MigratedFromSubscriptionId właściwość do Subscription modelu
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
    • Dodano AddOnMigrations właściwość do NewCommerceMigration modelu
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
    • Dodano AddOnMigrations właściwość do NewCommerceMigration modelu
  • GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration_id}
    • Dodano AddOnMigrations właściwość do NewCommerceMigration modelu
  • POST {baseURL}/v1/customers/{customer_id}/carts
    • Dodano nowe CartErrorCode wartości wyliczenia
    • Dodano nowy AdditionalInformation model do CartError modelu
    • Dodano CustomTermEndDate właściwość do CartLineItem modelu
  • GET/PUT {baseURL}/v1/customers/{customer_id}/carts/{cart_id}
    • Dodano nowe CartErrorCode wartości wyliczenia
    • Dodano nowy AdditionalInformation model do CartError modelu
    • Dodano CustomTermEndDate właściwość do CartLineItem modelu
  • GET/POST {baseURL}/v1/customers/{customer_id}/orders
    • Dodano CustomTermEndDate właściwość do OrderLineItem modelu
  • GET/PATCH {baseURL}/v1/customers/{customer_id}/orders/{order_id}
    • Dodano CustomTermEndDate właściwość do OrderLineItem modelu

Narzędzie do migracji wsadowej usługi NCE

Aby ułatwić partnerom efektywne migrowanie dużych ilości subskrypcji, włączyliśmy narzędzie migracji usługi Batch (BAM). Narzędzie BAM umożliwia partnerom migrowanie subskrypcji do usługi NCE przy użyciu następującego podejścia:

  • Usprawnione środowisko przykładowej aplikacji zestawu SDK platformy .NET typu open source
  • Zarządzanie edycjami migracji przy użyciu programu Excel
  • Proste narzędzie obsługujące scenariusze migracji o wysokiej jakości, powtarzalne i dostosowywalne w partiach

Aby uzyskać szczegółowe instrukcje, zobacz New Commerce Experience Batch Migration Tool (BAM).

Zabezpieczenia

Nowy interfejs API

  • Poprawka {baseURL}/v1/customers/{customer-tenant-id}
    • Usuwanie interfejsu API języka DAP — aby usunąć właściwość zestawu AllowDelegatedAccess DAP na false

Inspekcja i element webhook

Zaktualizowano inspekcję — dodano nowe typy operacji dla "Zarządzanie nadwyżkami", "DaP Administracja relacja zakończona przez firmę Microsoft" i "Wykryto zdarzenie oszustwa platformy Azure".

Inspekcja zasobów

Wersja 3.0.0

Zestaw .NET SDK programu Microsoft Partner Center w wersji 3.0.0 jest teraz ogólnie dostępny. Dostępne są również zaktualizowane przykłady usługi GitHub. W tej wersji uwzględniono następujące zmiany:

Typowe Aktualizacje

Uaktualnij wersję System.ComponentModel.Annotations do najnowszej wersji 5.0, aby rozwiązać istniejące problemy ze zgodnością.

Transakcje i zarządzanie

Nowy interfejs 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

Nowe pole w umowie publicznej

  • 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/cena/promocja

Nowy interfejs 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}

Nowe pole w umowie publicznej

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

Klient

Nowy interfejs API

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

Inspekcja i element webhook

Zaktualizowano inspekcję — dodano nowe typy operacji dla opcji Dodaj oprogramowanieAttestation i Dodaj urządzenia i zasady Aktualizacje

Inspekcja zasobów — deweloper aplikacji Centrum partnerskiego | 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

Wersja 2.0.1

Zestaw .NET SDK programu Microsoft Partner Center w wersji 2.0.1 jest teraz ogólnie dostępny. Dostępne są również zaktualizowane przykłady usługi GitHub. W tej wersji uwzględniono następujące zmiany:

Uwaga

Niektóre zmiany wprowadzone w ramach nowego środowiska handlowego ("NCE"), które są obecnie dostępne na podstawie zaproszenia tylko dla partnerów, którzy są częścią usługi Microsoft 365/Microsoft Dynamics 365 — wersja zapoznawcza techniczna dotycząca nowego środowiska handlowego. Partnerzy, którzy nie są częścią prywatnej wersji zapoznawczej nowego handlu, nie powinni zauważać wpływu i powinny być zgodne z poprzednimi wersjami.

Popularny

  • Zmiana odwołania do biblioteki uwierzytelniania — odwołanie zostało zmienione z biblioteki Azure Active Directory Authentication Library (ADAL) na bibliotekę Microsoft Authentication Library (MSAL)

    W celu zapewnienia prawidłowego działania biblioteki MSAL w aplikacji lub przykładzie platformy .NET należy wprowadzić następujące zmiany:

    • Dodawanie https://login.microsoftonline.com/common/oauth2/nativeclient jako redirectUrl dla aplikacji mobilnych i klasycznych

    • Dodaj domenę do sekcji UserAuthentication w pliku konfiguracji aplikacji.

      Domena to domena usługi Azure Active Directory lub identyfikator dzierżawy, w której utworzono aplikację usługi Azure AD

  • Kody błędów — dodano nowy kod błędu

    • 408: Limit czasu żądania
    • 504: Limit czasu bramy

Zarządzanie rozliczeniami

  • Elementy wiersza faktury — nowe atrybuty dodane do następujących interfejsów API:

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

    Nowe atrybuty:

    • productQualifiers
    • subscriptionStartDate
    • subscriptionEndDate
    • referenceId
    • creditReasonCode (dotyczy tylko usługi NCE)
    • identyfikator promocji

  • Codzienne oceniane użycie Line-items — nowe atrybuty dodane do następującego interfejsu API:

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

    Nowe atrybuty:

    • hasPartnerEarnedCredit (dotyczy tylko NCE)
    • creditType (dotyczy tylko NCE)
    • rateOfCredit (dotyczy tylko NCE)

Zarządzanie zamówieniami

  • Zasoby subskrypcji — dodano nową właściwość.

    • CancellationAllowedUntilDate — (dotyczy tylko usługi NCE)

  • Przenoszenie zasobów (dotyczy tylko usługi NCE) — dodano nową właściwość

    • FromSubscriptionId

Zarządzanie kontami klientów

  • Zweryfikuj adres — odpowiedź została zmieniona z wartości logicznej na nowy model dla interfejsu API:

    • POST /validations/address

    Nowy model odpowiedzi:

    • AddressValidationResponse

  • Synchroniczny interfejs API kwalifikacji klienta jest przestarzały.

Wersja 1.17.0

Zestaw .NET SDK programu Microsoft Partner Center w wersji 1.17.0 jest teraz ogólnie dostępny. Dostępne są również zaktualizowane przykłady usługi GitHub. W tej wersji uwzględniono następujące zmiany:

  • Inspekcja zaktualizowana — dodano nowe typy operacji w celu poznania, kiedy klient zatwierdził i zakończył pracę języka DAP

  • Zaktualizowano inspekcję — dodano nowe typy zasobów i operacji na potrzeby obsługi scenariusza roli katalogu klienta

  • Zestaw SDK Aktualizacje do konta klientów — obsługa następujących interfejsów API

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

  • Następujące zmiany wprowadzone w ramach nowego handlu, które są obecnie dostępne na podstawie zaproszenia tylko dla partnerów, którzy są częścią platformy Microsoft 365/Microsoft Dynamics 365 w wersji technical preview. Partnerzy, którzy nie są częścią prywatnej wersji zapoznawczej nowego handlu, nie powinni zauważyć wpływu i powinni być zgodni z poprzednimi wersjami.

    • Zmiany wykazu:
      • GET /products/{product-id}/skus/{sku-id}
    • Kupowanie i zarządzanie:
      • 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

Wersja 1.16.3

Zestaw .NET SDK programu Microsoft Partner Center w wersji 1.16.3 jest teraz ogólnie dostępny. Dostępne są również zaktualizowane przykłady usługi GitHub. W tej wersji uwzględniono następujące zmiany:

Wersja 1.16.2

Zestaw .NET SDK programu Microsoft Partner Center w wersji 1.16.2 jest teraz ogólnie dostępny. Dostępne są również zaktualizowane przykłady usługi GitHub. W tej wersji uwzględniono następujące zmiany:

  • Zaktualizuj obsługiwane typy operacji dla rekordu inspekcji. Nowo dodane są następujące:

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

  • Tworzenie żądania obsługi jest teraz przestarzałe

  • Tematy pomocy technicznej są teraz przestarzałe

Wersja 1.16.1

Zestaw .NET SDK programu Microsoft Partner Center w wersji 1.16.1 jest teraz ogólnie dostępny. Dostępne są również zaktualizowane przykłady usługi GitHub. W tej wersji uwzględniono następujące zmiany:

Zmigrowaliśmy istniejący zestaw MICROSOFT Partner Center SDK z programu .NET Framework do platformy .NET Standard 2.0. Ta migracja sprawi, że zestaw SDK będzie zgodny z istniejącymi aplikacjami przy użyciu programu .NET Framework 4.6.1 lub nowszego. Zestaw SDK obsługuje platformę .NET Core 2.0 i nowsze. Przed przejściem do istniejących aplikacji sprawdź obsługę implementacji platformy .NET.

Wersja 1.15.3

Zestaw .NET SDK programu Microsoft Partner Center w wersji 1.15.3 jest teraz ogólnie dostępny. Dostępne są również zaktualizowane interfejsy API REST i przykłady usługi GitHub. W tej wersji uwzględniono następujące zmiany:

  • Umowa partnerska
  • Produktów
    • Następujące dwa interfejsy zostały niepoprawnie umieszczone w przestrzeni nazw Microsoft.Store.PartnerCenter.Products. Teraz znajdują się one w przestrzeni nazw Microsoft.Store.PartnerCenter.Customers.Products.
      • ICustomerProductByReservationScope
      • ICustomerSkuByReservationScope