REST Resource: reviews

Tài nguyên: Đánh giá

Một bài đánh giá ứng dụng Android.

Biểu diễn dưới dạng JSON 
{
  "reviewId": string,
  "authorName": string,
  "comments": [
    {
      object (Comment)
    }
  ]
}
Trường
reviewId

string

Giá trị nhận dạng riêng biệt của bài đánh giá này.
authorName

string

Tên của người dùng đã viết bài đánh giá.
comments[]

object (Comment)

Một trường lặp lại chứa các bình luận cho bài đánh giá.

Bình luận

Một mục nhập của cuộc trò chuyện giữa người dùng và nhà phát triển.

Biểu diễn dưới dạng 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.
}
Trường

Trường nhóm comment.

comment chỉ có thể là một trong những trạng thái sau:
userComment

object (UserComment)

Một bình luận của người dùng.
developerComment

object (DeveloperComment)

Nhận xét của một nhà phát triển.

UserComment

Thông tin nhập của người dùng từ cuộc trò chuyện giữa người dùng và nhà phát triển.

Biểu diễn dưới dạng 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
}
Trường
text

string

Nội dung của bình luận, tức là nội dung bài đánh giá. Trong một số trường hợp, người dùng có thể viết bài đánh giá có tiêu đề và nội dung riêng biệt; trong những trường hợp đó, tiêu đề và nội dung được nối với nhau và phân tách bằng một ký tự tab.
lastModified

object (Timestamp)

Lần gần đây nhất bình luận này được cập nhật.
starRating

integer

Điểm xếp hạng theo sao liên kết với bài đánh giá, từ 1 đến 5.
reviewerLanguage

string

Mã ngôn ngữ của người đánh giá. Thông tin này được lấy từ phần cài đặt thiết bị nên không đảm bảo khớp với ngôn ngữ mà bài đánh giá được viết. Có thể không có.
device

string

Tên mã cho thiết bị của người đánh giá, ví dụ: klte, flounder. Có thể không có.
androidOsVersion

integer

Phiên bản SDK Android dạng số nguyên của thiết bị người dùng tại thời điểm viết bài đánh giá, ví dụ: 23 là Marshmallow. Có thể không có.
appVersionCode

integer

Mã phiên bản số nguyên của ứng dụng được cài đặt tại thời điểm viết bài đánh giá. Có thể không có.
appVersionName

string

Tên phiên bản dạng chuỗi của ứng dụng tại thời điểm cài đặt khi bài đánh giá được viết. Có thể không có.
thumbsUpCount

integer

Số người dùng đã nhấn nút thích cho bài đánh giá này.
thumbsDownCount

integer

Số người dùng đã không thích bài đánh giá này.
deviceMetadata

object (DeviceMetadata)

Thông tin về các đặc điểm của thiết bị mà người dùng sử dụng.
originalText

string

Văn bản chưa được dịch của bài đánh giá (nếu bài đánh giá đã được dịch). Nếu bài đánh giá chưa được dịch, trường này sẽ trống.

Dấu thời gian

Dấu thời gian biểu thị một thời điểm độc lập với múi giờ hoặc lịch địa phương, được mã hoá dưới dạng số giây và phần giây ở độ phân giải nano giây. Số lượng này được tính theo một thời điểm bắt đầu của hệ thống vào nửa đêm ngày 1 tháng 1 năm 1970 theo giờ UTC.

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

string (int64 format)

Biểu thị số giây của thời gian UTC kể từ thời gian bắt đầu của hệ thống Unix.
nanos

integer

Phân số không âm của một giây ở độ phân giải nano giây. Phải nằm trong khoảng từ 0 đến 999.999.999.

DeviceMetadata

Đặc điểm của thiết bị mà người dùng sử dụng.

Biểu diễn dưới dạng JSON 
{
  "productName": string,
  "manufacturer": string,
  "deviceClass": string,
  "screenWidthPx": integer,
  "screenHeightPx": integer,
  "nativePlatform": string,
  "screenDensityDpi": integer,
  "glEsVersion": integer,
  "cpuModel": string,
  "cpuMake": string,
  "ramMb": integer
}
Trường
productName

string

Tên mẫu thiết bị (ví dụ: Droid)
manufacturer

string

Nhà sản xuất thiết bị (ví dụ: Motorola)
deviceClass

string

Loại thiết bị (ví dụ: máy tính bảng)
screenWidthPx

integer

Chiều rộng màn hình tính bằng pixel
screenHeightPx

integer

Chiều cao màn hình tính bằng pixel
nativePlatform

string

Danh sách các nền tảng gốc được phân tách bằng dấu phẩy (ví dụ: "arm", "arm7")
screenDensityDpi

integer

Mật độ màn hình tính bằng DPI
glEsVersion

integer

Phiên bản OpenGL
cpuModel

string

Mẫu CPU của thiết bị, ví dụ: "MSM8974"
cpuMake

string

Nhà sản xuất CPU của thiết bị, ví dụ: "Qualcomm"
ramMb

integer

RAM của thiết bị tính bằng Megabyte, ví dụ: "2048"

DeveloperComment

Thông tin nhập của nhà phát triển trong cuộc trò chuyện giữa người dùng và nhà phát triển.

Biểu diễn dưới dạng JSON 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  }
}
Trường
text

string

Nội dung của bình luận, tức là nội dung trả lời.
lastModified

object (Timestamp)

Lần gần đây nhất bình luận này được cập nhật.

Phương thức

get

 Nhận một bài đánh giá duy nhất.

list

 Liệt kê tất cả bài đánh giá.

reply

 Trả lời một bài đánh giá hoặc cập nhật câu trả lời hiện có.

Mã lỗi

Các thao tác của tài nguyên này sẽ trả về các mã lỗi HTTP sau:

Mã lỗi Lý do Độ phân giải
5xx Lỗi chung trong máy chủ Google Play. Hãy thử gửi lại yêu cầu.

Nếu vấn đề vẫn tiếp diễn, hãy liên hệ với người quản lý tài khoản Google Play hoặc gửi yêu cầu hỗ trợ. Hãy cân nhắc kiểm tra Trang tổng quan về trạng thái của Play để xem có sự cố ngừng hoạt động nào đã biết hay không.
409 Lỗi cập nhật đồng thời.

Đã có một nỗ lực cập nhật một đối tượng đang được cập nhật. Ví dụ: giao dịch mua được xác nhận bằng cách gọi phương thức acknowledgePurchase() của Thư viện Play Billing và gọi purchases.products.acknowledge của API Nhà phát triển Play cùng một lúc.

 Hãy thử gửi lại yêu cầu.