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

コメントの内容（レビューの本文）。タイトルと本文を分けてレビューを書ける場合があります。この場合、タイトルと本文は連結されタブ文字で区切られます。
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 日午前 0 時（UTC）のエポックを基準とします。

JSON 表現 
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

Unix エポックからの 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

デバイスのクラス（例: タブレット）
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

 1 件のレビューを取得します。

list

 すべてのレビューを一覧表示します。

reply

 1 件のレビューに返信するか、既存の返信を更新します。

エラーコード

このリソースのオペレーションは、次の HTTP エラーコードを返します。

エラーコード 理由 説明 解決策
400 invalidValue リクエストで無効な値が指定されました。多くの場合、これは形式が正しくないか無効な購入トークンに対して返されます。 API リファレンスに基づいて、リクエスト本文またはパラメータの無効なフィールド値を修正します。
400 required リクエストに必須のフィールドまたはパラメータがありません。 API のドキュメントを参照して、すべての必須フィールドとパラメータが含まれていることを確認します。
403 userInsufficientPermission リクエストされたオペレーションを実行する権限がユーザーにありません。 認証済みユーザーが Google Play Console で必要な権限を持っていることを確認します。詳細については、 サービス アカウントの使用をご覧ください。
404 notFound リクエストされたリソースが見つかりませんでした。 ID（購入トークン、パッケージ名、商品 ID、定期購入 ID など）が正しいことを確認します。
409 concurrentUpdate 同時に更新されているオブジェクトを更新しようとしました。 指数バックオフを使用してリクエストを再試行します。同じリソースへの同時変更は避けてください。
5xx Generic error Google Play サーバーの一般的なエラー。 リクエストを再試行してください。

問題が解決しない場合は、Google Play アカウント マネージャーにお問い合わせいただくか、サポート リクエストを送信してください。Google Play ステータス ダッシュボードで、既知のサービス停止がないか確認してください。