REST Resource: reviews

資源：評論

Android 應用程式評論。

JSON 表示法 
{
  "reviewId": string,
  "authorName": string,
  "comments": [
    {
      object (Comment)
    }
  ]
}
欄位
reviewId

string

這則評論的專屬 ID。
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 日世界標準時間午夜的 Epoch 紀元。

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
欄位
seconds

string (int64 format)

代表自 Unix Epoch 紀元時間起算的世界標準時間 (以秒為單位)。
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

 獲得一則評論。

list

 列出所有評論。

reply

 回覆單一評論，或更新現有回覆。

錯誤代碼

這項資源的作業會傳回下列 HTTP 錯誤碼：

錯誤代碼 原因 解析度
5xx Google Play 伺服器發生一般錯誤。 重試要求。

如果問題持續發生，請與 Google Play 帳戶管理員聯絡，或提交支援要求。 建議查看 Play 狀態資訊主頁，瞭解是否有已知服務中斷情形。
409 並行更新錯誤。

嘗試更新正在更新的物件。舉例來說，購買交易同時透過呼叫 Play 帳款服務程式庫的 acknowledgePurchase() 方法和 Play Developer API 的 purchases.products.acknowledge 進行確認。

 重試要求。