Chỉ mục
MerchantReviewsService
(giao diện)ProductReviewsService
(giao diện)DeleteMerchantReviewRequest
(thông báo)DeleteProductReviewRequest
(thông báo)GetMerchantReviewRequest
(thông báo)GetProductReviewRequest
(thông báo)InsertMerchantReviewRequest
(thông báo)InsertProductReviewRequest
(thông báo)ListMerchantReviewsRequest
(thông báo)ListMerchantReviewsResponse
(thông báo)ListProductReviewsRequest
(thông báo)ListProductReviewsResponse
(thông báo)MerchantReview
(thông báo)MerchantReviewAttributes
(thông báo)MerchantReviewAttributes.CollectionMethod
(enum)MerchantReviewStatus
(thông báo)MerchantReviewStatus.MerchantReviewDestinationStatus
(thông báo)MerchantReviewStatus.MerchantReviewItemLevelIssue
(thông báo)MerchantReviewStatus.MerchantReviewItemLevelIssue.Severity
(enum)ProductReview
(thông báo)ProductReviewAttributes
(thông báo)ProductReviewAttributes.CollectionMethod
(enum)ProductReviewAttributes.ReviewLink
(thông báo)ProductReviewAttributes.ReviewLink.Type
(enum)ProductReviewStatus
(thông báo)ProductReviewStatus.ProductReviewDestinationStatus
(thông báo)ProductReviewStatus.ProductReviewItemLevelIssue
(thông báo)ProductReviewStatus.ProductReviewItemLevelIssue.Severity
(enum)
MerchantReviewsService
Dịch vụ quản lý bài đánh giá của người bán.
DeleteMerchantReview |
---|
Xoá bài đánh giá người bán.
|
GetMerchantReview |
---|
Nhận bài đánh giá người bán.
|
InsertMerchantReview |
---|
Chèn một bài đánh giá cho tài khoản Merchant Center của bạn. Nếu bài đánh giá đã tồn tại, thì bài đánh giá đó sẽ được thay thế bằng thực thể mới.
|
ListMerchantReviews |
---|
Liệt kê các bài đánh giá người bán.
|
ProductReviewsService
Dịch vụ quản lý bài đánh giá sản phẩm.
DeleteProductReview |
---|
Xoá bài đánh giá sản phẩm.
|
GetProductReview |
---|
Nhận bài đánh giá sản phẩm.
|
InsertProductReview |
---|
Chèn bài đánh giá sản phẩm.
|
ListProductReviews |
---|
Liệt kê các bài đánh giá sản phẩm.
|
DeleteMerchantReviewRequest
Thông báo yêu cầu cho phương thức DeleteMerchantReview
.
Trường | |
---|---|
name |
Bắt buộc. Mã của bài đánh giá người bán. Định dạng: accounts/{account}/merchantReviews/{merchantReview} |
DeleteProductReviewRequest
Thông báo yêu cầu cho phương thức DeleteProductReview
.
Trường | |
---|---|
name |
Bắt buộc. Mã của bài đánh giá sản phẩm. Định dạng: accounts/{account}/productReviews/{productReview} |
GetMerchantReviewRequest
Thông báo yêu cầu cho phương thức GetMerchantReview
.
Trường | |
---|---|
name |
Bắt buộc. Mã của bài đánh giá người bán. Định dạng: accounts/{account}/merchantReviews/{merchantReview} |
GetProductReviewRequest
Thông báo yêu cầu cho phương thức GetProductReview.
Trường | |
---|---|
name |
Bắt buộc. Mã của bài đánh giá người bán. Định dạng: accounts/{account}/productReviews/{productReview} |
InsertMerchantReviewRequest
Thông báo yêu cầu cho phương thức InsertMerchantReview
.
Trường | |
---|---|
parent |
Bắt buộc. Tài khoản mà bạn sẽ chèn bài đánh giá của người bán. Định dạng: accounts/{account} |
merchant_ |
Bắt buộc. Bài đánh giá người bán cần chèn. |
data_ |
Bắt buộc. Nguồn dữ liệu của định dạng merchantreview: |
InsertProductReviewRequest
Thông báo yêu cầu cho phương thức InsertProductReview
.
Trường | |
---|---|
parent |
Bắt buộc. Tài khoản mà bạn sẽ chèn bài đánh giá sản phẩm. Định dạng: accounts/{account} |
product_ |
Bắt buộc. Bài đánh giá sản phẩm cần chèn. |
data_ |
Bắt buộc. Định dạng: |
ListMerchantReviewsRequest
Thông báo yêu cầu cho phương thức ListMerchantsReview
.
Trường | |
---|---|
parent |
Bắt buộc. Tài khoản để đăng bài đánh giá người bán. Định dạng: accounts/{account} |
page_ |
Không bắt buộc. Số lượng bài đánh giá người bán tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Giá trị tối đa là 1000; các giá trị trên 1000 sẽ được chuyển đổi thành 1000. Nếu không chỉ định, hệ thống sẽ trả về số lượng bài đánh giá tối đa. |
page_ |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi Khi phân trang, tất cả các tham số khác được cung cấp cho |
ListMerchantReviewsResponse
Thông báo phản hồi cho phương thức ListMerchantsReview
.
Trường | |
---|---|
merchant_ |
Bài đánh giá người bán. |
next_ |
Mã thông báo để truy xuất trang kết quả tiếp theo. |
ListProductReviewsRequest
Thông báo yêu cầu cho phương thức ListProductReviews.
Trường | |
---|---|
parent |
Bắt buộc. Tài khoản để đăng bài đánh giá sản phẩm. Định dạng: accounts/{account} |
page_ |
Không bắt buộc. Số lượng sản phẩm tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. |
page_ |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi Khi phân trang, tất cả các tham số khác được cung cấp cho |
ListProductReviewsResponse
thông báo phản hồi cho phương thức ListProductReviews.
Trường | |
---|---|
product_ |
Bài đánh giá sản phẩm. |
next_ |
Mã thông báo có thể được gửi dưới dạng |
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
Trường | |
---|---|
name |
Giá trị nhận dạng. Tên của bài đánh giá người bán. Định dạng |
merchant_ |
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 |
Không bắt buộc. Danh sách các thuộc tính bài đánh giá người bán. |
custom_ |
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 (ví dụ: |
data_ |
Chỉ có đầu ra. Nguồn dữ liệu chính của bài đánh giá người bán. |
merchant_ |
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.
Trường | |
---|---|
merchant_ |
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. |
merchant_ |
Không bắt buộc. Tên hiển thị mà con người đọc được của người bán. |
merchant_ |
Không bắt buộc. URL của trang web chính của người bán. Không sử dụng URL chuyển hướng cho giá trị này. Nói cách khác, giá trị này phải trỏ trực tiếp đến trang web của người bán. |
merchant_ |
Không bắt buộc. URL của trang đích lưu trữ bài đánh giá cho người bán này. Không sử dụng URL chuyển hướng. |
min_ |
Không bắt buộc. Số điểm xếp hạng tối thiểu có thể có. Đâ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. |
max_ |
Không bắt buộc. Số điểm xếp hạng tối đa có thể. Giá trị của điểm xếp hạng tối đa phải lớn hơn giá trị của điểm xếp hạng tối thiểu. |
rating |
Không bắt buộc. Điểm xếp hạng tổng thể của người đánh giá về người bán. |
title |
Không bắt buộc. Tiêu đề của bài đánh giá. |
content |
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. |
reviewer_ |
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. |
reviewer_ |
Không bắt buộc. Tên hiển thị của tác giả bài đánh giá. |
is_ |
Không bắt buộc. Đặt thành true nếu người đánh giá muốn ẩn danh. |
collection_ |
Không bắt buộc. Phương thức dùng để thu thập bài đánh giá. |
review_ |
Bắt buộc. Dấu thời gian cho biết thời điểm viết bài đánh giá. |
review_ |
Bắt buộc. Ngôn ngữ của bài đánh giá được xác định theo mã ngôn ngữ BCP-47. |
review_ |
Không bắt buộc. Quốc gia nơi người đánh giá đặt hàng, được xác định 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 |
Phương thức thu thập chưa được chỉ định. |
MERCHANT_UNSOLICITED |
Người dùng không phản hồi một yêu cầu cụ thể khi gửi bài đánh giá. |
POINT_OF_SALE |
Người dùng gửi bài đánh giá để đáp lại một yêu cầu khi họ đặt hàng. |
AFTER_FULFILLMENT |
Người dùng gửi bài đánh giá để đáp lại một yêu cầu sau khi đơn đặt hàng của họ được thực hiện. |
MerchantReviewStatus
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ộ.
Trường | |
---|---|
destination_ |
Chỉ có đầu ra. Các đích đến dự kiến cho bài đánh giá người bán. |
item_ |
Chỉ có đầu ra. Danh sách tất cả vấn đề liên quan đến bài đánh giá người bán. |
create_ |
Chỉ có đầu ra. Ngày tạo mặt hàng, ở định dạng ISO 8601. |
last_ |
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.
Trường | |
---|---|
reporting_ |
Chỉ có đầu ra. Tên của ngữ cảnh báo cáo. |
MerchantReviewItemLevelIssue
ItemLevelIssue của trạng thái xem xét của người bán.
Trường | |
---|---|
code |
Chỉ có đầu ra. Mã lỗi của vấn đề. |
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 |
Chỉ có đầu ra. Liệu người bán có thể giải quyết vấn đề hay không. |
attribute |
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. |
reporting_ |
Chỉ có đầu ra. Bối cảnh báo cáo mà vấn đề áp dụng. |
description |
Chỉ có đầu ra. Nội dung mô tả ngắn gọn về vấn đề bằng tiếng Anh. |
detail |
Chỉ có đầu ra. Nội dung mô tả chi tiết về vấn đề bằng tiếng Anh. |
documentation |
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á 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. |
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
Trường | |
---|---|
name |
Giá trị nhận dạng. Tên của bài đánh giá sản phẩm. Định dạng |
product_ |
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 |
Không bắt buộc. Danh sách các thuộc tính bài đánh giá sản phẩm. |
custom_ |
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). |
data_ |
Chỉ có đầu ra. Nguồn dữ liệu chính của bài đánh giá sản phẩm. |
product_ |
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.
Trường | |
---|---|
review_ |
Bắt buộc. Dấu thời gian cho biết thời điểm viết bài đánh giá. |
pros[] |
Không bắt buộc. Chứa những ư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 đó là văn bản do người đánh giá viết. |
cons[] |
Không bắt buộc. Chứa những điểm bất lợi dựa trên ý 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. |
review_ |
Không bắt buộc. URI của trang đích của bài đánh giá. |
reviewer_ |
Không bắt buộc. URI đến hình ảnh của sản phẩm được đánh giá do tác giả bài đánh giá tạo. URI không nhất thiết phải kết thúc bằng đuôi tệp hình ảnh. |
product_ |
Không bắt buộc. Tên mô tả của một sản phẩm. |
product_ |
Không bắt buộc. URI của sản phẩm. URI này có thể có cùng giá trị với phần tử |
asins[] |
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[] |
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[] |
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[] |
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. Mã này thường khớp với Mã mặt hàng của sản phẩm trong nguồn cấp dữ liệu sản phẩm. |
brands[] |
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. |
collection_ |
Không bắt buộc. Phương thức dùng để thu thập bài đánh giá. |
transaction_ |
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. |
aggregator_ |
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 trang web tổng 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 việc sử dụng một trình tổng hợp và chứa thông tin về trình tổng hợp đó. |
subclient_ |
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. Thư mục 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 tệp. |
publisher_ |
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. |
publisher_ |
Không bắt buộc. Đường liên kết đến biểu tượng trang chủ của 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 chủ: 16x16 pixel. Hình ảnh phải ở định dạng GIF, JPG hoặc PNG. |
reviewer_ |
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. |
reviewer_ |
Không bắt buộc. Đặt thành true nếu người đánh giá muốn ẩn danh. |
reviewer_ |
Không bắt buộc. Tên của người đánh giá bài đánh giá sản phẩm. |
review_ |
Không bắt buộc. Ngôn ngữ của bài đánh giá được xác định theo mã ngôn ngữ BCP-47. |
review_ |
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 |
Không bắt buộc. Tiêu đề của bài đánh giá. |
content |
Bắt buộc. Nội dung của bài đánh giá. |
min_ |
Không bắt buộc. Chứa điểm xếp hạng liên kết với bài đánh giá. Số điểm xếp hạng tối thiểu có thể có. Đâ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. |
max_ |
Không bắt buộc. Số điểm xếp hạng tối đa có thể. Giá trị của thuộc tính điểm xếp hạng tối đa phải lớn hơn giá trị của thuộc tính điểm xếp hạng tối thiểu. |
rating |
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. |
is_ |
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. |
CollectionMethod
Phương thức dùng để thu thập bài đánh giá.
Enum | |
---|---|
COLLECTION_METHOD_UNSPECIFIED |
Phương thức thu thập chưa được chỉ định. |
UNSOLICITED |
Người dùng không phản hồi một yêu cầu cụ thể khi gửi bài đánh giá. |
POST_FULFILLMENT |
Người dùng gửi bài đánh giá để đáp lại một yêu cầu sau khi đơn đặt hàng của họ được thực hiện. |
ReviewLink
URI của trang đích của bài đánh giá.
Trường | |
---|---|
type |
Không bắt buộc. Loại URI đánh giá. |
link |
Không bắt buộc. URI của trang đích của bài đánh giá. Ví dụ: |
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 bài đánh giá chứa một nhóm bài đánh giá, trong đó có bài đánh giá này. |
ProductReviewStatus
Trạng thái xem xét sản phẩm.
Trường | |
---|---|
destination_ |
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. |
item_ |
Chỉ có đầu ra. Danh sách tất cả vấn đề liên quan đến bài đánh giá sản phẩm. |
create_ |
Chỉ có đầu ra. Ngày tạo mặt hàng, ở định dạng ISO 8601. |
last_ |
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 của trạng thái bài đánh giá sản phẩm.
Trường | |
---|---|
reporting_ |
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.
Trường | |
---|---|
code |
Chỉ có đầu ra. Mã lỗi của vấn đề. |
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 |
Chỉ có đầu ra. Liệu người bán có thể giải quyết vấn đề hay không. |
attribute |
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. |
reporting_ |
Chỉ có đầu ra. Bối cảnh báo cáo mà vấn đề áp dụng. |
description |
Chỉ có đầu ra. Nội dung mô tả ngắn gọn về vấn đề bằng tiếng Anh. |
detail |
Chỉ có đầu ra. Nội dung mô tả chi tiết về vấn đề bằng tiếng Anh. |
documentation |
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à một 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. |