Method: publishers.items.fetchReviews

Tìm nạp bài đánh giá của người dùng về một mặt hàng.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
name

string

Bắt buộc. Tên tài nguyên của mặt hàng có bài đánh giá đang được tìm nạp. Định dạng: publishers/{publisher_id}/items/{itemId}

Tham số truy vấn

Thông số
pageSize

integer

Không bắt buộc. Số lượng bài đánh giá tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không được chỉ định, hệ thống sẽ trả về tối đa 50 bài đánh giá. Giá trị tối đa là 200; các giá trị trên 200 sẽ được chuyển thành 200.
pageToken

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi items.fetchReviews trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho items.fetchReviews phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
filter

string

Không bắt buộc. Bộ lọc để áp dụng cho các bài đánh giá. Chỉ hỗ trợ so sánh bằng về điểm xếp hạng, ví dụ: rating = 5.
orderBy

string

Không bắt buộc. Danh sách các trường được phân tách bằng dấu phẩy (không bắt buộc) để sắp xếp kết quả. Thứ tự sắp xếp mặc định là tăng dần (asc). Các trường được hỗ trợ là: – rating: Thứ tự được hỗ trợ là asc (mặc định) và desc. – createTime: Chỉ hỗ trợ desc (gần đây nhất trước tiên); bạn phải chỉ định rõ ràng desc vì giá trị mặc định là asc. Ví dụ: rating desc, createTime desc hoặc rating desc, createTime desc.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Thông báo phản hồi cho items.fetchReviews.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "nextPageToken": string
}
Trường
reviews[]

object (Review)

Danh sách bài đánh giá.
nextPageToken

string

Mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua, thì sẽ không có trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Xem xét

Bài đánh giá do người dùng viết để xếp hạng một mục trong Cửa hàng Chrome trực tuyến.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "item": string,
  "authorInfo": {
    object (AuthorInfo)
  },
  "rating": integer,
  "comment": string,
  "createTime": string
}
Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của bài đánh giá. Định dạng: reviews/{reviewId}
item

string

Chỉ có đầu ra. Mục mà bài đánh giá này đánh giá. Định dạng: publishers/{publisher}/items/{item}
authorInfo

object (AuthorInfo)

Thông tin về tác giả của bài đánh giá.
rating

integer

Điểm xếp hạng của mặt hàng, từ 1 đến 5.
comment

string

Nội dung của bài đánh giá.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm đăng bài đánh giá.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

AuthorInfo

Thông tin về tác giả của bài đánh giá.

Biểu diễn dưới dạng JSON 
{
  "displayName": string
}
Trường
displayName

string

Tên hiển thị của tác giả.