Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте этот метод в API аналитики Microsoft Store, чтобы получить подробные данные для конкретной ошибки приложения в формате JSON. Этот метод может получить сведения только об ошибках, произошедших за последние 30 дней. Подробные данные об ошибках также доступны в разделе сбоев отчета о работоспособности в Центре Партнеров.
Прежде чем использовать этот метод, необходимо сначала использовать метод получения данных отчетности об ошибках для получения идентификатора ошибки, для которой требуется получить подробные сведения.
Предпосылки
Чтобы использовать этот метод, сначала необходимо выполнить следующие действия:
- Если это еще не сделано, выполните все предварительные требования для API аналитики Microsoft Store.
- Получите маркер доступа Azure AD для использования в заголовке запроса для этого метода. После получения маркера доступа у вас есть 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия токена можно получить новый токен.
- Получите идентификатор ошибки, для которой требуется получить подробные сведения. Чтобы получить этот идентификатор, используйте метод получения данных отчетов об ошибках и используйте значение failureHash в тексте ответа этого метода.
Просьба
Синтаксис запроса
| Метод | Запрос URI |
|---|---|
| ПОЛУЧАЙ | https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails |
Заголовок запроса
| Заголовок | Тип | Описание |
|---|---|---|
| Авторизация | струна | Обязательное. Токен доступа Azure AD в формате Bearer<token>. |
Параметры запроса
| Параметр | Тип | Описание | Обязательно |
|---|---|---|---|
| applicationId | струна | Идентификатор магазина приложения, для которого требуется получить подробные данные об ошибках. Идентификатор магазина доступен на странице идентификации приложения в Центре партнеров. Пример идентификатора магазина — 9WZDNCRFJ3Q8. | Да |
| хеш-сбоя | струна | Уникальный идентификатор ошибки, для которой требуется получить подробные сведения. Чтобы получить это значение для интересующей вас ошибки, используйте метод получения данных отчетов об ошибках и используйте значение failureHash в тексте ответа этого метода. | Да |
| Дата начала | дата | Дата начала в диапазоне дат получения подробных данных об ошибках. Значение по умолчанию — 30 дней до текущей даты. Примечание. Этот метод может получить сведения только об ошибках, возникших за последние 30 дней. | нет |
| Дата окончания | дата | Дата окончания в диапазоне дат для получения подробных данных об ошибках. Значение по умолчанию — текущая дата. | нет |
| Верх | инт | Количество строк данных, возвращаемых в запросе. Максимальное значение и значение по умолчанию, если не указано значение 10000. Если в запросе есть больше строк, текст ответа содержит следующую ссылку, которую можно использовать для запроса следующей страницы данных. | нет |
| пропустить | инт | Количество строк, пропускаемых в запросе. Используйте этот параметр для навигации по большим наборам данных. Например, top=10 и skip=0 извлекает первые 10 строк данных, top=10 и skip=10 извлекает следующие 10 строк данных и т. д. | нет |
| фильтр | струна | Одна или несколько инструкций, которые фильтруют строки в ответе. Каждое выражение содержит имя поля из текста ответа и значение, связанное с операторами eq или ne, и выражения могут быть объединены с помощью и или или. Строковые значения должны быть окружены одними кавычками в параметре фильтра . В тексте ответа можно указать следующие поля:
|
нет |
| сортировать по | струна | Инструкция, которая упорядочивает значения результирующих данных. Синтаксис — orderby=field [order], field [order],.... Параметр field может быть одной из следующих строк:
Параметр order является необязательным и может принимать значения asc или desc, чтобы указать порядок по возрастанию или по убыванию для каждого поля. Значение по умолчанию — asc. Ниже приведен пример строки orderby: orderby=date,market |
нет |
Пример запроса
В следующих примерах показано несколько запросов на получение подробных данных об ошибках. Замените значение applicationId идентификатором Магазина для приложения.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=00001111-aaaa-2222-bbbb-3333cccc4444&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=00001111-aaaa-2222-bbbb-3333cccc4444&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0&filter=market eq 'US' and deviceType eq 'Windows.Desktop' HTTP/1.1
Authorization: Bearer <your access token>
Ответ
Основная часть ответа
| Ценность | Тип | Описание |
|---|---|---|
| Ценность | массив | Массив объектов, содержащих подробные данные об ошибках. Дополнительные сведения о данных в каждом объекте см. в разделе ниже «Подробные значения ошибок». |
| @nextLink | струна | Если есть дополнительные страницы данных, эта строка содержит универсальный код ресурса (URI), который можно использовать для запроса следующей страницы данных. Например, это значение возвращается, если верхний параметр запроса имеет значение 10, но для запроса имеется более 10 строк ошибок. |
| Общее количество | целое число | Общее количество строк в результатах данных для запроса. |
Значения подробностей об ошибках
Элементы в массиве значений содержат следующие значения.
| Ценность | Тип | Описание |
|---|---|---|
| applicationId | струна | Идентификатор магазина приложения, для которого вы получили подробные данные об ошибках. |
| хеш-сбоя | струна | Уникальный идентификатор ошибки. |
| название ошибки | струна | Имя сбоя, состоящее из четырех частей: один или несколько классов проблем, код проверки исключений и ошибок, имя изображения, в котором произошел сбой, и связанное имя функции. |
| дата | струна | Первая дата в диапазоне дат для данных об ошибках. Если запрос указал один день, это значение равно дате. Если запрос указал неделю, месяц или другой диапазон дат, это значение является первой датой в этом диапазоне дат. |
| cabId | струна | Уникальный идентификатор CAB-файла, связанного с этой ошибкой. |
| время истечения действия cab | струна | Дата и время, когда срок действия CAB-файла истечёт, и его больше невозможно будет загрузить, в формате ISO 8601. |
| рынок | струна | Код страны рынка девайсов по стандарту ISO 3166. |
| osBuild | струна | Номер сборки ОС, в которой произошла ошибка. |
| версия_пакета | струна | Версия пакета приложения, связанного с этой ошибкой. |
| модель устройства | струна | Строка, указывающая модель устройства, на котором выполнялось приложение при возникновении ошибки. |
| Версия ОС | струна | Одна из следующих строк, указывающих версию ОС, в которой произошла ошибка:
|
| osRelease | струна | Одна из следующих строк, указывающая релиз или кольцо тестирования (как подпопуляция в пределах версии ОС), в котором произошла ошибка. Для Windows 11 : версия 2110 Для Windows 10:
Для Windows Server 1709:
Для Windows Server 2016:
Для Windows 8.1:
Для Windows 7:
Если выпуск ОС или флайтинговое кольцо неизвестны, это поле имеет значение Unknown. |
| тип устройства | струна | Одна из следующих строк, указывающая тип устройства, на котором запущено приложение при возникновении ошибки:
|
| cabDownloadable | логический (Булев) | Указывает, можно ли скачать CAB-файл для этого пользователя. |
Замечание
Этот метод может получить сведения только об ошибках, произошедших за последние 30 дней.
Пример запроса и ответа
В следующих фрагментах кода показан пример текста запроса и текста ответа JSON для этого запроса.
Пример запроса
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=012345-5dbc9-b12f-c124-9d9810f05d8b&startDate=2022-06-30&endDate=2022-07-28&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>
Пример ответа
{
"Value": [
{
"date": "2022-07-12 00:00:00",
"cabExpirationTime": "2022-08-16 01:37:00",
"cabDownloadable": false,
"applicationId": "9NBLGGGZ5QDR",
"failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
"failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
"cabId": "1180087848576586304",
"market": "MX",
"osBuild": "10.0.19043",
"packageVersion": "2.5.2.34894",
"deviceModel": "Dell Inc.-Inspiron 15-3567",
"osVersion": "Windows 10",
"osRelease": "Version 21H1",
"osArchitecture": "x64",
"deviceType": "PC",
"cpuManufacturer": "Intel",
"cpuFamilyName": "Core i5",
"cpuName": "Intel Core i5-7200U CPU @ 2.50GHz",
"praid": "app",
"flightRing": "",
"sandboxId": "retail"
},
{
"date": "2022-07-13 00:00:00",
"cabExpirationTime": "2022-08-17 13:35:53",
"cabDownloadable": true,
"applicationId": "9NBLGGGZ5QDR",
"failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
"failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
"cabId": "2058585545558157474",
"market": "RO",
"osBuild": "10.0.22622",
"packageVersion": "2.5.2.34894",
"deviceModel": "Dell Inc.-Vostro 5502",
"osVersion": "Windows 11",
"osRelease": "External",
"osArchitecture": "x64",
"deviceType": "PC",
"cpuManufacturer": "Intel",
"cpuFamilyName": "Core i5",
"cpuName": "11th Gen Intel Core i5-1135G7 @ 2.40GHz",
"praid": "app",
"flightRing": "external",
"sandboxId": "retail"
},
{
"date": "2022-07-14 00:00:00",
"cabExpirationTime": "2022-08-18 07:27:06",
"cabDownloadable": false,
"applicationId": "9NBLGGGZ5QDR",
"failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
"failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
"cabId": "1940204079766793391",
"market": "IN",
"osBuild": "10.0.19044",
"packageVersion": "2.5.2.34894",
"deviceModel": "Generic Desktop",
"osVersion": "Windows 10",
"osRelease": "Version 21H2",
"osArchitecture": "x64",
"deviceType": "PC",
"cpuManufacturer": "Intel",
"cpuFamilyName": "Pentium",
"cpuName": "Intel Pentium CPU G630 @ 2.70GHz",
"praid": "app",
"flightRing": "",
"sandboxId": "retail"
},
{
"date": "2022-07-17 00:00:00",
"cabExpirationTime": "2022-08-21 10:04:16",
"cabDownloadable": true,
"applicationId": "9NBLGGGZ5QDR",
"failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
"failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
"cabId": "1197051093472061859",
"market": "ES",
"osBuild": "10.0.22621",
"packageVersion": "2.5.2.34894",
"deviceModel": "Microsoft Corporation-Surface Pro 3",
"osVersion": "Windows 11",
"osRelease": "External",
"osArchitecture": "x64",
"deviceType": "PC",
"cpuManufacturer": "Intel",
"cpuFamilyName": "Core i7",
"cpuName": "Intel Core i7-4650U CPU @ 1.70GHz",
"praid": "app",
"flightRing": "external",
"sandboxId": "retail"
},
{
"date": "2022-07-20 00:00:00",
"cabExpirationTime": "2022-08-24 12:40:05",
"cabDownloadable": false,
"applicationId": "9NBLGGGZ5QDR",
"failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
"failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
"cabId": "1332886311327579782",
"market": "RU",
"osBuild": "6.3.9600",
"packageVersion": "2.5.2.34894",
"deviceModel": "ASUSTeK COMPUTER INC.-K75VJ",
"osVersion": "Windows 8.1",
"osRelease": "RTM",
"osArchitecture": "x64",
"deviceType": "PC",
"cpuManufacturer": "Intel",
"cpuFamilyName": "Core i7",
"cpuName": "Intel Core i7-3630QM CPU @ 2.40GHz",
"praid": "app",
"flightRing": "",
"sandboxId": ""
}
],
"TotalCount": 5
}