Versionshinweise zum .NET SDK

  • Artikel

Die folgenden Versionshinweise sind für neue Versionen von Microsoft Partner Center .NET SDK verfügbar. Sie finden .NET SDK-Beispiele auf GitHub. Sie finden die Partner Center .NET-API-Referenz im .NET-API-Browser.

Wichtig

Ab Juni 2023 ist jetzt die neueste Partner Center .NET SDK-Version 3.4.0 archiviert. Sie können das SDK-Release von GitHub zusammen mit einer Infodatei herunterladen, die nützliche Informationen enthält.

Partnern wird empfohlen, weiterhin die Partner Center-REST-APIs zu verwenden.

Version 3.4.0

Microsoft Partner Center .NET SDK v3.4.0 ist jetzt verfügbar. Aktualisierte GitHub-Beispiele sind ebenfalls verfügbar.

Diese Version enthält die folgenden Änderungen:

Transaktion und Verwaltung

Die folgenden APIs werden aktualisiert, um Eigenschaften für enddatumsende Laufzeiten bereitzustellen:

Pricing object ist jetzt in der folgenden API-Antwort vorhanden:

Werbeaktionen

Verfügbarmachen von Einschränkungen:

Version 3.3.0

Microsoft Partner Center .NET SDK v3.3.0 ist jetzt verfügbar. Aktualisierte GitHub-Beispiele sind ebenfalls verfügbar.

Diese Version enthält die folgenden Änderungen:

Transaktion und Verwaltung

Die folgenden APIs werden aktualisiert, um Azure-Abonnementabsagen zu aktivieren, wenn ein Kunde kompromittiert ist (Betrug):

"OperationId" ist jetzt in den folgenden API-Antworten vorhanden:

Neue GDAP-Fehlermeldungen:

Überwachung

Der neue Ressourcentyp "AzureEntitlement" und "IndirectProviderIndirectResellerDap" wurden für Folgendes hinzugefügt:

Version 3.2.0

Microsoft Partner Center .NET SDK v3.2.0 ist jetzt allgemein verfügbar. Aktualisierte GitHub-Beispiele sind ebenfalls verfügbar.

Diese Version enthält die folgenden Änderungen:

Um .NET SDK v 3.2.0 zu verwenden, müssen Partner Über Newtonsoft.Json 13.0.1 und höher verfügen. Da die Versionen vor v13.0.1 hohe anfällige Fehler aufweisen.

Neue APIs-Verträge

Die folgenden APIs werden zur Unterstützung des NCE-Migrationszeitplans eingeführt:

Updates für den API-Vertrag

Version 3.1.2

Microsoft Partner Center .NET SDK v3.1.2 ist jetzt allgemeine Verfügbarkeit. Aktualisierte GitHub-Beispiele sind ebenfalls verfügbar. Diese Version enthält die folgenden Änderungen:

Aktualisierungen des öffentlichen Vertrags

Das AddOnMigrations Feld wurde dem NewCommerceEligibility Objekt hinzugefügt.
Überprüfen eines Abonnements für die Migration

Version 3.1.1

Wichtig

Die Version 3.1.0 ist veraltet. .NET SDK v.3.1.0 nicht herunterladen

Microsoft Partner Center .NET SDK v3.1.1 ist jetzt allgemeine Verfügbarkeit. Aktualisierte GitHub-Beispiele sind ebenfalls verfügbar. Diese Version enthält die folgenden Änderungen:

Transaktion und Verwaltung

Neues Feld im öffentlichen Vertrag

Hinzufügen der Heraufstellungs-ID zur geplanten Änderung
Verwalten geplanter Änderungen für neue Commerce-Abonnements

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

Neue SDK-Unterstützung für den Abonnementstatuswert "disabled".

Partner Center-APIs beginnen nach 90 Tagen nach der v3.1.1 SDK-Version mit der Rückgabe neuer "disabled"-Zustände. Partner haben 90 Tage, bevor die API den Status "deaktiviert" zurückgibt, um ihnen Zeit zu geben, ihre SDKs zu aktualisieren und die Änderungsverwaltungsprinzipien einzuhalten.

Neue API-Updates

Abfrage migrierte Abonnements ist die API, in der Partner alle migrierten Unters für ein bestimmtes Eingabekriterium abfragen können.

  • GET {baseURL}/v1/migrations/newcommerce

Die API zum Abrufen von New Commerce-Migrationsereignissen wird zum Abrufen der Details von Migrationsereignissen basierend auf der aktuellen Abonnement-ID oder Migrations-ID verwendet.

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

Version 3.0.1

Microsoft Partner Center .NET SDK v3.0.1 ist jetzt allgemeine Verfügbarkeit. Aktualisierte GitHub-Beispiele sind ebenfalls verfügbar. Diese Version enthält die folgenden Änderungen:

Transaktion und Verwaltung

Neues Feld im öffentlichen Vertrag

  • 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}
    • Eigenschaft zum Subscription Modell hinzugefügt RefundableQuantity
    • Eigenschaft zum ScheduledNextTermInstructions Modell hinzugefügt CustomTermEndDate
    • Eigenschaft zum Subscription Modell hinzugefügt MigratedFromSubscriptionId
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
    • Eigenschaft zum NewCommerceMigration Modell hinzugefügt AddOnMigrations
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
    • Eigenschaft zum NewCommerceMigration Modell hinzugefügt AddOnMigrations
  • GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration_id}
    • Eigenschaft zum NewCommerceMigration Modell hinzugefügt AddOnMigrations
  • POST {baseURL}/v1/customers/{customer_id}/carts
    • Neue CartErrorCode Enumerationswerte hinzugefügt
    • Neues AdditionalInformation Modell zum CartError Modell hinzugefügt
    • Eigenschaft zum CartLineItem Modell hinzugefügt CustomTermEndDate
  • GET/PUT {baseURL}/v1/customers/{customer_id}/carts/{cart_id}
    • Neue CartErrorCode Enumerationswerte hinzugefügt
    • Neues AdditionalInformation Modell zum CartError Modell hinzugefügt
    • Eigenschaft zum CartLineItem Modell hinzugefügt CustomTermEndDate
  • GET/POST {baseURL}/v1/customers/{customer_id}/orders
    • Eigenschaft zum OrderLineItem Modell hinzugefügt CustomTermEndDate
  • GET/PATCH {baseURL}/v1/customers/{customer_id}/orders/{order_id}
    • Eigenschaft zum OrderLineItem Modell hinzugefügt CustomTermEndDate

NCE Batchmigrationstool

Um den Partnerbedarf einer effizienten Migration großer Mengen von Abonnements zu erleichtern, haben wir ein TOOL für die Batchmigration (BATCH Migration, BAM) aktiviert. Mit dem BAM-Tool können Partner Abonnements mithilfe des folgenden Ansatzes nach NCE migrieren:

  • Optimierte Open Source .NET SDK-Beispiel-App-Erfahrung
  • Verwendet Excel zum Verwalten von Migrationsbearbeitungen
  • Einfaches Tool, das qualitativ hochwertige, wiederholbare und anpassbare Migrationsszenarien in Batches unterstützt

Ausführliche Anweisungen finden Sie unter New Commerce Experience Batch Migration Tool (BAM).For detailed instructions, see New Commerce Experience Batch Migration Tool (BAM).

Sicherheit

Neue API

  • Patch {baseURL}/v1/customers/{customer-tenant-id}
    • ENTFERNEN DER DAP-API – So entfernen Sie die DAP-Set-Eigenschaft AllowDelegatedAccess auf "false".

Überwachen und Webhook

Audit Updated – Neue Vorgangstypen für "Verwalten der Überlastung", "DAP-Administratorbeziehung beendet von Microsoft" und "Azure Fraud Event Detected" hinzugefügt.

Überwachungsressourcen

Version 3.0.0

Microsoft Partner Center .NET SDK v3.0.0 ist jetzt allgemeine Verfügbarkeit. Aktualisierte GitHub-Beispiele sind ebenfalls verfügbar. Diese Version enthält die folgenden Änderungen:

Allgemeine Updates

„System.ComponentModel.Annotations“ wurde auf die neueste Version 5.0 aktualisiert, um vorhandene Kompatibilitätsprobleme zu beheben.

Transaktion und Verwaltung

Neue 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

Neues Feld im öffentlichen Vertrag

  • 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/Preis/Promotion

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

Neues Feld im öffentlichen Vertrag

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

Kreditor

Neue API

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

Überwachen und Webhook

Audit Updated – Neue Vorgangstypen für "SoftwareAttestation hinzufügen" und "Hinzufügen von Geräte- und Richtlinienupdates"

Überwachungsressourcen – Partner Center-App-Entwickler | Microsoft-Dokumentation

  • 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

Version 2.0.1

Microsoft Partner Center .NET SDK v2.0.1 ist jetzt allgemeine Verfügbarkeit. Aktualisierte GitHub-Beispiele sind ebenfalls verfügbar. Diese Version enthält die folgenden Änderungen:

Hinweis

Einige änderungen, die im Rahmen von New Commerce Experiences ("NCE") eingeführt wurden, die derzeit nur auf Einladung zu Partnern verfügbar sind, die Teil der neuen Microsoft 365/Microsoft Dynamics 365-Erfahrung sind, technische Vorschau. Partner, die nicht Teil der privaten Vorschau von New Commerce sind, sollten keine Auswirkungen bemerken und sollten abwärtskompatibel sein.

Allgemein

  • Ändern des Verweises auf die Authentifizierungsbibliothek – Der Verweis wird von der Azure Active Directory-Authentifizierungsbibliothek (ADAL) in die Microsoft Authentication Library (MSAL) geändert.

    Die folgenden Änderungen sollten vorgenommen werden, um sicherzustellen, dass MSAL in Ihrer Anwendung oder im .NET-Beispiel ordnungsgemäß ausgeführt wird:

    • Als RedirectUrl für Mobile- und Desktopanwendungen hinzufügen https://login.microsoftonline.com/common/oauth2/nativeclient

    • Fügen Sie "Do Standard" in der Anwendungskonfigurationsdatei zum Abschnitt "UserAuthentication" hinzu.

      "Do Standard is the Azure Active Directory do Standard or tenant ID where the Azure AD application was created

  • Fehlercodes – Neuer Fehlercode hinzugefügt

    • 408: Zeitüberschreitung anfordern
    • 504: Gatewaytimeout

Verwalten der Abrechnung

  • Rechnungspositionen – neue Attribute, die folgenden APIs hinzugefügt werden:

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

    Neue Attribute:

    • productQualifiers
    • subscriptionStartDate
    • subscriptionEndDate
    • referenceId
    • creditReasonCode (gilt nur für NCE)
    • promotionId

  • Täglich bewertete Nutzungspositionen – neue Attribute, die der folgenden API hinzugefügt wurden:

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

    Neue Attribute:

    • hasPartnerEarnedCredit (gilt nur für NCE)
    • creditType (gilt nur für NCE)
    • rateOfCredit (gilt nur für NCE)

Aufträge verwalten

  • Abonnementressourcen – Neue Eigenschaft hinzugefügt.

    • CancellationAllowedUntilDate - (gilt nur für NCE)

  • Transition Resources (gilt nur für NCE) – Neue Eigenschaft hinzugefügt

    • FromSubscriptionId

Verwalten von Kundenkonten

  • Überprüfen einer Adresse – Antwort wird von einem booleschen In ein neues Modell für DIE API geändert:

    • POST /validations/address

    Neues Antwortmodell:

    • AddressValidationResponse

  • Die synchrone API des Kunden ist veraltet.

Version 1.17.0

Microsoft Partner Center .NET SDK v1.17.0 ist jetzt allgemein verfügbar. Aktualisierte GitHub-Beispiele sind ebenfalls verfügbar. Diese Version enthält die folgenden Änderungen:

  • Audit Updated – Neue Vorgangstypen hinzugefügt, um zu wissen, wann der Kunde DAP genehmigt und beendet hat

  • Audit Updated – Neue Ressourcen- und Vorgangstypen für die Unterstützung des Szenarios für kundenverzeichnisrollen hinzugefügt

  • SDK-Updates für Kundenkonto – Unterstützung für die folgenden APIs

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

  • Im Rahmen von New Commerce eingeführte Änderungen, die derzeit nur für Partner verfügbar sind, die Teil der neuen Microsoft 365/Microsoft Dynamics 365-Geschäftserfahrung sind, technische Vorschau. Partner, die nicht Teil der privaten Vorschau von New Commerce sind, sollten keine Auswirkungen bemerken und abwärtskompatibel sein.

    • Katalogänderungen:
      • GET /products/{product-id}/skus/{sku-id}
    • Kaufen und Verwalten:
      • 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

Version 1.16.3

Microsoft Partner Center .NET SDK v1.16.3 ist jetzt allgemein verfügbar. Aktualisierte GitHub-Beispiele sind ebenfalls verfügbar. Diese Version enthält die folgenden Änderungen:

Version 1.16.2

Microsoft Partner Center .NET SDK v1.16.2 ist jetzt allgemein verfügbar. Aktualisierte GitHub-Beispiele sind ebenfalls verfügbar. Diese Version enthält die folgenden Änderungen:

  • Aktualisierung der unterstützten Vorgangstypen für den Überwachungsdatensatz. Die neu hinzugefügten sind:

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

  • Die Erstellung von Serviceanfragen ist nun veraltet.

  • Supportthemen sind nun veraltet.

Version 1.16.1

Microsoft Partner Center .NET SDK v1.16.1 ist jetzt allgemein verfügbar. Aktualisierte GitHub-Beispiele sind ebenfalls verfügbar. Diese Version enthält die folgenden Änderungen:

Wir haben das vorhandene Microsoft Partner Center SDK von .NET Framework zu .NET Standard 2.0-Plattform migriert. Diese Migration macht das SDK mit vorhandenen Anwendungen mit .NET Framework 4.6.1 und höher kompatibel. Das SDK unterstützt .NET Core 2.0 und höher. Überprüfen Sie die Unterstützung der .NET-Implementierung , bevor Sie sie zu vorhandenen Anwendungen portieren.

Version 1.15.3

Microsoft Partner Center .NET SDK v1.15.3 ist jetzt allgemein verfügbar. Aktualisierte REST-APIs und GitHub-Beispiele sind ebenfalls verfügbar. Diese Version enthält die folgenden Änderungen:

  • Partnervertrag
    • Es wurde die Möglichkeit für indirekte Anbieter hinzugefügt, Microsoft Partner-Vereinbarung Status indirekter Wiederverkäufer zu überprüfen.
  • Products
    • Die folgenden beiden Schnittstellen wurden fälschlicherweise unter dem Namespace "Microsoft.Store.PartnerCenter.Products" platziert. Jetzt befinden sie sich unter dem Namespace "Microsoft.Store.PartnerCenter.Customers.Products".
      • ICustomerProductByReservationScope
      • ICustomerSkuByReservationScope