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"