Abrufen eines Preisblatts

  • Artikel

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

  • Aktuelle Daten werden nur für Azure-Plannutzung und -reservierungen, lizenzierte (neue Commerce-Erfahrung) und Marketplace-Produkte zurückgegeben.
  • Aktuelle Preise umfassen alle Meter 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, aktualisiert, lizenziert, marketplace oder Software sein kann.

Hinweis

updatedlicensebased PriceSheetView ist derzeit nur für Partner verfügbar, die Teil der microsoft 365/Microsoft Dynamics 365 neuen Commerce Experience technical preview sind.

Hinweis

Die Softwarepreisliste wird ab dem 1. April 2022 über die API verfügbar sein.

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

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 neuen 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 neuen 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.

Nächste Schritte