Erhalten einer Angebotsmatrix

Gilt für:

  • Partner-API
  • Die Technical Preview für M365/D365 New Commerce. Die folgenden Neuen Commerce-Änderungen sind derzeit nur für Partner verfügbar, die Teil der Technical Preview für M365/D365 new commerce experience sind.

In diesem Thema wird erläutert, wie Sie eine Angebotsmatrix für einen bestimmten Monat erhalten. Die Angebotsmatrix enthält Eigenschaften und Kaufregeln für die Produkte und SKUs. Diese Methode unterstützt Filter, um den Verlauf nach Monat zu erhalten.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner-API-Authentifizierung beschrieben. Dieses Szenario unterstützt nur die Anwendungsbenutzerauthentifizierung. Nur Anwendung wird noch nicht unterstützt. Partner, bei denen der HTTP-Fehler 400 auftritt, sollten die Dokumentation Partner-API Authentifizierung lesen.
  • Diese API unterstützt derzeit nur den Benutzerzugriff, bei dem Partner eine der folgenden Rollen haben müssen: Globaler Administrator, Administrator-Agent oder Vertriebs-Agent.

Details

  • Current gibt nur Daten für aktualisierte neue lizenzbasierte Commerce-Produkte zurück.
  • Die aktuellen Preise umfassen Produkte, die während des aktuellen Monats bis zum Aufruf der API verfügbar sind. Vorherige Monate enthalten das Datum ab dem letzten Tag des ausgewählten Monats.
  • Diese Methode gibt Daten als Dateistream zurück. Der Dateistream ist entweder eine .csv-Datei oder eine zip-komprimierte Version des .csv. Weitere Informationen zum Anfordern komprimierter Dateien finden Sie unten.

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value

URI-Filterparameter

Verwenden Sie die folgenden Filterparameter.

Name Typ Erforderlich Beschreibung
Month Zeichenfolge Nein Muss YYYYMM für das angeforderte Preisblatt einhalten.

Anforderungsheader

Zusätzlich zu den oben genannten Headern können Preisdateien als komprimiert abgerufen werden, um bandbreiten- und downloadzeiten zu reduzieren. Standardmäßig werden die Dateien nicht komprimiert. Um komprimierte Versionen der Dateien zu erhalten, können Sie den folgenden Headerwert angeben. Stellen Sie fest, dass komprimierte Blätter nur ab April 2020 verfügbar sind. Alle Blätter vor April 2020 sind nur als nicht komprimiert verfügbar.

Header Werttyp Wert Beschreibung
Accept-Encoding Zeichenfolge Deflate Dies ist optional. Wenn der Dateidatenstrom ausgelassen wird, wird er nicht komprimiert.

Anforderungsbeispiel

GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='202101')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

REST-Antwort

Bei Erfolg gibt diese Methode eine Angebotsmatrix als Dateistream zurück. Der Dateistream ist entweder eine .csv-Datei oder eine zip-komprimierte Version des .csv.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Antwortbeispiel

HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=updatedoffice.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT

"ProductTitle","ProductId","SkuId","SkuTitle","ProvisioningId","ProvisioningString","MinLicenses","MaxLicenses","AssetOwnershipLimit","AssetOwnershipLimitType","ProductSkuPreRequisites","ProductSkuConversion","Description","AllowedCountries" 
"Microsoft 365 Business Basic","CFQ7TTC0LH18","0001","Microsoft 365 Business Basic","3b555118-da6a-4418-894f-7df1e2096870","O365_BUSINESS_ESSENTIALS","1","300","2","ConcurrentCount","","CFQ7TTC0LDPB/0001,CFQ7TTC0LF8Q/0001","Best for businesses that need professional...","AD;AE;AF;AG;AI;AL;AM;AO..."
======= Truncated ==============