REST Resource: reviews

리소스: Review

Android 앱 리뷰입니다.

JSON 표현 
{
  "reviewId": string,
  "authorName": string,
  "comments": [
    {
      object (Comment)
    }
  ]
}
필드
reviewId

string

이 리뷰의 고유 식별자입니다.
authorName

string

리뷰를 작성한 사용자의 이름입니다.
comments[]

object (Comment)

리뷰의 의견을 포함하는 반복되는 입력란입니다.

댓글

사용자와 개발자 사이의 대화 중 하나의 항목입니다.

JSON 표현 
{

  // Union field comment can be only one of the following:
  "userComment": {
    object (UserComment)
  },
  "developerComment": {
    object (DeveloperComment)
  }
  // End of list of possible types for union field comment.
}
필드

통합 필드 comment.

comment는 다음 중 하나여야 합니다.
userComment

object (UserComment)

사용자의 의견입니다.
developerComment

object (DeveloperComment)

개발자의 의견.

UserComment

사용자와 개발자 사이의 대화 중 사용자가 입력한 항목입니다.

JSON 표현 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  },
  "starRating": integer,
  "reviewerLanguage": string,
  "device": string,
  "androidOsVersion": integer,
  "appVersionCode": integer,
  "appVersionName": string,
  "thumbsUpCount": integer,
  "thumbsDownCount": integer,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "originalText": string
}
필드
text

string

의견의 내용, 즉 리뷰 본문입니다. 사용자는 경우에 따라 제목과 본문이 각각 따로 있는 리뷰를 작성할 수 있으며, 이 경우 제목과 본문이 연결되고 Tab 문자로 구분됩니다.
lastModified

object (Timestamp)

의견이 마지막으로 업데이트된 시간입니다.
starRating

integer

리뷰의 별표 평점입니다(1~5).
reviewerLanguage

string

리뷰 작성자의 언어 코드입니다. 기기 설정의 정보에서 가져온 값으로, 리뷰가 작성된 언어와 일치하지 않을 수 있습니다. 값이 없을 수 있습니다.
device

string

리뷰 작성자 기기의 코드명입니다(예: klte, flounder). 값이 없을 수 있습니다.
androidOsVersion

integer

리뷰가 작성된 시점의 사용자 기기의 Android SDK 버전 정수값입니다(예: 23은 Marshmallow). 값이 없을 수 있습니다.
appVersionCode

integer

리뷰가 작성된 시점에 설치되어 있는 앱의 버전 코드 정수값입니다. 값이 없을 수 있습니다.
appVersionName

string

리뷰가 작성된 시점에 설치되어 있는 앱의 버전 이름 문자열입니다. 값이 없을 수 있습니다.
thumbsUpCount

integer

이 리뷰에 좋아요를 준 사용자 수입니다.
thumbsDownCount

integer

이 리뷰에 싫어요를 준 사용자 수입니다.
deviceMetadata

object (DeviceMetadata)

사용자 기기의 특징에 관한 정보입니다.
originalText

string

리뷰가 번역된 경우, 리뷰의 번역되지 않은 텍스트입니다. 리뷰가 번역되지 않은 경우 공란입니다.

타임스탬프

타임스탬프는 시간대나 현지 캘린더를 사용하지 않고 초 및 나노초 수 단위로 인코딩된 특정 시점을 나타냅니다. 초 및 나노초 수는 1970년 1월 1일 자정(UTC) 에포크로부터 경과된 시간으로 계산됩니다.

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

유닉스 시간 이후 경과된 UTC 시간을 초 단위로 나타냅니다.
nanos

integer

나노초 단위의 음수가 아닌 초수입니다. 범위는 0~999,999,999(포함)이어야 합니다.

DeviceMetadata

사용자 기기의 특징입니다.

JSON 표현 
{
  "productName": string,
  "manufacturer": string,
  "deviceClass": string,
  "screenWidthPx": integer,
  "screenHeightPx": integer,
  "nativePlatform": string,
  "screenDensityDpi": integer,
  "glEsVersion": integer,
  "cpuModel": string,
  "cpuMake": string,
  "ramMb": integer
}
필드
productName

string

기기 모델 이름입니다 (예: Droid).
manufacturer

string

기기 제조업체입니다 (예: Motorola).
deviceClass

string

기기 클래스입니다 (예: tablet).
screenWidthPx

integer

화면 너비(픽셀)
screenHeightPx

integer

화면 높이입니다(단위: 픽셀).
nativePlatform

string

네이티브 플랫폼의 쉼표로 구분된 목록입니다 (예: "arm", "arm7").
screenDensityDpi

integer

화면 밀도입니다(단위: DPI).
glEsVersion

integer

OpenGL 버전
cpuModel

string

기기 CPU 모델입니다(예: "MSM8974").
cpuMake

string

기기 CPU 제조사입니다(예: "Qualcomm").
ramMb

integer

기기 RAM입니다(단위 MB, 예 "2048").

DeveloperComment

사용자와 개발자 사이의 대화 중 개발자가 입력한 항목입니다.

JSON 표현 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  }
}
필드
text

string

의견의 내용, 즉 답장 본문입니다.
lastModified

object (Timestamp)

의견이 마지막으로 업데이트된 시간입니다.

메서드

get

 단일 리뷰를 가져옵니다.

list

 모든 리뷰를 나열합니다.

reply

 단일 리뷰에 답장하거나 기존 답장을 업데이트합니다.

오류 코드

이 리소스의 작업은 다음 HTTP 오류 코드를 반환합니다.

오류 코드 이유 설명 해상도
400 invalidValue 요청에 잘못된 값이 제공되었습니다. 잘못되었거나 유효하지 않은 구매 토큰에 대해 반환되는 경우가 많습니다. API 참조에 따라 요청 본문 또는 매개변수의 잘못된 필드 값을 수정합니다.
400 required 요청에 필수 필드 또는 매개변수가 누락되었습니다. API 문서를 참고하여 모든 필수 입력란과 매개변수가 포함되어 있는지 확인하세요.
403 userInsufficientPermission 사용자에게 요청된 작업을 수행할 수 있는 충분한 권한이 없습니다. 인증된 사용자에게 Google Play Console에서 필요한 권한이 있는지 확인합니다. 자세한 내용은 서비스 계정 사용을 참고하세요.
404 notFound 요청된 리소스를 찾을 수 없습니다. 식별자 (예: 구매 토큰, 패키지 이름, 제품 ID, 정기 결제 ID)가 올바른지 확인합니다.
409 concurrentUpdate 동시에 업데이트되고 있는 객체를 업데이트하려고 시도했습니다. 지수 백오프로 요청 재시도 동일한 리소스를 동시에 수정하지 마세요.
5xx Generic error Google Play 서버의 일반 오류입니다. 요청을 다시 시도하세요.

문제가 계속되면 Google Play 계정 관리자에게 문의하거나 지원 요청을 제출하세요. Play 상태 대시보드에서 알려진 서비스 중단이 있는지 확인해 보세요.