Package google.shopping.merchant.reviews.v1beta

Chỉ mục

MerchantReviewsService

Dịch vụ quản lý bài đánh giá của người bán.

DeleteMerchantReview

rpc DeleteMerchantReview(DeleteMerchantReviewRequest) returns (Empty)

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

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

GetMerchantReview

rpc GetMerchantReview(GetMerchantReviewRequest) returns (MerchantReview)

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

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

InsertMerchantReview

rpc InsertMerchantReview(InsertMerchantReviewRequest) returns (MerchantReview)

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.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

ListMerchantReviews

rpc ListMerchantReviews(ListMerchantReviewsRequest) returns (ListMerchantReviewsResponse)

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

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

ProductReviewsService

Dịch vụ quản lý bài đánh giá sản phẩm.

DeleteProductReview

rpc DeleteProductReview(DeleteProductReviewRequest) returns (Empty)

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

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

GetProductReview

rpc GetProductReview(GetProductReviewRequest) returns (ProductReview)

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

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

InsertProductReview

rpc InsertProductReview(InsertProductReviewRequest) returns (ProductReview)

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

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

ListProductReviews

rpc ListProductReviews(ListProductReviewsRequest) returns (ListProductReviewsResponse)

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

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

DeleteMerchantReviewRequest

Thông báo yêu cầu cho phương thức DeleteMerchantReview.

Trường
name

string

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

string

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

string

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

string

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

string

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_review

MerchantReview

Bắt buộc. Bài đánh giá người bán cần chèn.

data_source

string

Bắt buộc. Nguồn dữ liệu của định dạng merchantreview: accounts/{account}/dataSources/{datasource}.

InsertProductReviewRequest

Thông báo yêu cầu cho phương thức InsertProductReview.

Trường
parent

string

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_review

ProductReview

Bắt buộc. Bài đánh giá sản phẩm cần chèn.

data_source

string

Bắt buộc. Định dạng: accounts/{account}/dataSources/{datasource}.

ListMerchantReviewsRequest

Thông báo yêu cầu cho phương thức ListMerchantsReview.

Trường
parent

string

Bắt buộc. Tài khoản để đăng bài đánh giá người bán. Định dạng: accounts/{account}

page_size

int32

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_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListMerchantReviews trước đó. Cung cấp giá trị 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 ListMerchantReviews phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListMerchantReviewsResponse

Thông báo phản hồi cho phương thức ListMerchantsReview.

Trường
merchant_reviews[]

MerchantReview

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

next_page_token

string

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

string

Bắt buộc. Tài khoản để đăng bài đánh giá sản phẩm. Định dạng: accounts/{account}

page_size

int32

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_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListProductReviews trước đó. Cung cấp giá trị 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 ListProductReviews phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListProductReviewsResponse

thông báo phản hồi cho phương thức ListProductReviews.

Trường
product_reviews[]

ProductReview

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

next_page_token

string

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

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

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}}"

merchant_review_id

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

MerchantReviewAttributes

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

custom_attributes[]

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 (ví dụ: { "name": "size type", "value": "regular" }). Điều này hữu ích khi gửi các thuộc tính không được API hiển thị rõ ràng, 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.

data_source

string

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

merchant_review_status

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.

Trường
merchant_id

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.

merchant_display_name

string

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

min_rating

int64

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_rating

int64

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

double

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

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.

reviewer_id

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.

reviewer_username

string

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

is_anonymous

bool

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

collection_method

CollectionMethod

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

review_time

Timestamp

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

review_language

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.

review_country

string

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_statuses[]

MerchantReviewDestinationStatus

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

item_level_issues[]

MerchantReviewItemLevelIssue

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_time

Timestamp

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

last_update_time

Timestamp

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_context

ReportingContextEnum

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

string

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

severity

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.

reporting_context

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 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

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}}"

product_review_id

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

ProductReviewAttributes

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

custom_attributes[]

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).

data_source

string

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

product_review_status

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.

Trường
review_time

Timestamp

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 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[]

string

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.

product_names[]

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. 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[]

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.

collection_method

CollectionMethod

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

transaction_id

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.

aggregator_name

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 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_name

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. 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_name

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.

publisher_favicon

string

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_id

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.

reviewer_is_anonymous

bool

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

reviewer_username

string

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

review_language

string

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_country

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á.

min_rating

int64

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_rating

int64

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

double

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_spam

bool

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.

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_statuses[]

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.

item_level_issues[]

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.

create_time

Timestamp

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

last_update_time

Timestamp

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_context

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.

Trường
code

string

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

severity

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.

reporting_context

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 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.