데스크톱 애플리케이션에 대한 업그레이드 블록 가져오기

이 REST URI를 사용하여 데스크톱 응용 프로그램이 Windows 10 또는 Windows 11 업그레이드 실행을 차단하는 Windows 10 및 Windows 11 디바이스에 대한 정보를 가져옵니다. 이 URI는 귀하가 Windows 데스크톱 애플리케이션 프로그램에 추가한 데스크톱 애플리케이션에만 사용할 수 있습니다. 이 정보는 파트너 센터의 데스크톱 애플리케이션에 대한 애플리케이션 블록 보고서에서도 확인할 수 있습니다.

데스크톱 애플리케이션에서 특정 실행 파일의 디바이스 블록에 대한 세부 정보를 보려면 데스크톱 애플리케이션 에 대한 업그레이드 블록 세부 정보 가져오기를 참조하세요.

필수 조건

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

• 아직 완료하지 않은 경우 Microsoft Store 분석 API에 필요한 모든 필수 구성 요소를 완료하십시오.
• 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져오세요. 액세스 토큰을 받은 후 60분 이내에 사용해야 합니다. 그렇지 않으면 만료됩니다. 토큰이 만료되면 새 토큰을 가져올 수 있습니다.

요청

요청 구문

요청 헤더

요청 매개 변수

예제 요청

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

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 데스크톱 애플리케이션 프로그램
• 데스크톱 애플리케이션에 대한 업그레이드 블록 세부 정보 가져오기