데스크톱 애플리케이션에 대한 업그레이드 차단 세부 정보 가져오기

아티클
03/13/2024

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

이 URI는 데스크톱 애플리케이션의 업그레이드 블록 가져오기와 유사하지만 데스크톱 애플리케이션의 특정 실행 파일에 대한 디바이스 블록 정보를 반환합니다.

필수 조건

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

아직 완료하지 않은 경우 Microsoft Store 분석 API에 대한 모든 필수 조건을 완료합니다.
이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져옵니다. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.

요청

요청 구문

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

요청 헤더

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

요청 매개 변수

매개 변수	형식	설명	필수
applicationId	문자열	블록 데이터를 검색할 데스크톱 애플리케이션의 제품 ID. 파트너 센터에서 데스크톱 애플리케이션의 제품 ID를 가져오려면 데스크톱 애플리케이션 분석 보고서(블록 보고서 등)를 열고 URL에서 제품 ID를 검색합니다.	예
fileName	문자열	차단된 실행 파일의 이름.
startDate	날짜	검색할 블록 데이터의 날짜 범위에 대한 시작 날짜. 기본값은 현재 날짜 이전 90일입니다.	아니요
endDate	날짜	검색할 블록 데이터의 날짜 범위에 대한 종료 날짜. 기본값은 현재 날짜입니다.	아니요
top	int	요청에서 반환할 데이터 행의 수. 지정되지 않은 경우 최댓값 및 기본값은 10000입니다. 쿼리에 행이 더 있는 경우, 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 응답 본문에 포함됩니다.	아니요
skip	int	쿼리에서 건너뛸 행 수. 이 매개 변수를 사용하여 큰 데이터 집합을 페이징합니다. 예를 들어 top=10000 및 skip=0은 데이터의 첫 10000행을 검색하고 top=10000 및 skip=10000은 데이터의 그 다음 10000행을 검색하는 식으로 이어집니다.	아니요
필터	문자열	응답의 행을 필터링하는 하나 이상의 문. 각 명령문에는 응답 본문의 필드 이름 및 eq 또는 ne 연산자와 연결된 값이 포함되며, 명령문은 and 또는 or을 사용하여 결합할 수 있습니다. 문자열 값은 필터 매개 변수에서 단일 따옴표로 묶여야 합니다. 응답 본문에서 지정할 수 있는 필드는 다음과 같습니다. applicationVersion architecture blockType deviceType market osRelease osVersion productName targetOs	아니요
orderby	문자열	각 블록에 대한 결과 데이터 값의 순서를 지정하는 명령문. 구문은 orderby=field [order],field [order],...입니다. 필드 매개 변수는 응답 본문의 다음의 문자열 중 하나일 수 있습니다. applicationVersion architecture blockType date deviceType market osRelease osVersion productName targetOs deviceCount order 매개 변수는 옵션이며 각 필드를 asc 또는 desc로 오름차순 또는 내림차순으로 지정할 수 있습니다. 기본값은 asc입니다. 다음은 orderby 문자열의 예시입니다. orderby=date,market	아니요
groupby	문자열	지정된 필드에만 데이터 집계를 적용하는 문. 응답 본문에서 지정할 수 있는 필드는 다음과 같습니다. applicationVersion architecture blockType deviceType market osRelease osVersion targetOs 반환된 데이터 행에는 groupby 매개 변수에 지정된 필드와 다음이 포함됩니다. applicationId date productName deviceCount	아니요

요청 예제

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

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockdetails?applicationId=10238467886765136388&fileName=contoso.exe&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/blockdetails?applicationId=10238467886765136388&fileName=contoso.exe&startDate=2018-05-01&endDate=2018-06-07&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

응답

응답 본문

값	형식	설명
값	배열	집계 블록 데이터가 포함된 개체의 배열. 각 개체의 데이터에 대한 자세한 정보는 다음의 테이블을 참조하세요.
@nextLink	문자열	추가적인 데이터 페이지가 있는 경우, 다음 데이터 페이지를 요청하는 데 사용할 수 있는 URI가 이 문자열에 포함됩니다. 예를 들어 요청의 top 매개 변수가 10000으로 설정되어 있지만 쿼리에 대한 블록 데이터 행이 10000개보다 많은 경우 이 값이 반환됩니다.
TotalCount	int	쿼리에 대한 데이터 결과의 총 행 수.

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

값	형식	설명
applicationId	문자열	블록 데이터를 검색한 데스크톱 애플리케이션의 제품 ID.
날짜	문자열	블록 적중 값과 관련된 날짜.
productName	문자열	연결된 실행 파일의 메타데이터에서 파생된 데스크톱 애플리케이션의 표시 이름.
fileName	문자열	차단된 실행 파일.
applicationVersion	문자열	차단된 애플리케이션 실행 파일의 버전.
osVersion	문자열	데스크톱 애플리케이션이 현재 실행 중인 OS 버전을 지정하는 다음 문자열 중 하나입니다. Windows 7 Windows 8.1 Windows 10 Windows 11 Windows Server 2016 Windows Server 1709 알 수 없음
osRelease	문자열	데스크톱 애플리케이션이 현재 실행 중인 OS 릴리스 또는 플라이팅 링(OS 버전 내 하위 집단)을 지정하는 다음 문자열 중 하나입니다. Windows 11의 경우: 버전 2110 Windows 10의 경우: 버전 1507 버전 1511 버전 1607 버전 1703 버전 1709 릴리스 미리 보기 초기 참가자 이후 참가자 Windows Server 1709의 경우: RTM Windows Server 2016의 경우: 버전 1607 Windows 8.1의 경우: 업데이트 1 Windows 7의 경우: 서비스 팩 1 OS 릴리스 또는 플라이팅 링을 알 수 없는 경우 이 필드의 값은 알 수 없음입니다.
market	문자열	데스크톱 애플리케이션이 차단된 시장의 ISO 3166 국가 번호.
deviceType	문자열	데스크톱 애플리케이션이 차단된 디바이스 유형을 지정하는 다음 문자열 중 하나입니다. PC 서버 태블릿 알 수 없음
blockType	문자열	디바이스에 있는 블록의 유형을 지정하는 다음 문자열 중 하나입니다. 잠재적 누적 임시 누적 런타임 알림 이러한 블록 형식과 이러한 블록이 개발자 및 사용자에게 미치는 영향에 대한 자세한 정보는 애플리케이션 블록 보고서의 설명을 참조하세요.
architecture	문자열	블록이 있는 디바이스의 아키텍처: ARM64 X86
targetOs	문자열	데스크톱 애플리케이션 실행이 차단된 Windows 10 또는 Windows 11 OS 릴리스를 지정하는 다음 문자열 중 하나입니다. 버전 1709 버전 1803
deviceCount	number	지정된 집계 수준에 블록이 있는 고유 디바이스의 수.

응답 예제

다음 예제는 이 요청의 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/blockdetails?applicationId=123456789&startDate=2018-01-01&endDate=2018-02-01&top=10000&skip=10000&groupby=applicationVersion,deviceType,osVersion,osRelease",
  "TotalCount": 23012
}

데스크톱 애플리케이션에 대한 업그레이드 차단 세부 정보 가져오기

필수 조건

요청

요청 구문

요청 헤더

요청 매개 변수

요청 예제

응답

응답 본문

응답 예제

피드백

피드백

추가 리소스

데스크톱 애플리케이션에 대한 업그레이드 차단 세부 정보 가져오기

필수 조건

요청

요청 구문

요청 헤더

요청 매개 변수

요청 예제

응답

응답 본문

응답 예제

관련 항목

피드백

피드백

추가 리소스