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


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

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