다음을 통해 공유

데스크톱 애플리케이션에서 오류에 대한 세부 정보 가져오기

Microsoft Store 분석 API에서 이 메서드를 사용하여 앱의 특정 오류에 대한 자세한 데이터를 JSON 형식으로 가져옵니다. 이 메서드는 지난 30일 동안 발생한 오류에 대한 세부 정보만 검색할 수 있습니다. 자세한 오류 데이터는 파트너 센터의 데스크톱 애플리케이션에 대한 상태 보고서에서도 사용할 수 있습니다.

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

필수 조건

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

  • 아직 완료하지 않은 경우 Microsoft Store 분석 API에 필요한 모든 필수 구성 요소를 완료하십시오.
  • 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져오세요. 액세스 토큰을 받은 후 60분 이내에 사용해야 합니다. 그렇지 않으면 만료됩니다. 토큰이 만료되면 새 토큰을 가져올 수 있습니다.
  • 자세한 정보를 가져오려는 오류의 ID를 가져옵니다. 이 ID를 얻으려면 오류 보고 데이터를 가져오는 방법을 사용하고, 그 방법의 응답 본문에서 failureHash 값을 사용합니다.

요청

요청 구문

메서드 URI 요청
가져오기 https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails

요청 헤더

헤더 유형 설명
승인 문자열 필수 사항입니다. Azure AD 액세스 토큰은 Bearer<token> 형식입니다.

요청 매개 변수

매개 변수 유형 설명 필수
애플리케이션 아이디 문자열 오류 세부 정보를 검색하려는 데스크톱 애플리케이션의 제품 ID입니다. 데스크톱 애플리케이션의 제품 ID를 가져오려면 파트너 센터(예: 상태 보고서)에서 데스크톱 애플리케이션에 대한 분석 보고서를 열고 URL에서 제품 ID를 검색합니다. 예
실패 해시 문자열 자세한 정보를 가져오려는 오류의 고유 ID입니다. 관심 있는 오류에 대한 이 값을 얻으려면 오류 보고 데이터 메서드를 사용하고, 해당 메서드의 응답 본문에서 failureHash 값을 참조하십시오. 예
시작 날짜 날짜 검색할 자세한 오류 데이터의 날짜 범위의 시작 날짜입니다. 기본값은 현재 날짜 30일 전입니다.

참고: 이 메서드는 지난 30일 동안 발생한 오류에 대한 세부 정보만 검색할 수 있습니다.		 아니오
종료일 날짜 자세한 오류 데이터를 추출할 날짜 범위 중 종료 날짜입니다. 기본값은 현재 날짜입니다. 아니오
맨 위로 정수 (int) 요청에 반환할 데이터 행 수입니다. 지정하지 않으면 최대값과 기본값은 10000입니다. 쿼리에 행이 더 있는 경우 응답 본문에는 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 포함됩니다. 아니오
건너뛰기 정수 (int) 쿼리에서 건너뛸 행의 수를 지정합니다. 이 매개변수를 사용하여 대량의 데이터 집합을 탐색하십시오. 예를 들어 top=10 및 skip=0은 처음 10개의 데이터 행을 검색하고 top=10 및 skip=10은 다음 10개의 데이터 행을 검색합니다. 아니오
필터 문자열 응답의 행을 필터링하는 하나 이상의 구문이 있습니다. 각 명령문에는 응답 본문의 필드 이름 및 eq 또는 ne 연산자와 연결된 값이 포함되며, 명령문은 and 또는 or을 사용하여 결합될 수 있습니다. 문자열 값은 필터 매개 변수에서 작은따옴표로 묶어야 합니다. 응답 본문에서 다음 필드를 지정할 수 있습니다.

  • 시장
  • 날짜
  • cabId해시
  • cabExpirationTime
  • 장치 유형
  • 장치 모델
  • 운영체제버전
  • os릴리스
  • 애플리케이션 버전
  • 운영체제빌드
  • 파일명
 아니오
오더바이 (orderby) 문자열 결과 데이터 값을 정렬하는 문입니다. 구문은 orderby=field [order], field [order],.... 필드 매개 변수는 다음 문자열 중 하나일 수 있습니다.
  • 시장
  • 날짜
  • cabId해시
  • cabExpirationTime
  • 장치 유형
  • 장치 모델
  • 운영체제버전
  • os릴리스
  • 애플리케이션 버전
  • 운영체제빌드
  • 파일명

순서 매개변수는 선택 사항이며, 각 필드를 오름차순 또는 내림차순으로 지정하기 위해 asc 또는 desc가 될 수 있습니다. 기본값은 asc입니다.

다음은 orderby 문자열의 예시입니다. orderby=date,market

 아니오

예제 요청

다음 예제에서는 자세한 오류 데이터를 가져오기 위한 몇 가지 요청을 보여 줍니다. applicationId 값을 데스크톱 애플리케이션의 제품 ID로 바꿉니다.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&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/desktop/failuredetails?applicationId=10238467886765136388&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 'PC' HTTP/1.1
Authorization: Bearer <your access token>

응답

응답 메시지 본문

가치 유형 설명
가치 배열 자세한 오류 데이터를 포함하는 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 정보는 아래 오류 세부 값 섹션을 참조하세요.
@nextLink 문자열 추가 데이터 페이지가 있는 경우 이 문자열에는 다음 데이터 페이지를 요청하는 데 사용할 수 있는 URI가 포함됩니다. 예를 들어 요청의 최상위 매개 변수가 10으로 설정되어 있지만 쿼리에 대해 10개 이상의 오류 행이 있는 경우 이 값이 반환됩니다.
총개수 정수 쿼리의 데이터 결과에 포함된 행의 총 개수입니다.

오류 세부 정보 값

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

가치 유형 설명
애플리케이션 아이디 문자열 오류 세부 정보를 검색한 데스크톱 애플리케이션의 제품 ID입니다.
실패 해시 문자열 오류의 고유 식별자입니다.
오류 이름 문자열 하나 이상의 문제 클래스, 예외/버그 검사 코드, 오류가 발생한 이미지의 이름 및 연결된 함수 이름 등 네 부분으로 구성된 오류의 이름입니다.
날짜 문자열 오류 데이터에 대한 날짜 범위의 첫 번째 날짜입니다. 요청이 1일을 지정한 경우 이 값은 해당 날짜입니다. 요청이 주, 월 또는 기타 날짜 범위를 지정한 경우 이 값은 해당 날짜 범위의 첫 번째 날짜입니다.
cabId해시 문자열 이 오류와 연결된 CAB 파일의 고유 ID 해시입니다.
택시 만료 시간 문자열 CAB 파일이 만료되어 더 이상 다운로드할 수 없는 날짜 및 시간(ISO 8601 형식)입니다.
시장 문자열 디바이스 시장의 ISO 3166 국가 코드입니다.
운영체제빌드 문자열 오류가 발생한 OS의 빌드 번호입니다.
어플리케이션 버전 문자열 오류가 발생한 애플리케이션 실행 파일의 버전입니다.
기기 모델 문자열 오류가 발생했을 때 앱이 실행되고 있는 디바이스의 모델을 지정하는 문자열입니다.
운영체제 버전 문자열 데스크톱 애플리케이션이 설치된 OS 버전을 지정하는 다음 문자열 중 하나입니다.

  • Windows 7
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2016
  • 윈도우 서버 1709
  • 알 수 없음
os릴리스 문자열 오류가 발생한 운영 체제 버전의 특정 릴리스나 플라이팅 링(운영 체제 버전 내의 하위 집단)을 지정하는 다음 문자열 중 하나입니다.

Windows 11의 경우: 버전 2110

Windows 10의 경우:

  • 1507 버전
  • 1511 버전
  • 1607 버전
  • 1703 버전
  • 1709 버전
  • 1803 버전
  • 릴리스 미리 보기
  • 인사이더 패스트
  • 인사이더 슬로우

Windows Server 1709의 경우:

  • RTM (RTM)

Windows Server 2016의 경우:

  • 1607 버전

Windows 8.1의 경우:

  • 업데이트 1

Windows 7의 경우:

  • 서비스 팩 1

OS 릴리스 또는 플라이팅 링이 알려지지 않은 경우, 이 필드는 알 수 없음값을 가집니다.
디바이스 유형 문자열 오류가 발생한 디바이스의 유형을 나타내는 다음 문자열 중 하나입니다.

  • 개인용 컴퓨터
  • 서버
  • 알 수 없음
cab다운로드 가능 불리언 (Boolean) 이 사용자에 대해 CAB 파일을 다운로드할 수 있는지 여부를 나타냅니다.
파일이름 문자열 오류 세부 정보를 검색한 데스크톱 애플리케이션의 실행 파일 이름입니다.

응답 예제

다음 예제에서는 이 요청에 대한 JSON 응답 본문의 예를 보여줍니다.

{
  "Value": [
    {
      "applicationId": "10238467886765136388",
      "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
      "failureName": "NULL_CLASS_PTR_WRITE_c0000005_contoso.exe!unknown_error_in_process",
      "date": "2018-01-28 23:55:29",
      "cabIdHash": "54ffb83a-e159-41d2-8158-f36f306cc01e",
      "cabExpirationTime": "2018-02-27 23:55:29",
      "market": "US",
      "osBuild": "10.0.10240",
      "applicationVersion": "2.2.2.0",
      "deviceModel": "Contoso All-in-one",
      "osVersion": "Windows 10",
      "osRelease": "Version 1703",
      "deviceType": "PC",
      "cabDownloadable": false,
      "fileName": "contosodemo.exe"
    }
  ],
  "@nextLink": null,
  "TotalCount": 1
}
  • Last updated on