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

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

  • Статья

В этой статье объясняется, как получить матрицу предложения за указанный месяц. Матрица предложения содержит свойства и правила покупки для продуктов и номеров 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

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

Имя. Type Обязательно Описание
месяц строка Нет Должен соответствовать 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 ==============

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