Marges downloaden

  • Artikel

Van toepassing op: Partnercentrum

Juiste rollen: globale beheerder | Beheer agent

Partners kunnen een lijst met actieve marges voor een bepaalde partner ophalen. Deze methode retourneert marges op basis van de partner en beschikbare begin- en einddatums. Downloadmarges retourneren de gegevens in een door komma's gescheiden indeling.

Vereisten

  • Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

REST-aanvraag

[GET] /v1/margins/download

Aanvraagsyntaxis

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

Zie Land-, regio-, staat- en provinciecodes voor collectieve verkoop voor een lijst met landcodes.

URI-parameter

Deze tabel bevat de vereiste queryparameters.

Naam Type Vereist Beschrijving
land String J De waarde is een tekenreeks die de landcode aangeeft.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen

Aanvraagvoorbeeld

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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

REST-antwoord

Als dit lukt, retourneert deze methode de prijslijst als een bestandsstroom als een.CSV-bestand

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het succes of de fout optreedt en meer informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en meer parameters te lezen. Zie Foutcodes voor de volledige lijst.

Responsvoorbeeld

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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"