Получение блоков обновлений для классического приложения
Используйте этот URI REST для получения сведений об устройствах с Windows 10 и Windows 11, на которых классическое приложение блокирует запуск Windows 10 или Windows 11 обновление. Этот URI можно использовать только для классических приложений, добавленных в программу классических приложений Windows. Эти сведения также доступны в отчете Блоки приложений для классических приложений в Центре партнеров.
Сведения о блоках устройств для определенного исполняемого файла в классическом приложении см. в статье Получение сведений о блоке обновления для классического приложения.
Предварительные требования
Для использования этого метода сначала необходимо сделать следующее:
- Если вы еще не сделали этого, выполните все необходимые условия для API аналитики для Microsoft Store.
- Получите маркер доступа Azure AD, который будет использоваться в заголовке запроса этого метода. После получения маркера доступа у вас будет 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия маркера можно получить новый маркер.
Запрос
Синтаксис запроса
Метод | Универсальный код ресурса (URI) запроса |
---|---|
GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits |
Заголовок запроса
Заголовок | Тип | Описание |
---|---|---|
Авторизация | строка | Обязательный. Маркер доступа Azure AD в видемаркера>носителя<. |
Параметры запроса
Параметр | Тип | Описание | Обязательно |
---|---|---|---|
applicationId | строка | Идентификатор продукта классического приложения, для которого требуется получить блочные данные. Чтобы получить идентификатор продукта классического приложения, откройте любой аналитический отчет для классического приложения в Центре партнеров (например , отчет о блоках) и получите идентификатор продукта по URL-адресу. | Да |
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 строковые значения должны быть заключены в одиночные кавычки. Вы можете указать следующие поля из тела ответа:
|
Нет |
orderby | строка | Инструкция, которая упорядочивает значения результирующих данных для каждого блока. Используется следующий синтаксис: orderby=field [order],field [order],..., где параметр field может принимать одно из следующих значений полей из тела ответа:
Параметр order является необязательным и может принимать значения asc или desc, которые указывают, соответственно, порядок сортировки по возрастанию или по убыванию для каждого поля. Значение по умолчанию — asc. Ниже приведен пример строки orderby : orderby=date,market |
Нет |
groupby | строка | Выражение, которое применяет агрегирование данных только к указанным полям. Вы можете указать следующие поля из тела ответа:
Возвращенные строки данных будут содержать поля, указанные в параметре groupby, а также:
|
Нет |
Пример запроса
В следующем примере показано несколько запросов на получение данных блока классического приложения. Замените значение applicationId идентификатором продукта для классического приложения.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits?applicationId=5126873772241846776&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/blockhits?applicationId=5126873772241846776&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 | строка | Одна из следующих строк, указывающая версию ОС, в которой в настоящее время выполняется классическое приложение:
|
osRelease | строка | Одна из следующих строк, задающая выпуск ОС или круг тестирования (в виде подпопуления в версии ОС), на котором в настоящее время выполняется классическое приложение. Для Windows 11: версия 2110 Для Windows 10.
Для Windows Server 1709
Для Windows Server 2016
Для Windows 8.1.
Для Windows 7.
Если выпуск операционной системы или цикл фокус-тестирования неизвестны, это поле имеет значение Unknown. |
market | строка | Код страны iso 3166 для рынка, на котором заблокировано классическое приложение. |
deviceType | строка | Одна из следующих строк, указывающих тип устройства, на котором заблокировано классическое приложение:
|
blockType | строка | Одна из следующих строк, задающая тип блока, найденного на устройстве:
|
архитектура | строка | Архитектура устройства, на котором существует блок:
|
targetOs | строка | Одна из следующих строк, указывающих выпуск Ос Windows 10 или Windows 11, в котором классическое приложение заблокировано.
|
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/blockhits?applicationId=123456789&startDate=2018-01-01&endDate=2018-02-01&top=10000&skip=10000&groupby=applicationVersion,deviceType,osVersion,osRelease",
"TotalCount": 23012
}
Связанные темы
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по