앱에서 오류에 대한 세부 정보 가져오기

아티클
03/13/2024

Microsoft Store 분석 API에서 이 메서드를 사용하여 앱의 특정 오류에 대한 자세한 데이터를 JSON 형식으로 가져올 수 있습니다. 이 메서드는 지난 30일 동안 발생한 오류의 세부 정보만 검색할 수 있습니다. 또한 파트너 센터에서 Health 보고서의 오류 섹션을 통해 상세 오류 데이터를 확인할 수 있습니다.

이 메서드를 사용하려면 먼저 오류 보고 데이터 가져오기 메서드를 사용하여 자세한 정보를 가져오려는 오류의 ID를 검색해야 합니다.

필수 조건

이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.

아직 완료하지 않은 경우 Microsoft Store 분석 API에 대한 모든 필수 조건을 완료합니다.
이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져옵니다. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.
자세한 정보를 가져오려는 오류의 ID를 가져옵니다. 이 ID를 가져오려면 오류 보고 데이터 가져오기 메서드를 사용하고 해당 메서드의 응답 본문에서 failureHash 값을 사용합니다.

요청

요청 구문

메서드	요청 URI
GET	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails`

요청 헤더

헤더	형식	설명
권한 부여	문자열	필수. Bearer<토큰> 형식의 Azure AD 액세스 토큰입니다.

요청 매개 변수

매개 변수	형식	설명	필수
applicationId	문자열	자세한 오류 데이터를 검색할 앱의 Store ID입니다. Store ID는 파트너 센터의 앱 ID 페이지에서 사용할 수 있습니다. 예를 들어 Store ID는 9WZDNCRFJ3Q8입니다.	예
failureHash	문자열	자세한 정보를 가져오려는 오류의 고유 ID를 가져옵니다. 관심 있는 오류에 대한 해당 값을 가져오려면 오류 보고 데이터 가져오기 메서드를 사용하고 해당 메서드의 응답 본문에서 failureHash 값을 사용합니다.	예
startDate	날짜	검색할 자세한 오류 데이터 날짜 범위의 시작 날짜입니다. 기본값은 현재 날짜에서 30일 전입니다. 참고: 이 메서드는 지난 30일 동안 발생한 오류에 대한 세부 정보만 검색할 수 있습니다.	아니요
endDate	날짜	검색할 자세한 오류 데이터 날짜 범위의 종료 날짜입니다. 기본값은 현재 날짜입니다.	아니요
top	int	요청에서 반환할 데이터 행의 수. 지정되지 않은 경우 최댓값 및 기본값은 10000입니다. 쿼리에 행이 더 있는 경우, 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 응답 본문에 포함됩니다.	아니요
skip	int	쿼리에서 건너뛸 행 수. 이 매개 변수를 사용하여 큰 데이터 집합을 페이징합니다. 예를 들어 top=10 및 skip=0은 데이터의 첫 10행을 검색하고 top=10 및 skip=10은 데이터의 그 다음 10행을 검색하는 식으로 이어집니다.	아니요
필터	문자열	응답의 행을 필터링하는 하나 이상의 문. 각 명령문에는 응답 본문의 필드 이름 및 eq 또는 ne 연산자와 연결된 값이 포함되며, 명령문은 and 또는 or을 사용하여 결합할 수 있습니다. 문자열 값은 필터 매개 변수에서 단일 따옴표로 묶여야 합니다. 응답 본문에서 지정할 수 있는 필드는 다음과 같습니다. market date cabId cabExpirationTime deviceType deviceModel osVersion osRelease packageVersion osBuild	아니요
orderby	문자열	결과 데이터 값을 정렬하는 문. 구문은 orderby=field [order],field [order],...입니다. 필드 매개 변수는 다음 문자열 중 하나일 수 있습니다. market date cabId cabExpirationTime deviceType deviceModel osVersion osRelease packageVersion osBuild order 매개 변수는 옵션이며 각 필드를 asc 또는 desc로 오름차순 또는 내림차순으로 지정할 수 있습니다. 기본값은 asc입니다. 다음은 orderby 문자열의 예시입니다. orderby=date,market	아니요

요청 예제

다음 예제는 자세한 오류 데이터를 가져오기 위한 몇 가지 요청을 보여 줍니다. applicationId 값을 앱의 Store ID로 바꿉니다.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=012e33e3-dbc9-b12f-c124-9d9810f05d8b&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=012e33e3-dbc9-b12f-c124-9d9810f05d8b&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가 이 문자열에 포함됩니다. 예를 들어 요청의 top 매개 변수가 10으로 설정되어 있지만 쿼리에 대한 오류 행이 10개보다 많은 경우 이 값이 반환됩니다.
TotalCount	정수	쿼리에 대한 데이터 결과의 총 행 수.

오류 세부 정보 값

값 배열의 요소에는 다음의 값이 포함됩니다.

값	형식	설명
applicationId	문자열	자세한 오류 데이터를 검색한 앱의 Store ID입니다.
failureHash	문자열	오류에 대한 고유 식별자입니다.
failureName	문자열	오류 이름은 하나 이상의 문제 클래스, 예외/버그 확인 코드, 오류가 발생한 이미지의 이름 및 관련된 기능 이름의 네 부분으로 구성됩니다.
날짜	문자열	오류 데이터에 대한 날짜 범위의 시작 날짜입니다. 요청에서 하루를 지정한 경우 이 값은 해당 날짜입니다. 요청에서 주, 월 또는 다른 날짜 범위를 지정한 경우 이 값은 해당 날짜 범위의 첫 번째 날짜입니다.
cabId	문자열	이 에러와 연결된 CAB 파일의 고유 ID입니다.
cabExpirationTime	문자열	CAB 파일이 만료되어 더 이상 다운로드할 수 없는 날짜 및 시간(ISO 8601 형식)입니다.
market	문자열	디바이스 시장의 ISO 3166 국가 코드입니다.
osBuild	문자열	오류가 발생한 OS의 빌드 번호입니다.
packageVersion	문자열	이 오류와 연결된 앱 패키지의 버전입니다.
deviceModel	문자열	오류가 발생했을 때 앱이 실행되고 있는 디바이스의 모델을 지정하는 문자열입니다.
osVersion	문자열	오류가 발생한 OS 버전을 나타내는 다음 문자열 중 하나입니다. Windows Phone 7.5 Windows Phone 8 Windows Phone 8.1 Windows Phone 10 Windows 8 Windows 8.1 Windows 10 Windows 11 알 수 없음
osRelease	문자열	오류가 발생한 OS 릴리스 또는 플라이팅 링(OS 버전 내 하위 집단)을 나타내는 다음 문자열 중 하나입니다. Windows 11의 경우: 버전 2110 Windows 10의 경우: 버전 1507 버전 1511 버전 1607 버전 1703 버전 1709 버전 1803 릴리스 미리 보기 초기 참가자 이후 참가자 Windows Server 1709의 경우: RTM Windows Server 2016의 경우: 버전 1607 Windows 8.1의 경우: 업데이트 1 Windows 7의 경우: 서비스 팩 1 OS 릴리스 또는 플라이팅 링을 알 수 없는 경우 이 필드의 값은 알 수 없음입니다.
deviceType	문자열	오류가 발생했을 때 앱이 실행 중이던 장치의 유형을 지정하는 다음 문자열 중 하나입니다. PC 전화 콘솔-Xbox One 콘솔-Xbox 시리즈 X IoT Holographic 알 수 없음
cabDownloadable	Boolean	이 사용자에 대해 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
}

앱에서 오류에 대한 세부 정보 가져오기

필수 조건

요청

요청 구문

요청 헤더

요청 매개 변수

요청 예제

응답

응답 본문

오류 세부 정보 값

요청 및 응답 예제

샘플 요청

샘플 응답

피드백

피드백

추가 리소스

앱에서 오류에 대한 세부 정보 가져오기

필수 조건

요청

요청 구문

요청 헤더

요청 매개 변수

요청 예제

응답

응답 본문

오류 세부 정보 값

요청 및 응답 예제

샘플 요청

샘플 응답

관련 항목

피드백

피드백

추가 리소스