Method: publishers.items.fetchReviews

擷取項目的使用者評論。

HTTP 要求

GET https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:fetchReviews

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必填。要擷取評論的項目資源名稱，格式：publishers/{publisher_id}/items/{itemId}

查詢參數

參數
pageSize

integer

(選用步驟) 要傳回的評論數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多會傳回 50 則評論。許可的最大值為 200；超出的數值將一律指定為 200。
pageToken

string

(選用步驟) 從前一個 items.fetchReviews 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 items.fetchReviews 的所有其他參數須與提供網頁權杖的呼叫相符。
filter

string

(選用步驟) 要套用至評論的篩選器。僅支援評分相等比較，例如 rating = 5。
orderBy

string

(選用步驟) (選用) 以半形逗號分隔的欄位清單，用於排序結果。預設排列順序為遞增 (asc)。支援的欄位如下：- rating：支援的順序為 asc (預設) 和 desc。createTime：僅支援 desc (最新優先)；由於預設值為 asc，因此必須明確指定 desc。例如：rating desc、createTime desc 或 rating desc, createTime desc。

要求主體

要求主體必須為空白。

回應主體

items.fetchReviews 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "nextPageToken": string
}
欄位
reviews[]

object (Review)

評論清單。
nextPageToken

string

可做為 pageToken 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/chromewebstore
  • https://www.googleapis.com/auth/chromewebstore.readonly

查看

使用者撰寫的評論，用於評分 Chrome 線上應用程式商店中的項目。

JSON 表示法 
{
  "name": string,
  "item": string,
  "authorInfo": {
    object (AuthorInfo)
  },
  "rating": integer,
  "comment": string,
  "createTime": string
}
欄位
name

string

ID。查看資源名稱。格式：reviews/{reviewId}
item

string

僅供輸出。這則評論評估的項目。格式：publishers/{publisher}/items/{item}
authorInfo

object (AuthorInfo)

評論作者的相關資訊。
rating

integer

項目的評分，介於 1 到 5 之間。
comment

string

評論內容。
createTime

string (Timestamp format)

僅供輸出。評論發布時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

AuthorInfo

評論作者的相關資訊。

JSON 表示法 
{
  "displayName": string
}
欄位
displayName

string

作者的顯示名稱。