Abrufen eines Preisblatts
Gilt für:
- Partner-API
In diesem Thema wird erläutert, wie Sie ein Preisblatt für einen bestimmten Markt und eine bestimmte Ansicht erhalten. Diese Methode unterstützt Filter, um den Verlauf nach Monat abzurufen.
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 http-Fehler:400 auftritt, sollten die Dokumentation zur 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
- Aktuell werden nur Daten für die Nutzung von Azure-Plänen und Reservierungen, lizenzierte (neue Handelserfahrung) und Marketplace-Produkte zurückgegeben.
- Die aktuellen Preise umfassen alle Zähler und Produkte, die während des aktuellen Monats bis zu dem Datum verfügbar sind, an dem die API aufgerufen wird. In den vorherigen Monaten sind alle Zähler und Produkte enthalten, die für den jeweiligen Monat verfügbar sind.
- Die Verbrauchszählerpreise liegen nur in USD. Partner müssen die Wechselkurs-API verwenden, um die Kosten für die lokale Währung zu berechnen.
- Verbrauchszählerpreise sind geschätzte Einzelhandelspreise. Partnerrabatte sind über vom Partner erworbenes Guthabenverfügbar.
- Die Preise der Reservierungszähler enthalten die Rabatte für CSP-Partner. Die geschätzten Einzelhandelspreise für Reservierungen finden Sie in den freigegebenen Reservierungsdiensten, die sie auf der Seite "Preise und Angebote" Partner Center herunterladen können.
- Weitere Informationen zu den Preisen für Azure-Pläne finden Sie in der Dokumentation zu den Preisen des Azure-Plans.
- Partnerpreise und Wechselkurs-APIs sind nicht Teil der Partner Center SDK.
- Diese Methode gibt die Preisliste als Dateistream zurück. Der Dateistream ist entweder eine .csv-Datei oder eine komprimierte ZIP-Version des .csv. Details zum Anfordern komprimierter Dateien finden Sie unten.
REST-Anforderung
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| GET | '{market}',PricesheetView='{view}')/$value |
Erforderliche URI-Parameter
Verwenden Sie die folgenden Pfadparameter, um den gewünschten Markt und Typ des Preisblatts anzufordern.
| Name | Typ | Erforderlich | BESCHREIBUNG |
|---|---|---|---|
| Market | Zeichenfolge | Ja | Zweistelliger Ländercode für den angeforderten Markt |
| PricesheetView | Zeichenfolge | Ja | Der Angeforderte Preisblatttyp kann azure_consumption, azure_reservations, updatedlicensebased oder Marketplace sein. |
Hinweis
updatedlicensebased PriceSheetView ist derzeit nur für Partner verfügbar, die Teil der M365/D365 New Commerce Experience Technical Preview sind.
URI-Filterparameter
Verwenden Sie die folgenden Filterparameter.
| Name | Typ | Erforderlich | BESCHREIBUNG |
|---|---|---|---|
| Zeitachse | Zeichenfolge | No | Der Standardwert ist "current", wenn er nicht übergeben wird. Mögliche Werte sind Verlauf, Aktuell und Zukunft. |
| Month (Monat) | Zeichenfolge | No | Nur erforderlich, wenn der Verlauf angefordert wird, muss YYYYMM für das angeforderte Preisblatt einhalten. |
Hinweis
Der Verlauf der Marketplace-Preise ist ab Dezember 2021 verfügbar. Zukünftige Preise werden für Marketplace nicht unterstützt.
Anforderungsheader
- Weitere Informationen findest du unter Partner-API: REST-Header.
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 abzurufen, können Sie den folgenden Headerwert einschließen. Stellen Sie fest, dass komprimierte Blätter erst ab April 2020 verfügbar sind und alle Blätter vor April 2020 nur als nicht komprimiert verfügbar sind.
| Header | Werttyp | Wert | BESCHREIBUNG |
|---|---|---|---|
| Accept-Encoding | Zeichenfolge | Deflate | Optional. Wenn der ausgelassene Dateistream nicht komprimiert ist. |
Anforderungsbeispiel
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='ad',PricesheetView='azure_consumption')/$value?timeline=history&month=201909 HTTP/1.1
Authorization: Bearer
Host: api.partner.microsoft.com
Anforderungsbeispiel für neuen Commerce
Hinweis
updatedlicensebased PriceSheetView ist derzeit nur für Partner verfügbar, die Teil der M365/D365 New Commerce Experience Technical Preview sind.
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=history&month=202101 HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com
REST-Antwort
Bei Erfolg gibt diese Methode die Preisliste als Dateistream zurück. Der Dateistream ist entweder eine .csv-Datei oder eine komprimierte ZIP-Version des .csv.
Antwortbeispiel für neuen Commerce
Hinweis
updatedlicensebased PriceSheetView ist derzeit nur für Partner verfügbar, die Teil der M365/D365 New Commerce Experience Technical Preview sind.
HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=sheets.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT
"ProductTitle","ProductId","SkuId","SkuTitle","Publisher","SkuDescription","UnitOfMeasure","TermDuration","BillingPlan","Market","Currency","UnitPrice","PricingTierRangeMin","PricingTierRangeMax","EffectiveStartDate","EffectiveEndDate","Tags","ERP Price“
"Advanced Communications","CFQ7TTC0HDK0","0001","Advanced Communications","Microsoft Corporation","Advanced meetings, calling, workflow integration, and management tools for IT.","","P1Y","Annual","US","USD","115.2","","","2/1/2019 12:00:00 AM","2/4/2021 8:35:31 PM","License","144"
======= Truncated ==============
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.