Freigeben über

Abrufen einer Angebotsmatrix

  • Artikel

In diesem Artikel wird erläutert, wie Sie eine Angebotsmatrix für einen bestimmten Monat erhalten. Die Angebotsmatrix enthält Eigenschaften und Einkaufsregeln für die Produkte und Skus. Diese Methode unterstützt Filter zum Abrufen des Verlaufs nach Monat.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner-API-Authentifizierung beschrieben. Dieses Szenario unterstützt nur die Anwendungsbenutzerauthentifizierung. Nur Anwendung wird noch nicht unterstützt. Partner, die http error:400 erleben, sollten sich in der Dokumentation zur Partner-API-Authentifizierung informieren.
  • Diese API unterstützt derzeit nur den Benutzerzugriff, bei dem Partner in einer der folgenden Rollen sein müssen: globaler Administrator, Administrator-Agent oder Vertriebsmitarbeiter.

Details

  • Aktuell werden nur Daten für aktualisierte neue Commerce-lizenzbasierte Produkte zurückgegeben.
  • Aktuelle Preise umfassen Produkte, die während des aktuellen Monats verfügbar sind, bis zum Datum, an dem die API aufgerufen wird. Die vorherigen Monate enthalten datumsangabe ab dem letzten Tag des ausgewählten Monats.
  • Diese Methode gibt Daten als Dateidatenstrom zurück. Der Dateidatenstrom ist entweder eine CSV-Datei oder eine komprimierte ZIP-Version der CSV-Datei. Details 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 Type Erforderlich Beschreibung
Monat Zeichenfolge Nein Muss für das angeforderte Preisblatt JJJJMM einhalten.

Anforderungsheader

Neben den obigen Headern können Preisdateien als komprimiert abgerufen werden, um Bandbreite und Downloadzeiten zu reduzieren. Standardmäßig werden die Dateien nicht komprimiert. Um komprimierte Versionen der Dateien zu erhalten, können Sie den folgenden Headerwert einschließen. Stellen Sie fest, dass komprimierte Blätter nur ab April 2020 verfügbar sind, alle Blätter vor April 2020 nur als nicht komprimiert verfügbar sind.

Header Typ Wert Beschreibung
Accept-Encoding Zeichenfolge deflate Optional. Wenn kein Dateidatenstrom angegeben wird, wird der Dateidatenstrom nicht komprimiert.

Beispiel für eine Anfrage

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

Wenn die Methode erfolgreich verläuft, wird eine Angebotsmatrix als Dateidatenstrom zurückgegeben. Der Dateidatenstrom ist entweder eine CSV-Datei oder eine komprimierte ZIP-Version der CSV-Datei.

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.

Beispielantwort

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 ==============

Nächste Schritte