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

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

  • Статья

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

Необходимые компоненты

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

Используйте следующие параметры пути, чтобы запросить нужный рынок и тип ценового листа.

Имя. Type Обязательно Описание
Рынок строка Да Код страны или региона для запрашиваемого рынка
PricesheetView строка Да Тип запрашиваемого ценового листа, который может быть azure_consumption, azure_reservations, обновленную базу данных, licensebasedbeta (для включения столбца индикатора изменений), Marketplace или программного обеспечения.

Примечание.

Обновленная версия PriceSheetView в настоящее время доступна только партнерам, которые являются частью Microsoft 365/Microsoft Dynamics 365 новой коммерческой предварительной версии.

Примечание.

В настоящее время ценовая страница на основе лицензий на основе лицензии доступна только для скачивания с помощью пользовательского интерфейса Центра партнеров.

Параметры фильтра URI

Используйте следующие параметры фильтра.

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

Связанный контент