Получение сведений о блоках обновлений для классического приложения

Используйте этот URI REST для получения сведений о windows 10 и Windows 11 устройствах, на которых определенный исполняемый файл в классическом приложении блокирует запуск windows 10 или Windows 11 обновления. Этот URI можно использовать только для классических приложений, добавленных в программу классических приложений Windows. Эти сведения также доступны в отчете Блоки приложений для классических приложений в Центре партнеров.

Этот универсальный код ресурса (URI) похож на получение блоков обновления для классического приложения, но он возвращает сведения о блоке устройства для определенного исполняемого файла в классическом приложении.

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

Для использования этого метода сначала необходимо сделать следующее:

  • Если вы еще не сделали этого, выполните все необходимые условия для API аналитики для Microsoft Store.
  • Получите маркер доступа Azure AD, который будет использоваться в заголовке запроса этого метода. После получения маркера доступа у вас будет 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия маркера можно получить новый маркер.

Запрос

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

Метод Универсальный код ресурса (URI) запроса
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockdetails

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

Заголовок Тип Описание
Авторизация строка Обязательный. Маркер доступа Azure AD в видемаркера>носителя<.

Параметры запроса

Параметр Тип Описание Обязательно
applicationId строка Идентификатор продукта классического приложения, для которого требуется получить данные блока. Чтобы получить идентификатор продукта классического приложения, откройте любой аналитический отчет для классического приложения в Центре партнеров (например, отчет о блоках) и получите идентификатор продукта по URL-адресу. Да
fileName строка Имя заблокированного исполняемого файла
startDate Дата Начальная дата в диапазоне дат извлекаемых данных блока. Значение по умолчанию — 90 дней до текущей даты. Нет
endDate Дата Конечная дата в диапазоне дат извлекаемых данных блока. По умолчанию используется текущая дата. нет
top INT Количество строк данных, возвращаемых в запросе. Максимальное значение и значение по умолчанию (если параметр не указан) — 10 000. Если в запросе содержится больше строк, то тело ответа будет содержать ссылку «Далее», которую можно использовать для запроса следующей страницы данных Нет
skip INT Количество строк, пропускаемых в запросе. Используйте этот параметр для постраничного перемещения по большим наборам данных. Например, при top=10000 и skip=0 извлекаются первые 10 000 строк данных; при top=10000 и skip=10000 извлекаются следующие 10 000 строк данных и т. д. Нет
фильтр строка Одно или несколько выражений для фильтрации строк в ответе. Каждое выражение содержит имя поля из тела ответа и значение, которое связано с помощью операторов eq или ne; выражения можно комбинировать, используя операторы and или or. В параметре filter строковые значения должны быть заключены в одиночные кавычки. Вы можете указать следующие поля из тела ответа:

  • applicationVersion
  • architecture
  • blockType
  • deviceType
  • Рынке
  • osRelease
  • osVersion
  • Productname
  • targetOs
Нет
orderby строка Оператор, который упорядочивает значения результирующих данных для каждого блока. Используется следующий синтаксис: orderby=field [order],field [order],..., где параметр field может принимать одно из следующих значений полей из тела ответа:

  • applicationVersion
  • architecture
  • blockType
  • date
  • deviceType
  • Рынке
  • osRelease
  • osVersion
  • Productname
  • targetOs
  • deviceCount

Параметр order является необязательным и может принимать значения asc или desc, которые указывают, соответственно, порядок сортировки по возрастанию или по убыванию для каждого поля. Значение по умолчанию — asc.

Ниже приведен пример строки orderby : orderby=date,market

Нет
groupby строка Выражение, которое применяет агрегирование данных только к указанным полям. Вы можете указать следующие поля из тела ответа:

  • applicationVersion
  • architecture
  • blockType
  • deviceType
  • Рынке
  • osRelease
  • osVersion
  • targetOs

Возвращенные строки данных будут содержать поля, указанные в параметре groupby, а также:

  • applicationId
  • date
  • Productname
  • deviceCount

Нет

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

В следующем примере показано несколько запросов на получение данных блока классического приложения. Замените значение applicationId идентификатором продукта для классического приложения.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockdetails?applicationId=10238467886765136388&fileName=contoso.exe&startDate=2018-05-01&endDate=2018-06-07&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockdetails?applicationId=10238467886765136388&fileName=contoso.exe&startDate=2018-05-01&endDate=2018-06-07&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

Ответ

Текст ответа

Значение Тип Описание
Значение array Массив объектов , содержащих статистические данные блоков. Дополнительные сведения о данных в каждом объекте см. в следующей таблице.
@nextLink строка При наличии дополнительных страниц данных эта строка содержит универсальный код ресурса (URI), который можно использовать для запроса следующей страницы данных. Например, это значение возвращается, если для параметра top запроса задано значение 10 000, но для запроса содержится более 10 000 строк блочных данных.
TotalCount INT Общее количество строк в результирующих данных для запроса.

Элементы в массиве Value содержат следующие значения.

Значение Тип Описание
applicationId строка Идентификатор продукта классического приложения, для которого получены данные блока.
Дата строка Дата, связанная со значением попадания блока.
productName строка Отображаемое имя классического приложения, как оно получено из метаданных его связанных исполняемых файлов.
fileName строка Заблокированный исполняемый файл.
applicationVersion строка Версия заблокированного исполняемого файла приложения.
osVersion строка Одна из следующих строк, указывающая версию ОС, в которой в настоящее время выполняется классическое приложение:

  • Windows 7
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2016
  • Windows Server 1709
  • Unknown
osRelease строка Одна из следующих строк, задающая выпуск ОС или круг тестирования (в виде подпопуления в версии ОС), на котором в настоящее время выполняется классическое приложение.

Для Windows 11: версия 2110

Для Windows 10.

  • Версия 1507
  • Версия 1511
  • Версия 1607
  • Версия 1703
  • Версия 1709
  • Release Preview
  • Предварительная оценка — ранний доступ
  • Предварительная оценка Windows — поздний доступ

Для Windows Server 1709

  • RTM

Для Windows Server 2016

  • Версия 1607

Для Windows 8.1.

  • Обновление 1

Для Windows 7.

  • Пакет обновления 1 (SP1)

Если выпуск операционной системы или цикл фокус-тестирования неизвестны, это поле имеет значение Unknown.

market строка Код страны iso 3166 для рынка, на котором заблокировано классическое приложение.
deviceType строка Одна из следующих строк, указывающих тип устройства, на котором заблокировано классическое приложение:

  • PC
  • Сервер
  • Планшет
  • Unknown
blockType строка Одна из следующих строк, задающая тип блока, найденного на устройстве:

  • Потенциальные отложения
  • Временные отложения
  • Уведомление среды выполнения

Дополнительные сведения об этих типах блоков и их значении для разработчиков и пользователей см. в описании отчета о блоках приложений.
архитектура строка Архитектура устройства, на котором существует блок:

  • ARM64
  • X86
TargetOs строка Одна из следующих строк, указывающих выпуск ОС Windows 10 или Windows 11, в котором классическое приложение заблокировано:

  • Версия 1709
  • Версия 1803
deviceCount number Количество отдельных устройств с блоками на указанном уровне агрегирования.

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

В следующем примере демонстрируется пример тела ответа JSON на данный запрос.

{
  "Value": [
    {
     "applicationId": "10238467886765136388",
     "date": "2018-06-03",
     "productName": "Contoso Demo",
     "fileName": "contosodemo.exe",
     "applicationVersion": "2.2.2.0",
     "osVersion": "Windows 8.1",
     "osRelease": "Update 1",
     "market": "ZA",
     "deviceType": "All",
     "blockType": "Runtime Notification",
     "architecture": "X86",
     "targetOs": "RS4",
     "deviceCount": 120
    }
  ],
  "@nextLink": "desktop/blockdetails?applicationId=123456789&startDate=2018-01-01&endDate=2018-02-01&top=10000&skip=10000&groupby=applicationVersion,deviceType,osVersion,osRelease",
  "TotalCount": 23012
}