Descarga de márgenes
Se aplica a: Centro de partners
Roles adecuados: Agente de administración
Los asociados pueden obtener una lista de márgenes activos para un asociado determinado. Este método devuelve márgenes basados en el asociado y las fechas de inicio y finalización disponibles. Los márgenes de descarga devuelven los datos en un formato delimitado por comas.
Requisitos previos
- Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con credenciales de aplicación independiente y app+usuario.
Solicitud REST
[GET] /v1/margin/download
Sintaxis de la solicitud
| Método | URI de solicitud |
|---|---|
| GET | {baseURL}/v1/margin/download?country={countrycode} HTTP/1.1 |
Para obtener una lista de códigos de país, consulte Códigos de país, región, estado y provincia.
Parámetro de URI
En esta tabla se enumeran los parámetros de consulta necesarios.
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
| country | Cadena | Y | El valor es una cadena que denota el código de país. |
Encabezados de solicitud
Para obtener más información, consulta Encabezados REST del Centro de partners.
Cuerpo de la solicitud
Ninguno
Ejemplo de solicitud
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
Respuesta REST
Si se ejecuta correctamente, este método devuelve la lista de precios como un flujo de archivos como archivo a.csv
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica éxito o error y más información de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y más parámetros. Para obtener la lista completa, consulte Códigos de error.
Ejemplo de respuesta
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"