Скачивание полей
Область применения: Центр партнеров
Соответствующие роли: агент по администрированию
Партнеры могут получить список активных полей для данного партнера. Этот метод возвращает поля на основе партнеров и доступных дат начала и окончания. Поля скачивания возвращают данные в формате с разделителями-запятыми.
Необходимые компоненты
- Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности с помощью автономных учетных данных приложения и приложения и пользователя.
Запрос REST
[GET] /v1/margins/download
Синтаксис запроса
Способ | URI запроса |
---|---|
GET | {baseURL}/v1/margins/download?country={countrycode} HTTP/1.1 |
Список кодов стран см. в коде совместного продажи страны, региона, штата и провинции.
Параметр универсального кода ресурса
В этой таблице перечислены необходимые параметры запроса.
Имя. | Type | Обязательно | Описание |
---|---|---|---|
country | Строка | Y | Это строка, которая обозначает код страны. |
Заголовки запросов
Дополнительные сведения см. в статье о заголовках REST Центра партнеров.
Текст запроса
нет
Пример запроса
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
В случае успешного выполнения этот метод возвращает прайс-список в виде потока файлов в виде файла a.csv
Коды успешного выполнения и ошибок в ответе
Каждый ответ поставляется с кодом состояния HTTP, который указывает на успешность или сбой и дополнительные сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и других параметров. См. полный список кодов ошибок.
Пример ответа
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"