Microsoft Store 분석 API의 이 메서드를 사용하여 사용자가 Windows 데스크톱 애플리케이션 프로그램에 추가한 데스크톱 애플리케이션의 특정 오류와 관련된 CAB 파일을 다운로드합니다. 이 메서드는 지난 30일 동안 발생한 앱 오류에 대한 CAB 파일만 다운로드할 수 있습니다. CAB 파일 다운로드는 파트너 센터의 데스크톱 애플리케이션용 건강 보고서에서도 제공합니다.
이 메서드를 사용하려면 먼저 데스크톱 애플리케이션 메서드에서 오류에 대한 세부 정보를 가져오는
필수 조건
이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.
- 아직 완료하지 않은 경우 Microsoft Store 분석 API에 필요한 모든 필수 구성 요소를 완료하십시오.
- 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져오세요. 액세스 토큰을 받은 후 60분 이내에 사용해야 합니다. 그렇지 않으면 만료됩니다. 토큰이 만료되면 새 토큰을 가져올 수 있습니다.
- 다운로드하려는 CAB 파일의 ID 해시를 가져옵니다. 이 값을 가져오려면 데스크톱 애플리케이션 메서드의 오류에 대한 세부 정보 가져오기 를 사용하여 앱의 특정 오류에 대한 세부 정보를 검색하고 해당 메서드의 응답 본문에서 cabIdHash 값을 사용합니다.
요청
요청 구문
| 메서드 | URI 요청 |
|---|---|
| 가져오기 | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload |
요청 헤더
| 헤더 | 유형 | 설명 |
|---|---|---|
| 승인 | 문자열 | 필수 사항입니다. Azure AD 액세스 토큰은 Bearer<token> 형식입니다. |
요청 매개 변수
| 매개 변수 | 유형 | 설명 | 필수 |
|---|---|---|---|
| 애플리케이션 아이디 | 문자열 | CAB 파일을 다운로드하려는 데스크톱 애플리케이션의 제품 ID입니다. 데스크톱 애플리케이션의 제품 ID를 가져오려면 데스크톱 애플리케이션에 대한 파트너 센터 분석 보고서 (예: 상태 보고서)를 열고 URL에서 제품 ID를 검색합니다. | 예 |
| cabId해시 | 문자열 | 다운로드하려는 CAB 파일의 고유 ID 해시입니다. 이 값을 가져오려면 데스크톱 애플리케이션 메서드의 오류에 대한 세부 정보 가져오기 를 사용하여 애플리케이션의 특정 오류에 대한 세부 정보를 검색하고 해당 메서드의 응답 본문에 cabIdHash 값을 사용합니다. | 예 |
예제 요청
다음 예제에서는 이 메서드를 사용하여 CAB 파일을 다운로드하는 방법을 보여 줍니다. applicationId 및 cabIdHash 매개 변수를 데스크톱 애플리케이션에 적합한 값으로 바꿉다.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/cabdownload?applicationId=10238467886765136388&cabIdHash=00001111-aaaa-2222-bbbb-3333cccc4444 HTTP/1.1
Authorization: Bearer <your access token>
응답
이 메서드는 302(리디렉션) 응답 코드를 반환하고 응답의 Location 헤더는 CAB 파일의 SAS(공유 액세스 서명) URI에 할당됩니다. 호출자는 CAB 파일을 자동으로 다운로드하기 위해 이 URI로 리디렉션됩니다.