Aktuelle Änderungen an Partner Center-REST-APIs

In diesem Artikel werden Änderungen zusammengefasst, die an den Rest-APIs des Partner Center vorgenommen wurden.

November 2022

Funktionsbereich Änderungstyp API/Objekte
NCE-Migration Partner können jetzt Migrationen mit dem API-, UX- und BAM-Tool planen. Planen einer neuen E-Commerce-Migration Abbrechen einer neuen E-Commerce-Migration

Aktualisieren einer neuen E-Commerce-Migration

Erhalten Sie ein neues Migrationstool für die E-Commerce-Migration

Neues Commerce Experience Batchmigrationstool

Oktober 2022

API-Änderungen unterstützen neue Funktionen und fügen Felder "benefitOrderId", "benefitId" und "benefitType" zu abgerechneten und nicht abgerechneten täglich bewerteten Nutzungsdaten hinzu.

Funktionsbereich Änderungstyp API/Objekte
Verbesserung der Self-Serve-Richtlinie Neue Self-Serve-Richtlinienunterstützung für Azure-Sparpläne. Erstellen einer Self-Serve-Richtlinie Abrufen einer Liste von Self-Serve-RichtlinienAbrufen einer Self-Serve-RichtlinienressourceAktualisieren einer Self-Serve-Richtlinie
Abgerechnete täglich bewertete Nutzungsdaten Fügen Sie Felder "benefitOrderId", "benefitId" und "benefitType" zur täglich bewerteten Nutzungs-API hinzu. Rechnungsabrechnungspositionen für den gewerblichen Verbrauch abrufen
Unbilled Daily Rated Usage Data Fügen Sie Felder "benefitOrderId", "benefitId" und "benefitType" zur nicht berechneten täglich bewerteten Nutzungs-API hinzu. Abrufen von Rechnungspositionen für nicht abgerechnete Handelsverbrauchspositionen

September 2022

PI-Änderungen zum Hinzufügen von Feldern firstObserved und lastObserved to Fraud events.

Funktionsbereich Änderungstyp API/Objekte
NCE-Migration CustomTermEndDate wird der Migrations-API hinzugefügt. Erstellen einer Migration zum neuen E-Commerce-Verfahren
Azure-Betrugsbenachrichtigung Hinzufügen von firstObserved- und lastObserved-Feldern zu Betrugsereignissen Abrufen von Betrugsereignissen

Juli 2022

API-Änderungen unterstützen neue Funktionen.

Funktionsbereich Änderungstyp API/Objekte
Geplante Änderungen mit Heraufufung Machen Sie die Heraufsufungs-ID verfügbar, wenn die geplante Änderung an der verfügbaren Aktion ausgerichtet ist. Erstellen geplanter Änderungen

Juni 2022

API-Änderungen unterstützen Partner mit NCE-Migration.

Funktionsbereich Änderungstyp API/Objekte
Überprüfen der Migration Neue API zum Überprüfen eines Abonnements für die Migration zu new Commerce Experience Überprüfen eines Abonnements für die Migration
Erstellen einer neuen Migration Neue API zum Erstellen einer Migration eines Abonnements zu New Commerce Experience Erstellen einer Migration zum neuen E-Commerce-Verfahren
Migration eines neuen gewerblichen Abonnements Neue API zum Abrufen einer Migration eines Abonnements zu "New Commerce Experience", um den Migrationsstatus zu überprüfen Migration eines neuen gewerblichen Abonnements

Mai 2022

API-Änderungen unterstützen Partner, um DAP zu überwachen und inaktive DAPs zu entfernen.

Funktionsbereich Änderungstyp API/Objekte
DAP-Entfernung Entfernen Sie eine DAP-Beziehung (Delegierter Administrator) mit einem Kunden, den Sie nicht mehr verwalten müssen. Entfernen einer DAP-Partnerschaft mit einem Kunden
Delegierte Administratorbeziehungen auflisten Neue API zum Zurückgeben einer Liste aller Kunden eines Partners, die angibt, ob Kunden über eine DAP/nicht DAP-Beziehung verfügen Delegierte Administratorkunden auflisten
Abrufen delegierter Administratorstatistiken Gibt Informationen zur Anzahl der etablierten oder aktiven Beziehungen eines delegierten Administrators (DAP) zurück, die einem Partner in allen ihren Kunden zugeordnet sind. Abrufen delegierter Administratorstatistiken

März 2022

März-Änderungen umfassen Verbesserungen zur Unterstützung von neuen commerce-lizenzbasierten Features.

Funktionsbereich Änderungstyp API/Objekte
DAP-Entfernung Entfernen Sie eine DAP-Beziehung (Delegierter Administrator) mit einem Kunden, den Sie nicht mehr verwalten müssen. Entfernen einer DAP-Partnerschaft mit einem Kunden
Neuer Handelswagen Verfügbare Menge für CartLineItem-Antwort hinzugefügt Werbungsressource
Neuer Handelsübergang PromotionId zur Übergangsantwort hinzugefügt Transitions-Ressource

Dezember 2021

Dezemberänderungen umfassen Verbesserungen zur Unterstützung von lizenzbasierten Neuen Commerce-Features.

Funktionsbereich Änderungstyp API/Objekte
Promotions im neuen E-Commerce-Verfahren AvailableSeats zu Seatcounts hinzugefügt Werbungsressource
Promotions im neuen E-Commerce-Verfahren AvailableSeats zu Seatcounts hinzugefügt POST {baseURL}/v1/customers/{customerId}/promotionEligibilities
Azure-Betrugsbenachrichtigung Neue API Abrufen von Betrugsereignissen
Azure-Betrugsbenachrichtigung Neue API Status von Betrugsereignissen aktualisieren
Neue Commerce-Abonnements Erstattungsfähige Menge zum Abrufen des Abonnements nach ID-API hinzugefügt GET-Abonnement nach ID

Oktober 2021

Änderungen für Oktober sollen neue lizenzbasierte Features für den Handel und die neuen ISV-Margenrabatte für CSPs unterstützen.

Funktionsbereich Änderungstyp API/Objekte
Verwaltung neuer Commerce-Abonnements Neues Feld im öffentlichen Vertrag PATCH {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}
Neue Commerce-Upgrades und Testkonvertierungen Neues Feld im öffentlichen Vertrag POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transition
Neue Handelsübergänge Neues Feld im öffentlichen Vertrag GET {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transitions
Migrieren zu neuem Handel Neue API POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
Migrieren zu neuem Handel Neue API POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
Migrieren zu neuem Handel Neue API GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration-id}
Einkauf neuer Handel Neues Feld im öffentlichen Vertrag POST {baseURL}/v1/customers/{customer-id}/orders"
Einkauf neuer Handel Neues Feld im öffentlichen Vertrag POST{baseURL}/v1/customers/{customer-id}/carts
Einkauf neuer Handel Neues Feld im öffentlichen Vertrag PUT{baseURL}/v1/customers/{customer-id}/carts/{cart-id}
Promotions im neuen E-Commerce-Verfahren Neue API POST {baseURL}/v1/customers/{customerId}/promotionEligibilities
Promotions im neuen E-Commerce-Verfahren Neue API GET {baseURL}/v1/productpromotions/{promotion-id}?country={country-code}
Promotions im neuen E-Commerce-Verfahren Neue API GET {baseURL}/v1/productpromotions?country={country-code}&segment={segment}
Promotions im neuen E-Commerce-Verfahren Neue Ressource Werbungsressource
Katalogupdates für neuen Commerce Neues Feld im öffentlichen Vertrag GET {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment}
Katalogupdates für neuen Commerce Neues Feld im öffentlichen Vertrag POST {baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView}
Katalogupdates für neuen Commerce Neues Feld im öffentlichen Vertrag GET {baseURL}/v1/products/{product-id}?country={country}
Katalogupdates für neuen Commerce Neues Feld im öffentlichen Vertrag POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus
Katalogupdates für neuen Commerce Neues Feld im öffentlichen Vertrag GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
Katalogupdates für neuen Commerce Neues Feld im öffentlichen Vertrag GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
Katalogupdates für neuen Commerce Neues Feld im öffentlichen Vertrag GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities?country={country-code}&targetSegment={target-segment}
Katalogupdates für neuen Commerce Neues Feld im öffentlichen Vertrag POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus/{sku-id}
Katalogupdates für neuen Commerce Neues Feld im öffentlichen Vertrag GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code}
Katalogupdates für neuen Commerce Neues Feld im öffentlichen Vertrag Produktressourcen
ISV-Margenrabatte für CSPs Neue Ressource Margin-Ressource
ISV-Margenrabatte für CSPs Neue API GET {baseURL}/v1/margins
ISV-Margenrabatte für CSPs Neue API GET {baseURL}/v1/margins/download
Telco pay-as-you-go in new commerce Neue API PUT {baseURL}/customers/{customerId}/subscriptions/overage
Telco pay-as-you-go in new commerce Neue API GET {baseURL}/customers/{customerId}/subscriptions/overage
Telco pay-as-you-go in new commerce Neues Feld im öffentlichen Vertrag Hinzufügen von ConsumptionType zum Sku-Modell

Juli 2021

Änderungen für Juli wurden nur für einige Windows 365-SKUs benötigt, um den Windows 365-Nachweis zu unterstützen.

Funktionsbereich Änderungstyp API/Objekte
Windows 365-Nachweis Neues Feld im öffentlichen Vertrag Sku-Ressource
Windows 365-Nachweis Neues Feld im öffentlichen Vertrag Angebotsressource
Windows 365-Nachweis Neues Feld im öffentlichen Vertrag Einkaufswagenartikelressource
Windows 365-Nachweis Neues Feld im öffentlichen Vertrag GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
Windows 365-Nachweis Neues Feld im öffentlichen Vertrag GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
Windows 365-Nachweis Neues Feld im öffentlichen Vertrag PUT {baseURL}/v1/customers/{customer-id}/carts/{cart-id} HTTP/1.1

Dezember 2020

Zwei neue GET- und POST-Qualifikations-APIs wurden eingeführt. Die neuen APIs verwenden Qualifikation und nicht Qualifikation. Die APIs sind für Tests in FY21 Q2 verfügbar.

Funktionsbereich Änderungstyp API/Objekte
Kundenqualifizierung Neue API GET {baseURL}/v1/customers/{customer-tenant-id}/qualifications
Kundenqualifizierung Neue API POST {baseURL}/v1/customers/{customer_id}/qualifications?code={validationCode}

Was hat sich geändert?

Derzeit verfügt die Partner Center-API über GET- und PUT-Qualifikationen, um die Berechtigung von Education-Kunden zu überprüfen. Es gibt keine Änderungen an der GET-Qualifikations-API. Wir haben der PUT-Qualifikations-API jedoch einen Rückgabefall hinzugefügt.

  • GET – ändert sich nicht.
  • PUT - Rückgabefall wird hinzugefügt.

Diese APIs werden Ende Februar 2021 eingestellt, um wie unten beschrieben durch neue APIs ersetzt zu werden.

Betroffene Szenarien:

Kundenberechtigung für Bildungspreise für ausgewählte SKUs

Detailbeschreibungen

Es werden zwei neue GET- und POST-Qualifikations-APIs eingeführt. Die neuen APIs verwenden Qualifikation und nicht Qualifikation. Die APIs sind für Tests in FY21 Q2 verfügbar.

GET-Qualifikationen

GET {customer_id}/qualifications

Antwort Beispiel:

{
  "Qualification": "Education",
  "VettingStatus": "Denied",
  "VettingReason": "Not an education customer",
  "VettingCreatedDate": "07/09/2020: 00:00:00" //UTC
}

Antwortfelder:

  • VettingStatus-Werte: Genehmigt, Verweigert, InReview usw.

  • VettingReason-Werte:

    • Kein Education-Kunde
    • Kein Education-Kunde mehr
    • Kein Education-Kunde - Nach Überprüfung
    • Eingeschränkt als Education-Kunde
    • Kein Akademischer Do Standard
    • Keine berechtigte Bibliothek
    • Kein berechtigtes Museum

POST-Qualifikationen

POST {customer_id}/qualifications
    [
            "Qualification": "Education"
    ]

Antwort Beispiel:

{
  "Qualification": "Education",
  "VettingStatus": "InReview",
  "VettingCreatedDate": "07/09/2020: 00:00:00" //UTC
}

Nächste Schritte

Partner Center – REST-API-Referenz