Freigeben über


Herunterladen von Margen

Gilt für: Partner Center

Geeignete Rollen: Administrator-Agent

Partner können eine Liste aktiver Ränder für einen bestimmten Partner abrufen. Diese Methode gibt Ränder basierend auf dem Partner und verfügbaren Anfangs- und Enddaten zurück. Downloadränder geben die Daten in einem durch Trennzeichen getrennten Format zurück.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.

REST-Anforderung

[GET] /v1/margins/download

Anforderungssyntax

Methode Anforderungs-URI
GET {baseURL}/v1/margins/download?country={countrycode} HTTP/1.1

Eine Liste der Ländercodes finden Sie unter co-sell country, region, state, and province codes.

URI-Parameter

In dieser Tabelle sind die erforderlichen Abfrageparameter aufgeführt.

Name Type Erforderlich Beschreibung
country String Y Der Wert ist eine Zeichenfolge, die den Ländercode angibt.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine

Anforderungsbeispiel

GET https://api.partnercenter.microsoft.com/v1/margins/download?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

REST-Antwort

Wenn die Methode erfolgreich verläuft, wird die Preisliste als Dateidatenstrom als a.csv Datei zurückgegeben.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler und weitere Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und weitere Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Beispielantwort

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

"b82103f870af_e71f19b1-27cf-43d3-be46-3d87a9d908a2","US","Percentage","Test PMC 2 PC","DZH318Z0FTST","HelloWorld3","0002","plan1","Dynamics 365","3b274863-227e-4b2c-a463-330b949e2e34","3pptesting","8.0","","","","","","","","","8/14/2023 6:09:28 PM","10/31/2023 11:59:59 PM","live","8/14/2023 6:09:28 PM"