REST Resource: reviews

資源:Review

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

留言的內容,例如評論內文。在某些情況下,使用者能以不同標題和內文撰寫評論;在這種情況下,標題和內文會串連在一起,並以定位字元分隔。

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 日午夜) 的一個紀元。

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

string (int64 format)

代表從 Unix Epoch 紀元時間起算,採用世界標準時間 (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

取得單一評論。

list

列出所有評論。

reply

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