REST Resource: accounts.productReviews

Tài nguyên: ProductReview

Bài đánh giá về một sản phẩm. Để biết thêm thông tin, hãy xem bài viết Giới thiệu về nguồn cấp dữ liệu bài đánh giá sản phẩm

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "productReviewId": string,
  "attributes": {
    object (ProductReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "productReviewStatus": {
    object (ProductReviewStatus)
  }
}
Trường
name

string

Giá trị nhận dạng. Tên của bài đánh giá sản phẩm. Định dạng "{productreview.name=accounts/{account}/productReviews/{productReview}}"
productReviewId

string

Bắt buộc. Giá trị nhận dạng riêng biệt, cố định của bài đánh giá sản phẩm trong hệ thống của nhà xuất bản.
attributes

object (ProductReviewAttributes)

Không bắt buộc. Danh sách các thuộc tính bài đánh giá sản phẩm.
customAttributes[]

object (CustomAttribute)

Không bắt buộc. Danh sách các thuộc tính tuỳ chỉnh (do người bán cung cấp).
dataSource

string

Chỉ có đầu ra. Nguồn dữ liệu chính của bài đánh giá sản phẩm.
productReviewStatus

object (ProductReviewStatus)

Chỉ có đầu ra. Trạng thái của bài đánh giá sản phẩm, vấn đề về việc xác thực dữ liệu, tức là thông tin về bài đánh giá sản phẩm được tính toán không đồng bộ.

ProductReviewAttributes

Thuộc tính.

Biểu diễn dưới dạng JSON 
{
  "reviewTime": string,
  "pros": [
    string
  ],
  "cons": [
    string
  ],
  "reviewLink": {
    object (ReviewLink)
  },
  "reviewerImageLinks": [
    string
  ],
  "productNames": [
    string
  ],
  "productLinks": [
    string
  ],
  "asins": [
    string
  ],
  "gtins": [
    string
  ],
  "mpns": [
    string
  ],
  "skus": [
    string
  ],
  "brands": [
    string
  ],
  "collectionMethod": enum (CollectionMethod),
  "transactionId": string,
  "aggregatorName": string,
  "subclientName": string,
  "publisherName": string,
  "publisherFavicon": string,
  "reviewerId": string,
  "reviewerIsAnonymous": boolean,
  "reviewerUsername": string,
  "reviewLanguage": string,
  "reviewCountry": string,
  "title": string,
  "content": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "isSpam": boolean
}
Trường
reviewTime

string (Timestamp format)

Bắt buộc. Dấu thời gian cho biết thời điểm viết bài đánh giá.
pros[]

string

Không bắt buộc. Chứa các ưu điểm dựa trên ý kiến của người đánh giá. Bỏ qua văn bản tạo sẵn như "pro:" trừ phi người đánh giá viết.
cons[]

string

Không bắt buộc. Chứa những nhược điểm theo ý kiến của người đánh giá. Bỏ qua văn bản tạo sẵn như "con:", trừ phi đó là văn bản do người đánh giá viết.
productNames[]

string

Không bắt buộc. Tên mô tả của một sản phẩm.
asins[]

string

Không bắt buộc. Chứa ASIN (Mã nhận dạng chuẩn của Amazon) liên kết với một sản phẩm.
gtins[]

string

Không bắt buộc. Chứa GTIN (mã số sản phẩm thương mại toàn cầu) liên kết với một sản phẩm. Các loại phụ của GTIN (ví dụ: UPC, EAN, ISBN, JAN) được hỗ trợ.
mpns[]

string

Không bắt buộc. Chứa MPN (mã số linh kiện của nhà sản xuất) liên kết với một sản phẩm.
skus[]

string

Không bắt buộc. Chứa SKU (đơn vị lưu kho) liên kết với một sản phẩm. Thông thường, giá trị này khớp với Mã ưu đãi sản phẩm trong nguồn cấp dữ liệu sản phẩm.
brands[]

string

Không bắt buộc. Chứa tên thương hiệu liên kết với một sản phẩm.
collectionMethod

enum (CollectionMethod)

Không bắt buộc. Phương thức dùng để thu thập bài đánh giá.
transactionId

string

Không bắt buộc. Giá trị nhận dạng riêng biệt, cố định của giao dịch được liên kết với bài đánh giá trong hệ thống của nhà xuất bản. Bạn có thể dùng mã này để cho biết rằng nhiều bài đánh giá được liên kết với cùng một giao dịch.
aggregatorName

string

Không bắt buộc. Tên của trang web tổng hợp bài đánh giá sản phẩm.

Nhà xuất bản có thể sử dụng đơn vị tập hợp bài đánh giá để quản lý bài đánh giá và cung cấp nguồn cấp dữ liệu. Phần tử này cho biết mục đích sử dụng của đơn vị tập hợp và chứa thông tin về đơn vị tập hợp đó.
subclientName

string

Không bắt buộc. Tên của ứng dụng khách phụ của bài đánh giá sản phẩm.

Ứng dụng phụ là giá trị nhận dạng của nguồn bài đánh giá sản phẩm. Tệp này phải tương đương với thư mục được cung cấp trong đường dẫn nguồn dữ liệu của tệp.
publisherName

string

Không bắt buộc. Tên của nhà xuất bản bài đánh giá sản phẩm.

Thông tin về nhà xuất bản, có thể là nhà bán lẻ, nhà sản xuất, công ty dịch vụ đánh giá hoặc bất kỳ pháp nhân nào xuất bản bài đánh giá sản phẩm.
publisherFavicon

string

Không bắt buộc. Một đường liên kết đến biểu tượng trang web công ty của nhà xuất bản. Kích thước hình ảnh phải là kích thước biểu tượng trang web: 16x16 pixel. Hình ảnh phải ở định dạng GIF, JPG hoặc PNG.
reviewerId

string

Không bắt buộc. Tác giả của bài đánh giá sản phẩm.

Giá trị nhận dạng riêng biệt, cố định của tác giả bài đánh giá trong hệ thống của nhà xuất bản.
reviewerIsAnonymous

boolean

Không bắt buộc. Đặt thành true nếu người đánh giá vẫn nên ẩn danh.
reviewerUsername

string

Không bắt buộc. Tên của người đánh giá bài đánh giá sản phẩm.
reviewLanguage

string

Không bắt buộc. Ngôn ngữ đánh giá được xác định theo mã ngôn ngữ BCP-47.
reviewCountry

string

Không bắt buộc. Quốc gia của bài đánh giá được xác định theo Mã quốc gia ISO 3166-1 Alpha-2.
title

string

Không bắt buộc. Tiêu đề của bài đánh giá.
content

string

Bắt buộc. Nội dung của bài đánh giá.
minRating

string (int64 format)

Không bắt buộc. Chứa điểm xếp hạng liên quan đến bài đánh giá. Số lượng tối thiểu có thể cho điểm xếp hạng. Đây phải là điểm xếp hạng thấp nhất có thể và không được là giá trị cho trường hợp không có điểm xếp hạng.
maxRating

string (int64 format)

Không bắt buộc. Số điểm xếp hạng tối đa có thể. Giá trị của mức xếp hạng tối đa phải lớn hơn giá trị của thuộc tính tối thiểu.
rating

number

Không bắt buộc. Điểm xếp hạng tổng thể của người đánh giá về sản phẩm.
isSpam

boolean

Không bắt buộc. Cho biết bài đánh giá có bị đánh dấu là nội dung rác trong hệ thống của nhà xuất bản hay không.

Loại

Loại URI đánh giá.

Enum
TYPE_UNSPECIFIED Loại chưa được chỉ định.
SINGLETON Trang bài đánh giá chỉ chứa một bài đánh giá duy nhất.
GROUP Trang đánh giá chứa một nhóm các bài đánh giá bao gồm cả bài đánh giá này.

CollectionMethod

Phương thức dùng để thu thập bài đánh giá.

Enum
COLLECTION_METHOD_UNSPECIFIED Chưa chỉ định phương thức thu thập.
UNSOLICITED Người dùng không phản hồi một lời chào mời cụ thể khi gửi bài đánh giá.
POST_FULFILLMENT Người dùng gửi bài đánh giá để phản hồi lời mời sau khi đơn đặt hàng của người dùng được thực hiện.

ProductReviewStatus

Trạng thái xem xét sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "destinationStatuses": [
    {
      object (ProductReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ProductReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
Trường
destinationStatuses[]

object (ProductReviewDestinationStatus)

Chỉ có đầu ra. Các vị trí xuất hiện dự kiến của bài đánh giá sản phẩm.
itemLevelIssues[]

object (ProductReviewItemLevelIssue)

Chỉ có đầu ra. Danh sách tất cả vấn đề liên quan đến bài đánh giá sản phẩm.
createTime

string (Timestamp format)

Chỉ có đầu ra. Ngày tạo mặt hàng, ở định dạng ISO 8601.
lastUpdateTime

string (Timestamp format)

Chỉ có đầu ra. Ngày cập nhật mục gần đây nhất, ở định dạng ISO 8601.

ProductReviewDestinationStatus

Trạng thái đích đến của trạng thái bài đánh giá sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "reportingContext": enum (ReportingContextEnum)
}
Trường
reportingContext

enum (ReportingContextEnum)

Chỉ có đầu ra. Tên của ngữ cảnh báo cáo.

ProductReviewItemLevelIssue

ItemLevelIssue của trạng thái xem xét sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string
}
Trường
code

string

Chỉ có đầu ra. Mã lỗi của vấn đề.
severity

enum (Severity)

Chỉ có đầu ra. Mức độ ảnh hưởng của vấn đề này đến việc phân phát bài đánh giá sản phẩm.
resolution

string

Chỉ có đầu ra. Liệu người bán có thể giải quyết vấn đề hay không.
attribute

string

Chỉ có đầu ra. Tên của thuộc tính, nếu vấn đề là do một thuộc tính gây ra.
reportingContext

enum (ReportingContextEnum)

Chỉ có đầu ra. Ngữ cảnh báo cáo áp dụng vấn đề.
description

string

Chỉ có đầu ra. Nội dung mô tả ngắn gọn về vấn đề bằng tiếng Anh.
detail

string

Chỉ có đầu ra. Nội dung mô tả chi tiết về vấn đề bằng tiếng Anh.
documentation

string

Chỉ có đầu ra. URL của trang web để giúp giải quyết vấn đề này.

Mức độ nghiêm trọng

Mức độ ảnh hưởng của vấn đề đến việc phân phát bài đánh giá sản phẩm.

Enum
SEVERITY_UNSPECIFIED Chưa chỉ định.
NOT_IMPACTED Đây là vấn đề cảnh báo và không ảnh hưởng trực tiếp đến bài đánh giá sản phẩm.
DISAPPROVED Vấn đề khiến bài đánh giá sản phẩm bị từ chối.

Phương thức

delete

 Xoá bài đánh giá sản phẩm.

get

 Nhận bài đánh giá sản phẩm.

insert

 Chèn bài đánh giá sản phẩm.

list

 Liệt kê các bài đánh giá sản phẩm.