Marginesy pobierania

Dotyczy: Centrum partnerskie

Odpowiednie role: Agent administracyjny

Partnerzy mogą uzyskać listę aktywnych marginesów dla danego partnera. Ta metoda zwraca marginesy na podstawie partnera i dostępnych dat rozpoczęcia i zakończenia. Marginesy pobierania zwracają dane w formacie rozdzielonym przecinkami.

Wymagania wstępne

• Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.

Żądanie REST

[GET] /v1/margins/download

Składnia żądania

Method	Identyfikator URI żądania
GET	{baseURL}/v1/margins/download?country={countrycode} HTTP/1.1

Aby uzyskać listę kodów krajów, zobacz Kod kraju wspólnej sprzedaży, regionu, stanu i prowincji.

Parametr identyfikatora URI

W tej tabeli wymieniono wymagane parametry zapytania.

Nazwisko	Type	Wymagania	opis
kraj	String	Y	Wartość jest ciągiem, który określa kod kraju.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Brak

Przykład żądania

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

Odpowiedź REST

Jeśli ta metoda powiedzie się, ta metoda zwraca cennik jako strumień plików jako plik a.csv

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i więcej informacji o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, zobacz Kody błędów.

Przykład odpowiedzi

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"