Поделиться через


Скачать прайс-лист

В этой статье объясняется, как получить ценовую таблицу для данного рынка и представления. Этот метод поддерживает фильтры для получения истории по месяцам.

Предварительные условия

  • Учетные данные, описанные в статье об аутентификации в 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 года.

Заголовки запросов

В дополнение к приведенным выше заголовкам файлы цен можно получить в сжатом виде, что сокращает пропускную способность и время загрузки. По умолчанию файлы не сжимаются. Чтобы получить сжатые версии файлов, можно включить следующее значение заголовка. Осознайте, что сжатые листы доступны только с апреля 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, что означает, что запрашиваемый элемент не найден.