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 Anwendungsbenutzerauthentifizierung. Die reine Anwendungsauthentifizierung 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 Sich Partner in einer der folgenden Rollen befinden 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. Details zum Anfordern komprimierter Dateien folgen.

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 No Muss für das angeforderte Preisblatt JJJJMM einhalten.

Anforderungsheader

Zusätzlich zu diesen Headern können Preisdateien als komprimierte Reduzierung der Bandbreite und Downloadzeiten abgerufen werden. Standardmäßig werden die Dateien nicht komprimiert. Um komprimierte Versionen der Dateien abzurufen, 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 dieser Parameter nicht angegeben wird, wird der Dateidatenstrom 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

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.

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

Zugehöriger Inhalt