Abrufen eines Preisblatts
In diesem Artikel wird erläutert, wie Sie ein Preisblatt für einen bestimmten Markt und eine bestimmte Ansicht erhalten. 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 Partner in einer der folgenden Rollen sein müssen: Administrator-Agent oder Vertriebsmitarbeiter.
Details
- Aktuelle Daten werden nur für Azure-Plannutzung und -reservierungen, lizenzierte (neue Commerce-Erfahrung) und Marketplace-Produkte zurückgegeben.
- Aktuelle Preise umfassen alle Verbrauchseinheiten und Produkte, die im aktuellen Monat bis zum Datum verfügbar sind, an dem die API aufgerufen wird. In den letzten Monaten sind alle Zähler und Produkte enthalten, die für den jeweiligen Monat verfügbar sind.
- Verbrauchszählerpreise sind nur in USD, Partner sollen die Wechselkurs-API verwenden, um lokale Währungskosten zu berechnen.
- Verbrauchszählerpreise sind geschätzte Verkaufspreise. Partnerrabatte sind über partnerverzinste Gutschrift verfügbar.
- Reservierungszählerpreise umfassen die CSP-Partnerrabatte. Geschätzte Verkaufspreise für Reservierungen finden Sie auf der Seite "Preise und Angebote" im Partner Center.
- Weitere Informationen zu Azure-Planpreisen finden Sie in der Azure-Plan-Preisdokumentation.
- Partnerpreise und Wechselkurs-APIs sind nicht Teil des Partner Center SDK.
- Diese Methode gibt die Preisliste als Dateidatenstrom zurück. Der Dateidatenstrom ist entweder eine .csv Datei oder eine komprimierte Zip-Version der .csv. Details zum Anfordern komprimierter Dateien finden Sie unten.
REST-Anforderung
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| GET | https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value |
Erforderliche URI-Parameter
Verwenden Sie die folgenden Pfadparameter, um den markt und den gewünschten Preisblatttyp anzufordern.
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| Markt | Zeichenfolge | Ja | Zwei Buchstaben Landes-/Regionscode für den angeforderten Markt |
| PricesheetView | Zeichenfolge | Ja | Die Art der angeforderten Preisliste, die azure_consumption, azure_reservations, updatedlicensebased, licensebasedbeta (um die Änderungsindikatorspalte einzuschließen), Marketplace oder Software sein kann. |
Hinweis
updatedlicensebased PriceSheetView ist derzeit nur für Partner verfügbar, die Teil der Microsoft 365/Microsoft Dynamics 365 neue Commerce Experience Technical Preview sind.
Hinweis
Das lizenzbasierte Preisblatt für das Ende des Verkaufs steht derzeit nur zum Download über die Partner Center UX zur Verfügung.
URI-Filterparameter
Verwenden Sie die folgenden Filterparameter.
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| Zeitachse | Zeichenfolge | No | Wird standardmäßig auf "current" festgelegt, wenn sie nicht übergeben wird. Mögliche Werte sind Verlauf, Aktuelle und Zukunft. |
| Monat | Zeichenfolge | No | Nur erforderlich, wenn der Verlauf angefordert wird, muss JJJJMM für das angeforderte Preisblatt einhalten. |
Hinweis
Zukünftige Preise werden für Marketplace nicht unterstützt. Ab dem 1. April 2022 können Partner den Softwarepreislistenverlauf ab März 2022 über die API anzeigen.
Anforderungsheader
- Weitere Informationen finden Sie unter Partner-REST-Headern.
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. |
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 Microsoft 365/Microsoft Dynamics 365 neue 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
Wenn die Methode erfolgreich verläuft, wird die Preisliste als Dateidatenstrom zurückgegeben. Der Dateidatenstrom ist entweder eine .csv Datei oder eine komprimierte Zip-Version der .csv.
Antwortbeispiel für neuen Handel
Hinweis
updatedlicensebased PriceSheetView ist derzeit nur für Partner verfügbar, die Teil der Microsoft 365/Microsoft Dynamics 365 neue 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 Erfolg oder Fehler und andere Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.
Wenn für die neue commerce-lizenzierte zukünftige Preisliste keine Änderungen erwartet werden, wird keine zukünftige Preisliste zurückgegeben. Wenn sie die für die aktualisiertelicensebased PriceSheetView angeforderte Zeitachse übergeben, sehen Partner den folgenden API-Antwortcode: 404 Nicht gefunden.