Stáhnout okraje
Platí pro: Partnerské centrum
Příslušné role: Agent pro správu
Partneři mohou získat seznam aktivních marží pro daného partnera. Tato metoda vrátí marže na základě partnera a dostupného počátečního a koncového data. Stáhnout okraje vrátí data ve formátu odděleném čárkami.
Požadavky
- Přihlašovací údaje, jak je popsáno na stránce Ověření Partnerského centra. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace+uživatele.
Požadavek REST
[GET] /v1/margins/download
Syntaxe požadavku
metoda | Identifikátor URI žádosti |
---|---|
GET | {baseURL}/v1/margins/download?country={countrycode} HTTP/1.1 |
Seznam kódů zemí najdete v tématu Země spoluprodeje, oblast, stát a kódy provincií.
Parametr identifikátoru URI
Tato tabulka obsahuje seznam požadovaných parametrů dotazu.
Name | Typ | Požadováno | Popis |
---|---|---|---|
země | Řetězec | Y | Hodnota je řetězec, který označuje kód země. |
Záhlaví žádosti
Další informace najdete v tématu REST hlavičky Partnerského centra.
Tělo žádosti
Nic
Příklad požadavku
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
Odpověď REST
V případě úspěchu vrátí tato metoda ceník jako datový proud souboru ve formátu .csv.
Kódy úspěšnosti a chyb odpovědi
Každá odpověď obsahuje stavový kód HTTP, který indikuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v sekci Kódy chyb.
Příklad odpovědi
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"