앱 리뷰 가져오기

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

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

필수 조건

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

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

요청

요청 구문

요청 헤더

요청 매개 변수

필터 필드

요청의 필터 매개 변수에는 응답의 행을 필터링하는 하나 이상의 문이 포함되어 있습니다. 각 문에는 eq 또는 ne 연산자와 연결된 필드와 값이 포함되며 일부 필드는 contains, gt, lt, ge 및 le 연산자도 지원합니다. 문장을 그리고 또는 로 결합할 수 있습니다.

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

각 필드에 대해 지원되는 필드 및 지원 연산자 목록은 다음 표를 참조하세요. 문자열 값은 필터 매개 변수에서 작은따옴표로 묶어야 합니다.

예제 요청

다음 예제에서는 검토 데이터를 가져오기 위한 몇 가지 요청을 보여 줍니다. applicationId 값을 앱의 스토어 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>

응답

응답 메시지 본문

값을 검토하다

값 배열의 요소는 다음 값을 포함합니다.

요청 및 응답 예제

다음 코드 조각은 해당 요청에 대한 몇 가지 예제 요청 및 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
}

관련 항목

• 검토 보고서
• Microsoft Store 서비스를 사용하여 분석 데이터에 액세스
• 앱 검토에 대한 응답 정보 가져오기
• 앱 리뷰에 응답 제출
• 앱 인수 획득
• 추가 기능 획득하기
• 오류 보고 데이터 가져오기
• 앱 등급 가져오기