Baixar margens
Aplica-se a: Partner Center
Funções apropriadas: Agente administrativo
Os parceiros podem obter uma lista de margens ativas para um determinado parceiro. Esse método retorna margens com base no parceiro e nas datas de início e término disponíveis. Baixar margens retorna os dados em um formato delimitado por vírgulas.
Pré-requisitos
- Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
Solicitação REST
[GET] /v1/margens/download
Sintaxe da solicitação
| Método | URI da solicitação |
|---|---|
| GET | {baseURL}/v1/margins/download?country={countrycode} HTTP/1.1 |
Para obter uma lista de códigos de país, consulte Códigos de país, região, estado e província de venda conjunta.
Parâmetro do URI
Esta tabela lista os parâmetros de consulta necessários.
| Nome | Digitar | Obrigatória | Descrição |
|---|---|---|---|
| country | String | Y | O valor é uma cadeia de caracteres que denota o código do país. |
Cabeçalhos da solicitação
Para obter mais informações, confira Cabeçalhos REST do Partner Center.
Corpo da solicitação
Nenhum
Exemplo de solicitação
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
Resposta REST
Se for bem-sucedido, esse método retornará a lista de preços como um fluxo de arquivos como a.csv arquivo
Códigos de êxito e de erro de resposta
Cada resposta vem com um código de status HTTP que indica êxito ou falha e mais informações de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e mais parâmetros. Para obter a lista completa, confira Códigos de Erro.
Exemplo de resposta
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"