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


Получить таблицу предложения

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

Требуемые условия

  • Учетные данные, описанные в статье об аутентификации в API для партнеров. Этот сценарий поддерживает только проверку подлинности пользователей приложений. Функция "только для приложений" пока не поддерживается. Партнеры, которые испытывают ошибку HTTP:400 , должны обратиться к документации по проверке подлинности API партнеров.
  • Этот API в настоящее время поддерживает только доступ пользователей, где партнеры должны находиться в одной из следующих ролей: агент администрирования или агент продаж.

Сведения

  • В настоящее время возвращаются данные только для обновленных новых коммерческих продуктов, основанных на лицензиях.
  • Текущие цены включают продукты, доступные в течение текущего месяца до даты вызова API. Предыдущие месяцы включают дату по состоянию на последний день выбранного месяца.
  • Этот метод возвращает данные в виде потока файлов. Поток файлов — это файл .csv или сжатый zip-файл .csv. Информация о том, как запросить сжатые файлы, будет представлена далее.

Запрос REST

Синтаксис запроса

Способ URI запроса
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value

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

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

Имя. Тип Обязательно Описание
месяц строка Нет Необходимо соблюдать формат YYYYMM для запрашиваемого ценового листа.

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

Помимо этих заголовков, файлы с ценами можно получить в сжатом виде, что сокращает пропускную способность и время загрузки. По умолчанию файлы не сжимаются. Чтобы получить сжатые версии файлов, можно включить следующее значение заголовка. Осознайте, что сжатые листы доступны только с апреля 2020 года, все листы до апреля 2020 года доступны только как не сжатые.

Верхний колонтитул Тип значения значение Описание
Accept-Encoding строка сдуть Необязательно. Если не указано, поток файлов не сжимается.

Пример запроса

GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='202101')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

Ответ REST

В случае успешного выполнения этот метод возвращает матрицу предложения в виде потока файлов. Поток файлов — это файл .csv или сжатый zip-файл .csv.

Коды успешных и ошибочных ответов

Каждый ответ сопровождается кодом состояния HTTP, обозначающим успешное или неудачное выполнение, и дополнительными сведениями для отладки. Используйте средство трассировки сети, чтобы просматривать этот код, тип ошибки и дополнительные параметры. См. полный список кодов ошибок.

Пример ответа

HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=updatedoffice.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT

"ProductTitle","ProductId","SkuId","SkuTitle","ProvisioningId","ProvisioningString","MinLicenses","MaxLicenses","AssetOwnershipLimit","AssetOwnershipLimitType","ProductSkuPreRequisites","ProductSkuConversion","Description","AllowedCountries" 
"Microsoft 365 Business Basic","CFQ7TTC0LH18","0001","Microsoft 365 Business Basic","3b555118-da6a-4418-894f-7df1e2096870","O365_BUSINESS_ESSENTIALS","1","300","2","ConcurrentCount","","CFQ7TTC0LDPB/0001,CFQ7TTC0LF8Q/0001","Best for businesses that need professional...","AD;AE;AF;AG;AI;AL;AM;AO..."
======= Truncated ==============