REST Resource: accounts.merchantReviews

Tài nguyên: MerchantReview

Bài đánh giá về người bán. Để 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á của người bán

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "merchantReviewId": string,
  "attributes": {
    object (MerchantReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "merchantReviewStatus": {
    object (MerchantReviewStatus)
  }
}
Trường
name

string

Giá trị nhận dạng. Tên của bài đánh giá người bán. Định dạng "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"
merchantReviewId

string

Bắt buộc. Người dùng đã cung cấp mã bài đánh giá của người bán để xác định riêng biệt bài đánh giá của người bán.
attributes

object (MerchantReviewAttributes)

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

object (CustomAttribute)

Bắt buộc. Danh sách các thuộc tính tuỳ chỉnh (do người bán cung cấp). Bạn cũng có thể sử dụng thuộc tính này để gửi bất kỳ thuộc tính nào của quy cách dữ liệu ở dạng chung chung (ví dụ: { "name": "size type", "value": "regular" }). Cách này rất hữu ích khi gửi các thuộc tính mà API không nêu rõ, chẳng hạn như các thuộc tính thử nghiệm. Số ký tự tối đa được phép cho mỗi thuộc tính tuỳ chỉnh là 10240 (thể hiện tổng số ký tự cho tên và giá trị). Bạn có thể đặt tối đa 2500 thuộc tính tuỳ chỉnh cho mỗi sản phẩm, với tổng kích thước là 102,4 kB. Dấu gạch dưới trong tên thuộc tính tuỳ chỉnh sẽ được thay thế bằng dấu cách khi chèn.
dataSource

string

Chỉ có đầu ra. Nguồn dữ liệu chính của bài đánh giá người bán.
merchantReviewStatus

object (MerchantReviewStatus)

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

MerchantReviewAttributes

Thuộc tính.

Biểu diễn dưới dạng JSON 
{
  "merchantId": string,
  "merchantDisplayName": string,
  "merchantLink": string,
  "merchantRatingLink": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "title": string,
  "content": string,
  "reviewerId": string,
  "reviewerUsername": string,
  "isAnonymous": boolean,
  "collectionMethod": enum (CollectionMethod),
  "reviewTime": string,
  "reviewLanguage": string,
  "reviewCountry": string
}
Trường
merchantId

string

Bắt buộc. Phải là duy nhất và ổn định trên tất cả các yêu cầu. Nói cách khác, nếu một yêu cầu hôm nay và một yêu cầu khác cách đây 90 ngày đề cập đến cùng một người bán, thì các yêu cầu đó phải có cùng mã nhận dạng.
merchantDisplayName

string

Không bắt buộc. Tên hiển thị mà con người đọc được của người bán.
minRating

string (int64 format)

Không bắt buộc. 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ố lượng tối đa có thể của điểm xếp hạng. Giá trị của mức xếp hạng tối đa phải lớn hơn giá trị của mức xếp hạng tối thiểu.
rating

number

Không bắt buộc. Điểm xếp hạng chung của người đánh giá về người bán.
title

string

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

string

Bắt buộc. Đây phải là văn bản dạng tuỳ ý do người dùng cung cấp và không được cắt bớt. Nếu bạn cung cấp nhiều câu trả lời cho nhiều câu hỏi, thì bạn phải đưa tất cả câu trả lời vào, kèm theo ngữ cảnh tối thiểu để các câu trả lời đó có ý nghĩa. Không được cung cấp ngữ cảnh nếu câu hỏi chưa được giải đáp.
reviewerId

string

Không bắt buộc. 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.
reviewerUsername

string

Không bắt buộc. Tên hiển thị của tác giả bài đánh giá.
isAnonymous

boolean

Không bắt buộc. Đặt thành true nếu người đánh giá muốn ẩn danh.
collectionMethod

enum (CollectionMethod)

Không bắt buộc. Phương thức dùng để thu thập bài đánh giá.
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á.
reviewLanguage

string

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

string

Không bắt buộc. Quốc gia nơi nhân viên đánh giá đặt hàng theo mã quốc gia ISO 3166-1 Alpha-2.

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.
MERCHANT_UNSOLICITED Người dùng không phản hồi một lời mời cụ thể khi gửi bài đánh giá.
POINT_OF_SALE Người dùng đã gửi bài đánh giá để phản hồi lời mời khi đặt hàng.
AFTER_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.

MerchantReviewStatus

Trạng thái của bài đánh giá người bán, vấn đề về xác thực dữ liệu (tức là thông tin về bài đánh giá người bán được tính toán không đồng bộ).

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

object (MerchantReviewDestinationStatus)

Chỉ có đầu ra. Các đích đến dự kiến cho bài đánh giá người bán.
itemLevelIssues[]

object (MerchantReviewItemLevelIssue)

Chỉ có đầu ra. Danh sách tất cả các vấn đề liên quan đến bài đánh giá người bán.
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.

MerchantReviewDestinationStatus

Trạng thái đích của trạng thái xem xét người bán.

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.

MerchantReviewItemLevelIssue

Item LevelIssue của trạng thái bài đánh giá người bán.

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á của người bán.
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. Bối cảnh báo cáo mà vấn đề áp dụng.
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 một 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á của người bán.

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

Phương thức

delete

 Xoá bài đánh giá người bán.

get

 Nhận bài đánh giá người bán.

insert

 Chèn một bài đánh giá cho tài khoản Merchant Center của bạn.

list

 Liệt kê các bài đánh giá người bán.