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

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

Для получения сведений о блоках устройства для конкретного исполняемого файла в десктопном приложении см. Сведения о блоке обновления для десктопного приложения.

Предпосылки

Чтобы использовать этот метод, сначала необходимо выполнить следующие действия:

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

Просьба

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

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

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

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

В следующем примере показано несколько запросов на получение данных блокировки настольных приложений. Замените значение 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>

Ответ

Основная часть ответа

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

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

В следующем примере показан пример текста ответа 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
}

Связанные темы

• настольное приложение Windows
• Получите сведения о блоке обновления для настольного приложения