Poznámky k verzi sady .NET SDK

  • Článek

Následující poznámky k verzi jsou k dispozici pro nové verze sady Microsoft Partner Center .NET SDK. Ukázky sady .NET SDK najdete na GitHubu. Referenční informace k rozhraní .NET API partnerského centra najdete v prohlížeči rozhraní .NET API.

Důležité

Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Vydání sady SDK si můžete stáhnout z GitHubu spolu se souborem readme, který obsahuje užitečné informace.

Doporučujeme, aby partneři dál používali rozhraní REST API Partnerského centra.

Verze 3.4.0

Microsoft Partner Center .NET SDK v3.4.0 je nyní k dispozici. K dispozici jsou také aktualizované ukázky GitHubu.

V této verzi jsou zahrnuty následující změny:

Transakce a správa

Aktualizují se následující rozhraní API, aby poskytovala vlastnosti koncového data termínu:

Pricing object je nyní k dispozici v následující odpovědi rozhraní API:

Propagace

Zveřejnění omezení:

Verze 3.3.0

Microsoft Partner Center .NET SDK v3.3.0 je nyní k dispozici. K dispozici jsou také aktualizované ukázky GitHubu.

V této verzi jsou zahrnuty následující změny:

Transakce a správa

Pokud dojde k ohrožení zabezpečení zákazníka (podvodu), aktualizují se následující rozhraní API, aby bylo možné povolit zrušení předplatného Azure:

Id operace se teď nachází v následujících odpovědích rozhraníAPIch

Nové chybové zprávy GDAP:

Auditovat

Byl přidán nový typ prostředku AzureEntitlement a IndirectProviderIndirectResellerDap pro následující:

Verze 3.2.0

Microsoft Partner Center .NET SDK v3.2.0 je nyní obecná dostupnost. K dispozici jsou také aktualizované ukázky GitHubu.

V této verzi jsou zahrnuty následující změny:

Pokud chcete používat sadu .NET SDK verze 3.2.0, partneři musí mít Newtonsoft.Json 13.0.1 a vyšší. Vzhledem k tomu, že verze starší než verze 13.0.1 mají chyby s vysokou zranitelností.

Nové kontrakty rozhraní API

Pro podporu plánu migrace NCE se zavádějí následující rozhraní API:

Aktualizace ke kontraktu rozhraní API

Verze 3.1.2

Microsoft Partner Center .NET SDK v3.1.2 je nyní obecná dostupnost. K dispozici jsou také aktualizované ukázky GitHubu. V této verzi jsou zahrnuty následující změny:

Aktualizace veřejné zakázky

AddOnMigrations Přidání pole do objektu NewCommerceEligibility
Ověření předplatného pro migraci

Verze 3.1.1

Důležité

Verze 3.1.0 je zastaralá. Nestahujte sadu .NET SDK v.3.1.0

Microsoft Partner Center .NET SDK v3.1.1 je nyní obecná dostupnost. K dispozici jsou také aktualizované ukázky GitHubu. V této verzi jsou zahrnuty následující změny:

Transakce a správa

Nové pole ve veřejné smlouvě

Přidání ID povýšení do plánované změny
Správa plánovaných změn pro nová komerční předplatná

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

Nová podpora sady SDK pro hodnotu stavu předplatného zakázáno

Rozhraní API Partnerského centra začnou po 90 dnech od vydání sady SDK verze 3.1.1 vracet nové zakázané stavy. Partneři mají 90 dní před tím, než rozhraní API vrátí stav Zakázáno, aby měli čas aktualizovat sady SDK a dodržovat zásady správy změn.

Nová Aktualizace rozhraní API

Migrovaná předplatná dotazů jsou rozhraní API, ve kterém můžou partneři zadávat dotazy na všechna migrovaná dílčí pole pro daná vstupní kritéria.

  • GET {baseURL}/v1/migrations/newcommerce

Rozhraní API pro získání nových událostí migrace commerce se používá k načtení podrobností o událostech migrace na základě aktuálního ID předplatného nebo ID migrace.

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

Verze 3.0.1

Microsoft Partner Center .NET SDK v3.0.1 je nyní obecná dostupnost. K dispozici jsou také aktualizované ukázky GitHubu. V této verzi jsou zahrnuty následující změny:

Transakce a správa

Nové pole ve veřejné smlouvě

  • 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}
    • Přidání RefundableQuantity vlastnosti do Subscription modelu
    • Přidání CustomTermEndDate vlastnosti do ScheduledNextTermInstructions modelu
    • Přidání MigratedFromSubscriptionId vlastnosti do Subscription modelu
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
    • Přidání AddOnMigrations vlastnosti do NewCommerceMigration modelu
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
    • Přidání AddOnMigrations vlastnosti do NewCommerceMigration modelu
  • GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration_id}
    • Přidání AddOnMigrations vlastnosti do NewCommerceMigration modelu
  • POST {baseURL}/v1/customers/{customer_id}/carts
    • Přidání nových CartErrorCode hodnot výčtu
    • Přidání nového AdditionalInformation modelu do CartError modelu
    • Přidání CustomTermEndDate vlastnosti do CartLineItem modelu
  • GET/PUT {baseURL}/v1/customers/{customer_id}/carts/{cart_id}
    • Přidání nových CartErrorCode hodnot výčtu
    • Přidání nového AdditionalInformation modelu do CartError modelu
    • Přidání CustomTermEndDate vlastnosti do CartLineItem modelu
  • GET/POST {baseURL}/v1/customers/{customer_id}/orders
    • Přidání CustomTermEndDate vlastnosti do OrderLineItem modelu
  • GET/PATCH {baseURL}/v1/customers/{customer_id}/orders/{order_id}
    • Přidání CustomTermEndDate vlastnosti do OrderLineItem modelu

Nástroj pro dávkovou migraci NCE

Abychom usnadnili partnerské potřeby efektivní migrace velkých objemů předplatných, povolili jsme nástroj Pro migraci do dávky (BAM). Nástroj BAM umožňuje partnerům migrovat předplatná do NCE pomocí následujícího přístupu:

  • Zjednodušené prostředí ukázkové aplikace sady .NET SDK s otevřeným zdrojem
  • Použití Excelu ke správě úprav migrace
  • Jednoduchý nástroj podporující vysoce kvalitní, opakovatelné a přizpůsobitelné scénáře migrace v dávkách

Podrobné pokyny najdete v tématu Nový nástroj pro migraci do prostředí pro obchodování (BAM).</a0>

Zabezpečení

Nové rozhraní API

  • Oprava {baseURL}/v1/customers/{customer-tenant-id}
    • Odebrání rozhraní DAP API – Odebrání vlastnosti sady AllowDelegatedAccess DAP na false

Audit a webhook

Aktualizace auditu – Přidání nových typů operací pro správu nadlimitního využití, vztah DAP Správa ukončený Microsoftem a Zjištěná událost podvodu Azure

Auditování prostředků

Verze 3.0.0

Microsoft Partner Center .NET SDK v3.0.0 je nyní obecná dostupnost. K dispozici jsou také aktualizované ukázky GitHubu. V této verzi jsou zahrnuty následující změny:

Běžné Aktualizace

Upgradujte System.ComponentModel.Annotations na nejnovější verzi 5.0 a vyřešte stávající problémy s kompatibilitou.

Transakce a správa

Nové rozhraní 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

Nové pole ve veřejné smlouvě

  • 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/ povýšení

Nové rozhraní 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}

Nové pole ve veřejné smlouvě

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

Zákazník

Nové rozhraní API

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

Audit a webhook

Aktualizace auditu – Přidání nových typů operací pro přidání softwareAttestation a přidání zařízení a zásad Aktualizace

Auditování prostředků – Vývojář aplikací v Partnerském centru | 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

Verze 2.0.1

Microsoft Partner Center .NET SDK v2.0.1 je nyní obecná dostupnost. K dispozici jsou také aktualizované ukázky GitHubu. V této verzi jsou zahrnuty následující změny:

Poznámka:

Některé změny představené v rámci nových obchodních prostředí ("NCE") jsou aktuálně k dispozici na základě pozvání pouze partnerům, kteří jsou součástí Microsoftu 365/Microsoft Dynamics 365 new commerce experience technical Preview. Partneři, kteří nejsou součástí verze Private Preview nového obchodu, by si neměli všimnout dopadů a měli by být zpětně kompatibilní.

Běžný

  • Změna odkazu na knihovnu ověřování – Odkaz se změní z Azure Active Directory Authentication Library (ADAL) na knihovnu Microsoft Authentication Library (MSAL).

    Měli byste provést následující změny, abyste měli jistotu, že msal ve vaší aplikaci nebo v ukázce .NET funguje správně:

    • Přidání https://login.microsoftonline.com/common/oauth2/nativeclient jako redirectUrl pro mobilní a desktopové aplikace

    • Přidejte do části UserAuthentication v konfiguračním souboru aplikace doménu .

      Doména je doména azure Active Directory nebo ID tenanta, ve kterém byla vytvořena aplikace Azure AD.

  • Kódy chyb – Byl přidán nový kód chyby

    • 408: Vypršení časového limitu požadavku
    • 504: Vypršení časového limitu brány

Správa fakturace

  • Řádkové položky faktury – nové atributy přidané do následujících rozhraní API:

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

    Nové atributy:

    • productQualifiers
    • subscriptionStartDate
    • subscriptionEndDate
    • referenceId
    • creditReasonCode (platí pouze pro NCE)
    • promotionId

  • Položky line-items s denním hodnocením – nové atributy přidané do následujícího rozhraní API:

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

    Nové atributy:

    • hasPartnerEarnedCredit (platí pouze pro NCE)
    • creditType (platí pouze pro NCE)
    • rateOfCredit (platí pouze pro NCE)

Správa objednávek

  • Prostředky předplatného – přidána nová vlastnost.

    • CancellationAllowedUntilDate - (platí pouze pro NCE)

  • Transition Resources (platí pouze pro NCE) – přidána nová vlastnost

    • FromSubscriptionId

Správa zákaznických účtů

  • Ověření adresy – Odpověď se změní z logické hodnoty na nový model pro rozhraní API:

    • POST /validations/address

    Nový model odpovědi:

    • AddressValidationResponse

  • Synchronní rozhraní API pro kvalifikaci zákazníka je zastaralé.

Verze 1.17.0

Microsoft Partner Center .NET SDK v1.17.0 je nyní obecná dostupnost. K dispozici jsou také aktualizované ukázky GitHubu. V této verzi jsou zahrnuty následující změny:

  • Aktualizace auditu – Přidání nových typů operací pro zjištění, kdy zákazník schválil a ukončil DAP

  • Aktualizace auditu – Přidání nových typů prostředků a operací pro podporu scénáře role adresáře zákazníka

    • Typ prostředku CustomerDirectoryRole
    • Typy operací AddUserMember a RemoveUserMember

  • Aktualizace sady SDK k účtu zákazníků – podpora pro následující rozhraní API

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

  • Následující změny představené jako součást nového obchodu, které jsou aktuálně dostupné na základě pozvání pouze partnerům, kteří jsou součástí Microsoftu 365 nebo Microsoft Dynamics 365 new commerce experience Technical Preview. Partneři, kteří nejsou součástí verze Private Preview nového obchodu, by si neměli všimnout dopadů a měli by být zpětně kompatibilní.

    • Změny katalogu:
      • GET /products/{product-id}/skus/{sku-id}
    • Nákup a správa:
      • 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

Verze 1.16.3

Microsoft Partner Center .NET SDK v1.16.3 je nyní obecná dostupnost. K dispozici jsou také aktualizované ukázky GitHubu. V této verzi jsou zahrnuty následující změny:

Verze 1.16.2

Microsoft Partner Center .NET SDK v1.16.2 je nyní obecná dostupnost. K dispozici jsou také aktualizované ukázky GitHubu. V této verzi jsou zahrnuty následující změny:

  • Aktualizace podporovaných typů operací pro záznam auditu Nově přidané jsou:

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

  • Vytvoření žádosti o službu je teď zastaralé.

  • Témata podpory jsou teď zastaralá

Verze 1.16.1

Microsoft Partner Center .NET SDK v1.16.1 je nyní obecná dostupnost. K dispozici jsou také aktualizované ukázky GitHubu. V této verzi jsou zahrnuty následující změny:

Migrovali jsme stávající sadu MICROSOFT Partner Center SDK z rozhraní .NET Framework na platformu .NET Standard 2.0. Díky této migraci bude sada SDK kompatibilní se stávajícími aplikacemi pomocí rozhraní .NET Framework 4.6.1 a vyšší. Sada SDK podporuje .NET Core 2.0 a novější. Před přenesením do existujících aplikací zkontrolujte podporu implementace .NET.

Verze 1.15.3

Microsoft Partner Center .NET SDK v1.15.3 je nyní obecná dostupnost. K dispozici jsou také aktualizovaná rozhraní REST API a ukázky GitHubu. V této verzi jsou zahrnuty následující změny:

  • Smlouva s partnerem
  • Produkty
    • Následující dvě rozhraní byla nesprávně umístěna v oboru názvů Microsoft.Store.PartnerCenter.Products. Teď se nacházejí v oboru názvů Microsoft.Store.PartnerCenter.Customers.Products.
      • ICustomerProductByReservationScope
      • ICustomerSkuByReservationScope