Marges downloaden

Artikel
09/26/2024

Van toepassing op: Partnercentrum

Juiste rollen: Beheerdersagent

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.

Name	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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

REST-antwoord

Als dit lukt, retourneert deze methode de prijslijst als een bestandsstroom als a.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: 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"

Delen via