앱 리뷰 가져오기

아티클
03/13/2024

Microsoft Store 분석 API에서 이 메서드를 사용하여 지정된 날짜 범위 및 다른 선택적 필터에 대한 리뷰 데이터를 JSON 형식으로 가져옵니다. 이 정보는 파트너 센터의 리뷰 보고서에서도 볼 수 있습니다.

리뷰를 검색한 다음, Microsoft Store 리뷰 API에서 앱 리뷰에 대한 응답 정보 가져오기 및 앱 리뷰에 응답 제출하기 메서드를 사용하여 프로그래밍 방식으로 리뷰에 응답할 수 있습니다.

필수 조건

이 메서드를 사용하려면 먼저 다음 방법대로 해야 합니다.

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

Request

요청 구문

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

요청 헤더

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

요청 매개 변수

매개 변수	형식	설명	필수
applicationId	문자열	리뷰 데이터를 검색할 앱의 Store ID.	예
startDate	date	검색할 리뷰 데이터의 날짜 범위의 시작 날짜. 기본값은 현재 날짜입니다.	아니요
endDate	date	검색할 리뷰 데이터의 날짜 범위의 종료 날짜. 기본값은 현재 날짜입니다.	아니요
top	int	요청에서 반환할 데이터 행의 수. 지정되지 않은 경우 최댓값 및 기본값은 10000입니다. 쿼리에 행이 더 있는 경우, 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 응답 본문에 포함됩니다.	아니요
skip	int	쿼리에서 건너뛸 행 수. 이 매개 변수를 사용하여 큰 데이터 집합을 페이징합니다. 예를 들어 top=10000 및 skip=0은 데이터의 첫 10000행을 검색하고 top=10000 및 skip=10000은 데이터의 그 다음 10000행을 검색하는 식으로 이어집니다.	아니요
필터	문자열	응답의 행을 필터링하는 하나 이상의 문. 자세한 정보는 아래의 필터 필드 섹션을 참조하세요.	아니요
orderby	문자열	결과 데이터 값을 정렬하는 문. 구문은 orderby=field [order],field [order],...입니다. 필드 매개 변수는 다음 문자열 중 하나일 수 있습니다. date osVersion 시장 deviceType isRevised packageVersion deviceModel productFamily deviceScreenResolution isTouchEnabled reviewerName reviewTitle reviewText helpfulCount notHelpfulCount responseDate responseText deviceRAM deviceStorageCapacity 등급 order 매개 변수는 옵션이며 각 필드를 asc 또는 desc로 오름차순 또는 내림차순으로 지정할 수 있습니다. 기본값은 asc입니다. 다음은 orderby 문자열의 예시입니다. orderby=date,market	아니요

필터 필드

요청의 필터 매개 변수는 응답의 행을 필터링하는 하나 이상의 문을 포함합니다. 각 문에는 eq 또는 ne 연산자와 연결된 필드와 값이 포함되며, 일부 필드는 contains, gt, lt, ge 및 le 연산자도 지원합니다. 문은 and 또는 or을 사용하여 결합될 수 있습니다.

다음은 필터 문자열의 예입니다. filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US'

각 필드에 대해 지원되는 필드 및 지원 연산자 목록은 다음의 테이블을 참조하세요. 문자열 값은 필터 매개 변수에서 단일 따옴표로 묶여야 합니다.

필드	지원되는 연산자	설명
시장	eq, ne	디바이스 시장의 ISO 3166 국가 코드를 포함하는 문자열.
osVersion	eq, ne	다음의 문자열 중 하나입니다. Windows Phone 7.5 Windows Phone 8 Windows Phone 8.1 Windows Phone 10 Windows 8 Windows 8.1 Windows 10 Windows 11 알 수 없음
deviceType	eq, ne	다음의 문자열 중 하나입니다. PC 전화 콘솔-Xbox One 콘솔-Xbox 시리즈 X IoT Holographic 알 수 없음
isRevised	eq, ne	수정된 리뷰를 필터링하려면 true를 지정하고, 그렇지 않으면 false를 지정합니다.
packageVersion	eq, ne	리뷰된 앱 패키지의 버전.
deviceModel	eq, ne	앱을 리뷰한 디바이스 유형.
productFamily	eq, ne	다음의 문자열 중 하나입니다. PC 태블릿 전화 착용식 디바이스 서버 공동 작업 기타
deviceRAM	eq, ne, gt, lt, ge, le	실제 RAM(MB).
deviceScreenResolution	eq, ne	"너비 x 높이" 형식의 디바이스 화면 해상도.
deviceStorageCapacity	eq, ne, gt, lt, ge, le	기본 스토리지 디스크의 용량(GB).
isTouchEnabled	eq, ne	터치 사용 디바이스를 필터링하려면 true를 지정하고, 그렇지 않으면 false를 지정합니다.
reviewerName	eq, ne	리뷰한 사용자의 이름.
등급	eq, ne, gt, lt, ge, le	앱의 등급(별).
reviewTitle	eq, ne, contains	리뷰 제목.
reviewText	eq, ne, contains	리뷰의 텍스트 내용.
helpfulCount	eq, ne	리뷰가 유용하다고 표시된 횟수.
notHelpfulCount	eq, ne	리뷰가 유용하지 않다고 표시된 횟수.
responseDate	eq, ne	응답이 제출된 날짜.
responseText	eq, ne, contains	응답의 텍스트 내용.
id	eq, ne	리뷰의 ID(GUID).

요청 예시

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

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US' HTTP/1.1
Authorization: Bearer <your access token>

응답

응답 본문

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

리뷰 값

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

값	형식	설명
date	문자열	리뷰 데이터에 대한 날짜 범위의 시작 날짜. 요청에서 하루를 지정한 경우 이 값은 해당 날짜입니다. 요청에서 주, 월 또는 기타 날짜 범위를 지정한 경우, 이 값은 해당 날짜 범위 중 첫 날짜입니다.
applicationId	문자열	리뷰 데이터를 검색할 앱의 Store ID.
applicationName	문자열	앱의 표시 이름.
시장	문자열	리뷰가 제출된 시장의 ISO 3166 국가 코드.
osVersion	문자열	리뷰가 제출된 OS 버전. 지원되는 문자열 목록은 위의 필터 필드 섹션을 참조하세요.
deviceType	문자열	리뷰가 제출된 디바이스의 유형. 지원되는 문자열 목록은 위의 필터 필드 섹션을 참조하세요.
isRevised	Boolean	true 값은 리뷰가 수정되었음을 나타내고, 그렇지 않으면 false입니다.
packageVersion	문자열	리뷰된 앱 패키지의 버전.
deviceModel	문자열	앱을 리뷰한 디바이스 유형.
productFamily	문자열	디바이스 패밀리 이름. 지원되는 문자열 목록은 위의 필터 필드 섹션을 참조하세요.
deviceRAM	number	실제 RAM(MB).
deviceScreenResolution	문자열	"너비 x 높이" 형식의 디바이스 화면 해상도.
deviceStorageCapacity	number	기본 스토리지 디스크의 용량(GB).
isTouchEnabled	Boolean	true 값은 터치가 사용됨을 나타내고, 그렇지 않으면 false입니다.
reviewerName	문자열	리뷰한 사용자의 이름.
등급	number	앱의 등급(별).
reviewTitle	문자열	리뷰 제목.
reviewText	문자열	리뷰의 텍스트 내용.
helpfulCount	number	리뷰가 유용하다고 표시된 횟수.
notHelpfulCount	number	리뷰가 유용하지 않다고 표시된 횟수.
responseDate	문자열	응답이 제출된 날짜.
responseText	문자열	응답의 텍스트 내용.
id	문자열	리뷰의 ID(GUID). 이 ID는 앱 리뷰에 대한 응답 정보 가져오기 및 앱 리뷰에 대한 응답 제출하기 메서드에서 사용할 수 있습니다.

요청 및 응답 예제

다음 코드 조각은 해당 요청에 대한 몇 가지 예제 요청 및 JSON 응답 본문을 보여 줍니다.

샘플 요청

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9WZDNCRFJB4P&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

샘플 응답

{
    "Value": [
        {
            "date": "3/5/2021 12:48:33 PM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "ES",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "Jose Antonio",
            "rating": 5,
            "reviewTitle": "Contoso Demo",
            "reviewText": "Un juego fantastico",
            "helpfulCount": 3,
            "notHelpfulCount": 0,
            "id": "b5e27de9-2334-4849-d17d-4eae3e1e7aa9"
        },
        {
            "date": "1/6/2021 8:41:42 AM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "TR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "fef",
            "rating": 5,
            "helpfulCount": 0,
            "notHelpfulCount": 0,
            "id": "f5d2510a-9796-45ee-01e5-6d5cc4550b09"
        }
    ],
    "TotalCount": 2
}

다음을 통해 공유

앱 리뷰 가져오기

필수 조건

Request

요청 구문

요청 헤더

요청 매개 변수

필터 필드

요청 예시

응답

응답 본문

리뷰 값

요청 및 응답 예제

샘플 요청

샘플 응답

피드백

추가 리소스

다음을 통해 공유

앱 리뷰 가져오기

필수 조건

Request

요청 구문

요청 헤더

요청 매개 변수

필터 필드

요청 예시

응답

응답 본문

리뷰 값

요청 및 응답 예제

샘플 요청

샘플 응답

관련 항목

피드백

추가 리소스