앱 평점 가져오기

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

필수 조건

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

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

요청

요청 구문

메서드	URI 요청
가져오기	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/ratings`

요청 헤더

헤더	유형	설명
승인	문자열	필수 사항입니다. Azure AD 액세스 토큰은 전달자<토큰> 형식입니다.

요청 매개 변수

매개 변수	유형	설명	필수
애플리케이션 아이디	문자열	검색할 등급 데이터가 있는 앱의 스토어 ID .	예
시작 날짜	날짜	검색할 등급 데이터의 날짜 범위의 시작 날짜입니다. 기본값은 현재 날짜입니다.	아니오
종료일	날짜	검색할 등급 데이터의 날짜 범위 중 종료 날짜입니다. 기본값은 현재 날짜입니다.	아니오
맨 위로	정수 (int)	요청에 반환할 데이터 행 수입니다. 지정하지 않으면 최대값과 기본값은 10000입니다. 쿼리에 행이 더 있는 경우 응답 본문에는 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 포함됩니다.	아니오
건너뛰기	정수 (int)	쿼리에서 건너뛸 행의 수를 지정합니다. 이 매개변수를 사용하여 대량의 데이터 집합을 탐색하십시오. 예를 들어 top=10000 및 skip=0은 처음 10000개의 데이터 행을 검색하고 top=10000 및 skip=10000은 다음 10000개 행의 데이터 등을 검색합니다.	아니오
필터	문자열	응답의 행을 필터링하는 하나 이상의 구문이 있습니다. 자세한 내용은 아래 필터 필드 섹션을 참조하세요.	아니오
집계 수준	문자열	집계 데이터를 검색할 시간 범위를 지정합니다. 일, 주 또는 월 문자열 중 하나일 수 있습니다. 지정되지 않은 경우 기본값은 day입니다.	아니오
오더바이 (orderby)	문자열	각 등급의 결과 데이터 값을 정렬하는 문입니다. 구문은 orderby=field [order], field [order],.... 필드 매개 변수는 다음 문자열 중 하나일 수 있습니다. 날짜 os버전 시장 장치 유형 수정됨 order 매개 변수는 선택 사항이며 각 필드에 대해 오름차순 또는 내림차순을 지정하는 asc 또는 desc일 수 있습니다. 기본값은 asc입니다. 다음은 orderby 문자열의 예입니다. orderby=date,market	아니오
그룹바이	문자열	지정된 필드에만 데이터 집계를 적용하는 문입니다. 다음 필드를 지정할 수 있습니다. 날짜 애플리케이션 이름 시장 os버전 장치 유형 수정됨 반환된 데이터 행에는 groupby 매개 변수에 지정된 필드와 다음이 포함됩니다. 날짜 애플리케이션 ID 파이브스타 별 4개 별 3개 별 2개 원스타 groupby 매개 변수는 aggregationLevel 매개 변수와 함께 사용할 수 있습니다. 예: &groupby=osVersion,market&aggregationLevel=week	아니오

필터 필드

요청의 필터 매개 변수에는 응답의 행을 필터링하는 하나 이상의 문이 포함되어 있습니다. 각 진술에는 eq 또는 ne 연산자와 연결된 필드와 값이 포함되며, 그리고 또는 또는를 사용하여 결합할 수 있습니다.

다음은 문자열을 필터링하는 예입니다. filter=market eq 'US' 및 deviceType eq 'phone' 및 isRevised eq true

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

분야	설명
시장	앱이 평가된 시장의 ISO 3166 국가 코드가 포함된 문자열입니다.
운영체제 버전	다음 문자열 중 하나입니다. 윈도우 폰 7.5 윈도우 폰 8 윈도우 폰 8.1 윈도우 폰 10 윈도우 8 Windows 8.1 Windows 10 Windows 11 알려지지 않은
디바이스 유형	다음 문자열 중 하나입니다. 개인용 컴퓨터 전화 Console-Xbox 하나 Console-Xbox 시리즈 X 사물 인터넷(IoT 홀로그램 알려지지 않은
수정됨	수정된 등급에 대해 필터링하려면 true 를 지정합니다. 그렇지 않으면 false입니다.

예제 요청

다음 예제에서는 등급 데이터를 가져오기 위한 몇 가지 요청을 보여 줍니다. applicationId 값을 앱의 스토어 ID로 바꿉니다.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/ratings?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/ratings?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=market eq 'US' and deviceType eq 'phone' HTTP/1.1
Authorization: Bearer <your access token>

응답

응답 메시지 본문

가치	유형	설명
가치	배열	집계 등급 데이터를 포함하는 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 내용은 아래 등급 값 섹션을 참조하세요.
@nextLink	문자열	추가 데이터 페이지가 있는 경우 이 문자열에는 다음 데이터 페이지를 요청하는 데 사용할 수 있는 URI가 포함됩니다. 예를 들어 요청의 최상위 매개 변수가 10000으로 설정되어 있지만 쿼리에 대한 10000개 이상의 등급 데이터 행이 있는 경우 이 값이 반환됩니다.
총개수	정수 (int)	쿼리의 데이터 결과에 포함된 행의 총 개수입니다.

등급 값

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

가치	유형	설명
날짜	문자열	등급 데이터의 날짜 범위에서 첫 번째 날짜입니다. 요청이 1일을 지정한 경우 이 값은 해당 날짜입니다. 요청이 주, 월 또는 기타 날짜 범위를 지정한 경우 이 값은 해당 날짜 범위의 첫 번째 날짜입니다.
애플리케이션 아이디	문자열	등급 데이터를 검색하는 앱의 스토어 ID입니다.
응용 프로그램 이름	문자열	앱의 표시 이름입니다.
시장	문자열	등급이 제출된 시장의 ISO 3166 국가 코드입니다.
운영체제 버전	문자열	등급이 제출된 OS 버전입니다. 지원되는 문자열 목록은 위의 필터 필드 섹션을 참조하세요.
디바이스 유형	문자열	등급이 제출된 디바이스의 유형입니다. 지원되는 문자열 목록은 위의 필터 필드 섹션을 참조하세요.
수정됨	불리언 (Boolean)	true 값은 등급이 수정되었음을 나타냅니다. 그렇지 않으면 false입니다.
원스타	숫자	별 1개 등급의 수입니다.
별 2개	숫자	2성급 등급의 수입니다.
별 3개	숫자	3성급 등급의 수입니다.
별 4개	숫자	4성급 등급의 수입니다.
파이브스타	숫자	5성급 등급의 수입니다.

요청 및 응답 예제

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

샘플 요청

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/ratings?applicationId=9NBLGGGZ5QDR
HTTP/1.1
Authorization: Bearer <your access token>

예시 응답


{
    "Value": [
        {
            "date": "2012-09-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "oneStar": 1,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 1,
            "fiveStars": 3
        },
        {
            "date": "2012-09-02",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "oneStar": 3,
            "twoStars": 0,
            "threeStars": 1,
            "fourStars": 2,
            "fiveStars": 17
        },
        {
            "date": "2012-09-03",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "oneStar": 1,
            "twoStars": 1,
            "threeStars": 1,
            "fourStars": 5,
            "fiveStars": 17
        },
  ],
    "TotalCount": 3
}

샘플 요청

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/ratings?applicationId=9NBLGGGZ5QDR&startDate=06/19/2022&endDate=07/20/2022&top=10&skip=0&groupby=date,applicationName,market,osVersion,deviceType,isRevised
HTTP/1.1
Authorization: Bearer <your access token>

예시 응답

{
    "Value": [
        {
            "date": "2022-06-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "CL",
            "osVersion": "Windows 11",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-06-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "TR",
            "osVersion": "Windows 11",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-06-29",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "FR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 1,
            "fiveStars": 0
        },
        {
            "date": "2022-07-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "BR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-07-04",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "ES",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-07-06",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "ES",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-07-07",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "AE",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "true",
            "oneStar": 1,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 0
        },
        {
            "date": "2022-07-10",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "BR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "true",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-07-13",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "EG",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-07-14",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "BR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "true",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 1,
            "fiveStars": 0
        }
    ],
    "TotalCount": 10
}

피드백

이 페이지가 도움이 되었나요?

Last updated on 2025-04-30

다음을 통해 공유

앱 평점 가져오기

필수 조건

요청

요청 구문

요청 헤더

요청 매개 변수

필터 필드

예제 요청

응답

응답 메시지 본문

등급 값

요청 및 응답 예제

샘플 요청

예시 응답

샘플 요청

예시 응답

관련 항목

피드백

추가 리소스