Ladda ned marginaler
Gäller för: Partnercenter
Lämpliga roller: Administratörsagent
Partner kan få en lista över aktiva marginaler för en viss partner. Den här metoden returnerar marginaler baserat på partnern och tillgängliga start- och slutdatum. Nedladdningsmarginaler returnerar data i kommaavgränsat format.
Förutsättningar
- Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
REST-begäran
[GET] /v1/margins/download
Syntax för begäran
| Metod | URI för förfrågan |
|---|---|
| GET | {baseURL}/v1/margins/download?country={countrycode} HTTP/1.1 |
En lista över landskoder finns i Koderna För säljsamarbete, land, region, delstat och provins.
URI-parameter
I den här tabellen visas de frågeparametrar som krävs.
| Namn | Typ | Obligatoriskt | Beskrivning |
|---|---|---|---|
| land | String | Y | Värdet är en sträng som anger landskoden. |
Begärandehuvuden
Mer information finns i REST-huvuden för Partnercenter.
Begärandetext
Ingen
Exempel på begäran
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-svar
Om det lyckas returnerar den här metoden prislistan som en filström som a.csv fil
Svarsframgång och felkoder
Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och mer felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och fler parametrar. Den fullständiga listan finns i Felkoder.
Svarsexempel
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"