앱 리뷰 가져오기Get app reviews

Microsoft Store analytics API에서이 메서드를 사용 하 여 지정 된 날짜 범위 및 기타 선택적 필터에 대 한 JSON 형식으로 검토 데이터를 가져옵니다.Use this method in the Microsoft Store analytics API to get review data in JSON format for a given date range and other optional filters. 이 정보는 파트너 센터의 리뷰 보고서 에서도 사용할 수 있습니다.This information is also available in the Reviews report in Partner Center.

검토를 검색 한 후에는 앱 검토에 대 한 응답 정보 가져오기 및 MICROSOFT STORE 리뷰 API의 앱 검토에 대 한 응답 제출 방법을 사용 하 여 프로그래밍 방식으로 검토에 응답할 수 있습니다.After you retrieve reviews, you can use the get response info for app reviews and submit responses to app reviews methods in the Microsoft Store reviews API to programmatically respond to reviews.

필수 구성 요소Prerequisites

이 방법을 사용 하려면 먼저 다음을 수행 해야 합니다.To use this method, you need to first do the following:

  • 아직 수행 하지 않은 경우 Microsoft Store 분석 API에 대 한 모든 필수 구성 요소 를 완료 합니다.If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • 이 메서드에 대 한 요청 헤더에 사용할 AZURE AD 액세스 토큰을 가져옵니다 .Obtain an Azure AD access token to use in the request header for this method. 액세스 토큰을 얻은 후 만료되기 전에 60분 동안 사용할 수 있습니다.After you obtain an access token, you have 60 minutes to use it before it expires. 토큰이 만료 된 후 새 토큰을 얻을 수 있습니다.After the token expires, you can obtain a new one.

요청Request

요청 구문Request syntax

방법Method 요청 URIRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews

요청 헤더Request header

헤더Header 형식Type DescriptionDescription
권한 부여Authorization 문자열string 필수 사항입니다.Required. Bearer <token> 형식의 Azure AD 액세스 토큰입니다.The Azure AD access token in the form Bearer <token>.

요청 매개 변수Request parameters

매개 변수Parameter TypeType 설명Description 필요한 공간Required
applicationIdapplicationId 문자열string 검토 데이터를 검색 하려는 앱의 저장소 ID 입니다.The Store ID of the app for which you want to retrieve review data. Yes
startDatestartDate datedate 검색할 검토 데이터의 날짜 범위에 있는 시작 날짜입니다.The start date in the date range of review data to retrieve. 기본값은 현재 날짜입니다.The default is the current date. 아니요No
endDateendDate datedate 검색할 검토 데이터의 날짜 범위에 있는 종료 날짜입니다.The end date in the date range of review data to retrieve. 기본값은 현재 날짜입니다.The default is the current date. No
toptop intint 요청에 반환할 데이터 행 수입니다.The number of rows of data to return in the request. 지정 되지 않은 경우 최대값 및 기본값은 1만입니다.The maximum value and the default value if not specified is 10000. 쿼리에 더 많은 행이 있는 경우 응답 본문에는 다음 데이터 페이지를 요청 하는 데 사용할 수 있는 다음 링크가 포함 됩니다.If there are more rows in the query, the response body includes a next link that you can use to request the next page of data. 아니요No
skipskip intint 쿼리에서 건너뛸 행의 수입니다.The number of rows to skip in the query. 이 매개 변수를 사용 하 여 많은 데이터 집합을 페이징 합니다.Use this parameter to page through large data sets. 예를 들어 top = 10000과 skip = 0은 처음 1만 개의 데이터 행을 검색 하 고 top = 10000 및 skip = 10000은 데이터의 다음 1만 행을 검색 하는 식입니다.For example, top=10000 and skip=0 retrieves the first 10000 rows of data, top=10000 and skip=10000 retrieves the next 10000 rows of data, and so on. 아니요No
filterfilter 문자열string 응답의 행을 필터링 하는 하나 이상의 문입니다.One or more statements that filter the rows in the response. 자세한 내용은 아래의 필터 필드 섹션을 참조 하십시오.For more information, see the filter fields section below. 아니요No
orderbyorderby 문자열string 결과 데이터 값을 정렬 하는 문입니다.A statement that orders the result data values. 구문은 orderby = field [order], field [order],...입니다. Field 매개 변수는 다음 문자열 중 하나일 수 있습니다.The syntax is orderby=field [order],field [order],.... The field parameter can be one of the following strings:
  • datedate
  • osVersionosVersion
  • 시장market
  • deviceTypedeviceType
  • isRevised 됨isRevised
  • packageVersionpackageVersion
  • deviceModeldeviceModel
  • Productfamily가productFamily
  • deviceScreenResolutiondeviceScreenResolution
  • isTouchEnabledisTouchEnabled
  • reviewerNamereviewerName
  • reviewTitlereviewTitle
  • reviewTextreviewText
  • helpfulCounthelpfulCount
  • notHelpfulCountnotHelpfulCount
  • responseDateresponseDate
  • responseTextresponseText
  • deviceRAMdeviceRAM
  • deviceStorageCapacitydeviceStorageCapacity
  • 점수rating

Order 매개 변수는 선택 사항이 며 asc 또는 desc 로 각 필드에 대해 오름차순 또는 내림차순을 지정할 수 있습니다.The order parameter is optional, and can be asc or desc to specify ascending or descending order for each field. 기본값은 asc입니다.The default is asc.

다음은 orderby 문자열의 예입니다. orderby = date, marketHere is an example orderby string: orderby=date,market

아니요No

필터 필드Filter fields

요청의 filter 매개 변수에는 응답의 행을 필터링 하는 문이 하나 이상 포함 되어 있습니다.The filter parameter of the request contains one or more statements that filter the rows in the response. 각 문에는 eq 또는 ne 연산자와 연결된 필드 및 값이 포함되어 있으며 일부 필드는 contains, gt, lt, gele 연산자도 지원합니다.Each statement contains a field and value that are associated with the eq or ne operators, and some fields also support the contains, gt, lt, ge, and le operators. And 또는 or를 사용 하 여 문을 결합할 수 있습니다.Statements can be combined using and or or.

필터 문자열의 예는 filter = contains (reviewText, ' reviewText ') 및 contains (, ' ads ') 2048 및 포함 (' US ') 입니다.Here is an example filter string: filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US'

각 필드에 대해 지원 되는 필드 및 지원 연산자 목록은 다음 표를 참조 하세요.For a list of the supported fields and support operators for each field, see the following table. 문자열 값은 필터 매개 변수에서 작은따옴표로 묶어야 합니다.String values must be surrounded by single quotes in the filter parameter.

필드Fields 지원되는 연산자Supported operators 설명Description
marketmarket eq, neeq, ne 장치 시장의 ISO 3166 국가 코드를 포함 하는 문자열입니다.A string that contains the ISO 3166 country code of the device market.
osVersionosVersion eq, neeq, ne Key, Input, Predict, PredictOnly, NoneOne of the following strings:
  • Windows Phone 7.5Windows Phone 7.5
  • Windows Phone 8Windows Phone 8
  • Windows Phone 8.1Windows Phone 8.1
  • Windows Phone 10Windows Phone 10
  • Windows 8Windows 8
  • Windows 8.1Windows 8.1
  • Windows 10Windows 10
  • 알 수 없음Unknown
deviceTypedeviceType eq, neeq, ne Key, Input, Predict, PredictOnly, NoneOne of the following strings:
  • 컴퓨터PC
  • 내선Phone
  • 콘솔-Xbox OneConsole-Xbox One
  • 콘솔-Xbox 시리즈 XConsole-Xbox Series X
  • IoTIoT
  • HolographicHolographic
  • 알 수 없음Unknown
isRevised 됨isRevised eq, neeq, ne 수정 된 검토를 필터링 하려면 true 를 지정 합니다. 그렇지 않으면 false입니다.Specify true to filter for reviews that have been revised; otherwise false.
packageVersionpackageVersion eq, neeq, ne 검토 한 응용 프로그램 패키지의 버전입니다.The version of the app package that was reviewed.
deviceModeldeviceModel eq, neeq, ne 앱이 검토된 디바이스 유형입니다.The type of device on which the app was reviewed.
Productfamily가productFamily eq, neeq, ne Key, Input, Predict, PredictOnly, NoneOne of the following strings:
  • 컴퓨터PC
  • 태블릿Tablet
  • 내선Phone
  • WearableWearable
  • ServerServer
  • 작업Collaborative
  • 기타Other
deviceRAMdeviceRAM eq, ne, gt, lt, ge, leeq, ne, gt, lt, ge, le 실제 RAM (MB)입니다.The physical RAM, in MB.
deviceScreenResolutiondeviceScreenResolution eq, neeq, ne " 너비 x 높이형식의 장치 화면 해상도 " 입니다.The device screen resolution in the format "width x height".
deviceStorageCapacitydeviceStorageCapacity eq, ne, gt, lt, ge, leeq, ne, gt, lt, ge, le 주 저장소 디스크의 용량 (GB)입니다.The capacity of the primary storage disk, in GB.
isTouchEnabledisTouchEnabled eq, neeq, ne 터치 사용 장치를 필터링 하려면 true 를 지정 합니다. 그렇지 않으면 false입니다.Specify true to filter for touch-enabled devices; otherwise false.
reviewerNamereviewerName eq, neeq, ne 검토자 이름입니다.The reviewer name.
ratingrating eq, ne, gt, lt, ge, leeq, ne, gt, lt, ge, le 앱 등급 (별)입니다.The app rating, in stars.
reviewTitlereviewTitle eq, ne, containseq, ne, contains 검토의 제목입니다.The title of the review.
reviewTextreviewText eq, ne, containseq, ne, contains 검토의 텍스트 내용입니다.The text contents of the review.
helpfulCounthelpfulCount eq, neeq, ne 검토가 유용 하 게 표시 된 횟수입니다.The number of times the review was marked helpful.
notHelpfulCountnotHelpfulCount eq, neeq, ne 검토가 유용 하지 않은 것으로 표시 된 횟수입니다.The number of times the review was marked not helpful.
responseDateresponseDate eq, neeq, ne 응답이 전송 된 날짜입니다.The date that the response was submitted.
responseTextresponseText eq, ne, containseq, ne, contains 응답의 텍스트 내용입니다.The text contents of the response.
idid eq, neeq, ne 검토 ID (GUID)입니다.The ID of the review (this is a GUID).

요청 예제Request example

다음 예에서는 검토 데이터를 가져오는 몇 가지 요청을 보여 줍니다.The following examples demonstrate several requests for getting review data. ApplicationId 값을 앱의 스토어 ID로 바꿉니다.Replace the applicationId value with the Store ID for your app.

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>

응답Response

응답 본문Response body

Value 형식Type DescriptionDescription
Value arrayarray 검토 데이터를 포함 하는 개체의 배열입니다.An array of objects that contain review data. 각 개체의 데이터에 대 한 자세한 내용은 아래의 값 검토 섹션을 참조 하십시오.For more information about the data in each object, see the review values section below.
@nextLink 문자열string 추가 데이터 페이지가 있는 경우이 문자열에는 다음 데이터 페이지를 요청 하는 데 사용할 수 있는 URI가 포함 됩니다.If there are additional pages of data, this string contains a URI that you can use to request the next page of data. 예를 들어 요청의 top 매개 변수가 1만로 설정 되어 있지만 쿼리에 대 한 데이터 검토 행이 1만 개를 초과 하는 경우이 값이 반환 됩니다.For example, this value is returned if the top parameter of the request is set to 10000 but there are more than 10000 rows of reviews data for the query.
TotalCountTotalCount intint 쿼리의 데이터 결과에 있는 총 행 수입니다.The total number of rows in the data result for the query.

 

값 검토Review values

배열의 요소에는 다음 값이 포함 됩니다.Elements in the Value array contain the following values.

Value 형식Type 설명Description
datedate 문자열string 검토 데이터의 날짜 범위에 있는 첫 번째 날짜입니다.The first date in the date range for the review data. 요청에서 하루를 지정 하는 경우이 값은 해당 날짜입니다.If the request specified a single day, this value is that date. 요청에서 주, 월 또는 다른 날짜 범위를 지정 하는 경우이 값은 해당 날짜 범위의 첫 번째 날짜입니다.If the request specified a week, month, or other date range, this value is the first date in that date range.
applicationIdapplicationId 문자열string 검토 데이터를 검색 중인 앱의 저장소 ID입니다.The Store ID of the app for which you are retrieving review data.
applicationNameapplicationName 문자열string 응용 프로그램의 표시 이름입니다.The display name of the app.
marketmarket 문자열string 검토가 제출 된 시장의 ISO 3166 국가 코드입니다.The ISO 3166 country code of the market where the review was submitted.
osVersionosVersion 문자열string 검토가 제출 된 OS 버전입니다.The OS version on which the review was submitted. 지원 되는 문자열 목록은 위의 필터 필드 섹션을 참조 하십시오.For a list of the supported strings, see the filter fields section above.
deviceTypedeviceType 문자열string 검토가 제출 된 장치의 유형입니다.The type of device on which the review was submitted. 지원 되는 문자열 목록은 위의 필터 필드 섹션을 참조 하십시오.For a list of the supported strings, see the filter fields section above.
isRevised 됨isRevised BooleanBoolean True 값은 검토가 수정 되었음을 나타냅니다. 그렇지 않으면 false입니다.The value true indicates that the review was revised; otherwise false.
packageVersionpackageVersion 문자열string 검토 한 응용 프로그램 패키지의 버전입니다.The version of the app package that was reviewed.
deviceModeldeviceModel 문자열string 앱이 검토된 디바이스 유형입니다.The type of device on which the app was reviewed.
Productfamily가productFamily 문자열string 장치 제품군 이름입니다.The device family name. 지원 되는 문자열 목록은 위의 필터 필드 섹션을 참조 하십시오.For a list of the supported strings, see the filter fields section above.
deviceRAMdeviceRAM numbernumber 실제 RAM (MB)입니다.The physical RAM, in MB.
deviceScreenResolutiondeviceScreenResolution 문자열string "너비 x 높이" 형식의 장치 화면 해상도입니다.The device screen resolution in the format "width x height".
deviceStorageCapacitydeviceStorageCapacity numbernumber 주 저장소 디스크의 용량 (GB)입니다.The capacity of the primary storage disk, in GB.
isTouchEnabledisTouchEnabled BooleanBoolean True 값은 터치가 사용 됨을 나타냅니다. 그렇지 않으면 false입니다.The value true indicates that touch is enabled; otherwise false.
reviewerNamereviewerName 문자열string 검토자 이름입니다.The reviewer name.
ratingrating numbernumber 앱 등급 (별)입니다.The app rating, in stars.
reviewTitlereviewTitle 문자열string 검토의 제목입니다.The title of the review.
reviewTextreviewText 문자열string 검토의 텍스트 내용입니다.The text contents of the review.
helpfulCounthelpfulCount numbernumber 검토가 유용 하 게 표시 된 횟수입니다.The number of times the review was marked helpful.
notHelpfulCountnotHelpfulCount numbernumber 검토가 유용 하지 않은 것으로 표시 된 횟수입니다.The number of times the review was marked not helpful.
responseDateresponseDate 문자열string 응답이 전송 된 날짜입니다.The date a response was submitted.
responseTextresponseText 문자열string 응답의 텍스트 내용입니다.The text contents of the response.
idid 문자열string 검토 ID (GUID)입니다.The ID of the review (this is a GUID). 검토에 대 한 응답 정보 가져오기앱 리뷰에 응답 제출 메서드에이 ID를 사용할 수 있습니다.You can use this ID in the get response info for app reviews and submit responses to app reviews methods.

응답 예제Response example

다음 예제에서는이 요청에 대 한 예제 JSON 응답 본문을 보여 줍니다.The following example demonstrates an example JSON response body for this request.

{
  "Value": [
    {
      "date": "2015-07-29",
      "applicationId": "9NBLGGGZ5QDR",
      "applicationName": "Contoso demo",
      "market": "US",
      "osVersion": "10.0.10240.16410",
      "deviceType": "PC",
      "isRevised": true,
      "packageVersion": "",
      "deviceModel": "Microsoft Corporation-Virtual Machine",
      "productFamily": "PC",
      "deviceRAM": -1,
      "deviceScreenResolution": "1024 x 768",
      "deviceStorageCapacity": 51200,
      "isTouchEnabled": false,
      "reviewerName": "ALeksandra",
      "rating": 5,
      "reviewTitle": "Love it",
      "reviewText": "Great app for demos and great dev response.",
      "helpfulCount": 0,
      "notHelpfulCount": 0,
      "responseDate": "2015-08-07T01:50:22.9874488Z",
      "responseText": "1",
      "id": "6be543ff-1c9c-4534-aced-af8b4fbe0316"
    }
  ],
  "@nextLink": null,
  "TotalCount": 1
}