Скачать прайс-лист
В этой статье объясняется, как получить ценовую таблицу для данного рынка и представления. Этот метод поддерживает фильтры для получения истории по месяцам.
Предварительные условия
- Учетные данные, описанные в статье об аутентификации в API для партнеров. Этот сценарий поддерживает только проверку подлинности пользователей приложений. Функция "только для приложений" пока не поддерживается. Партнеры, которые испытывают ошибку HTTP:400 , должны обратиться к документации по проверке подлинности API партнеров.
- Этот API в настоящее время поддерживает только доступ пользователей, где партнеры должны находиться в одной из следующих ролей: агент администрирования или агент продаж.
Сведения
- Текущие данные возвращаются только для использования Azure плана, резервирования, продуктов на основе лицензий (новый коммерческий опыт) и продуктов Marketplace.
- В текущие цены включены все единицы измерений и продукты, доступные в течение текущего месяца до даты вызова API. Предыдущие месяцы включают все счетчики и продукты, доступные в течение данного месяца.
- Цены на счётчики потребления указываются только в долларах США, партнёрам предлагается использовать API валютных курсов для расчёта стоимости в локальной валюте.
- Цены на счетчики потребления указаны как ориентировочные розничные цены. Скидки для партнеров доступны через партнерский заработанный кредит.
- Цены за услуги бронирования включают скидки от партнеров CSP. Предполагаемые розничные цены на резервирование можно найти в загружаемом разделе общих служб на странице "Цены и предложения" Центра партнеров.
- Дополнительные сведения о ценах на план Azure см. в документации по ценам на план Azure.
- Цены на партнеров и API валютных курсов не являются частью пакета SDK Центра партнеров.
- Этот метод возвращает прайс-список в виде потока файлов. Поток файлов — это файл .csv или сжатый zip-файл .csv. Ниже приведены сведения о том, как запрашивать сжатые файлы.
Запрос REST
Синтаксис запроса
Способ | URI запроса |
---|---|
GET | https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value |
Обязательные параметры URI
Используйте следующие параметры пути, чтобы запросить нужный рынок и тип ценового листа.
Имя. | Тип | Обязательно | Описание |
---|---|---|---|
Рынок | строка | Да | Двухбуквенный код страны или региона для запрашиваемого рынка |
Просмотр ценового листа | строка | Да | Тип запрашиваемого ценового листа, который может быть azure_consumption, azure_reservations, updatedlicensebased, marketplace или программное обеспечение. |
Примечание.
Обновленная версия PriceSheetView на основе лицензий в настоящее время доступна только партнерам, которые являются частью технического предварительного просмотра новой коммерческой платформы Microsoft 365/Microsoft Dynamics 365.
Примечание.
В настоящее время прайс-лист на основе лицензий доступен только для скачивания через интерфейс Центра партнеров.
Параметры фильтра URI
Используйте следующие параметры фильтра.
Имя. | Тип | Обязательно | Описание |
---|---|---|---|
Временная шкала | строка | Нет | По умолчанию используется текущий, если он не передан. Возможные значения: история, текущее и будущее. |
месяц | строка | Нет | Требуется только в том случае, если запрашивается история, и должен соответствовать формату YYYYMM для запрашиваемого ценового листа. |
Примечание.
Будущие цены не поддерживаются для Marketplace. С 1 апреля 2022 года партнеры смогут просматривать журнал прайс-списков программного обеспечения с помощью API, начиная с марта 2022 года.
Заголовки запросов
- Более подробную информацию см. в документе Заголовки REST партнера.
В дополнение к приведенным выше заголовкам файлы цен можно получить в сжатом виде, что сокращает пропускную способность и время загрузки. По умолчанию файлы не сжимаются. Чтобы получить сжатые версии файлов, можно включить следующее значение заголовка. Осознайте, что сжатые листы доступны только с апреля 2020 года, все листы до апреля 2020 года доступны только как не сжатые.
Верхний колонтитул | Тип значения | значение | Описание |
---|---|---|---|
Accept-Encoding | строка | сдувать | Необязательно. Если опущенный поток файлов не сжимается. |
Пример запроса
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='ad',PricesheetView='azure_consumption')/$value?timeline=history&month=201909 HTTP/1.1
Authorization: Bearer
Host: api.partner.microsoft.com
Пример запроса для новой коммерции
Примечание.
Обновленный PriceSheetView на основе лицензии в настоящее время доступен только партнерам, которые участвуют в технической предварительной версии новой коммерческой программы для Microsoft 365 и Microsoft Dynamics 365.
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=history&month=202101 HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com
Ответ REST
В случае успешного выполнения этот метод возвращает прайс-список в виде потока файлов. Поток файлов — это файл .csv или сжатый zip-файл .csv.
Пример ответа для новой торговой системы
Примечание.
Обновленная версия PriceSheetView, основанная на лицензии, в настоящее время доступна только партнерам, которые участвуют в техническом предварительном просмотре новой коммерческой среды Microsoft 365/Microsoft Dynamics 365.
HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=sheets.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT
"ProductTitle","ProductId","SkuId","SkuTitle","Publisher","SkuDescription","UnitOfMeasure","TermDuration","BillingPlan","Market","Currency","UnitPrice","PricingTierRangeMin","PricingTierRangeMax","EffectiveStartDate","EffectiveEndDate","Tags","ERP Price"
"Advanced Communications","CFQ7TTC0HDK0","0001","Advanced Communications","Microsoft Corporation","Advanced meetings, calling, workflow integration, and management tools for IT.","","P1Y","Annual","US","USD","115.2","","","2/1/2019 12:00:00 AM","2/4/2021 8:35:31 PM","License","144"
======= Truncated ==============
Коды успешного и ошибочного выполнения
Каждый ответ содержит код состояния HTTP, указывающий на успешность или сбой, а также другие сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и других параметров. См. полный список кодов ошибок.
Если для новой лицензированной коммерческой спецификации нет ожидаемых изменений, будущий прайс-лист возвращен не будет. При попытке передачи будущей даты во временную шкалу, запрашиваемую для обновленной лицензированной версии PriceSheetView, партнеры увидят следующий код ответа API: 404 Not Found, что означает, что запрашиваемый элемент не найден.