Bài đánh giá của người bán giúp mọi người tìm thấy những doanh nghiệp cung cấp trải nghiệm chất lượng cao cho khách hàng, giúp xây dựng niềm tin và cho phép khách hàng đưa ra quyết định mua hàng sáng suốt hơn. Do đó, điểm xếp hạng của cửa hàng có thể giúp doanh nghiệp nâng cao hiệu suất của quảng cáo và trang thông tin tự nhiên, đồng thời thu hút thêm nhiều khách hàng đủ tiêu chuẩn truy cập vào trang đích.
Trang này giải thích cách bạn có thể quản lý bài đánh giá của người bán bằng Merchant API.
Điều kiện tiên quyết
Google cần bạn cung cấp thông tin cụ thể. Bạn phải có những điều sau:
- Một nguồn dữ liệu bài đánh giá của người bán đang hoạt động trong Google Merchant Center.
- Tài khoản của bạn phải được đăng ký vào chương trình điểm xếp hạng của cửa hàng. Nếu bạn không chắc mình đã đăng ký hay chưa, hãy kiểm tra Merchant Center. Nếu bạn chưa đăng ký, hãy gửi biểu mẫu yêu cầu.
Tạo một nguồn dữ liệu
Sử dụng phương thức
accounts.dataSources.create
để tạo nguồn dữ liệu bài đánh giá của người bán. Nếu có nguồn dữ liệu bài đánh giá của người bán hiện có, hãy sử dụng
accounts.dataSources.list
để tìm nạp trường
accounts.dataSources.name.
Để tham chiếu trực tiếp đến các nguồn dữ liệu này trong các lệnh gọi API sau này, bạn nên lưu trữ accounts.dataSources.name cho các nguồn dữ liệu mà bạn tạo trong cơ sở dữ liệu cục bộ của mình cho bài đánh giá của người bán. Đối với các nguồn dữ liệu hiện có, hãy thực hiện một lần điền lại cơ sở dữ liệu cục bộ bằng tên của các nguồn dữ liệu đó.
Biểu mẫu của yêu cầu như sau:
POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Ví dụ
Ví dụ này cho thấy một yêu cầu và phản hồi điển hình.
Yêu cầu
POST https://merchantapi.googleapis.com/datasources/v1/accounts/123/dataSources {"displayName": "test api data source", "merchantReviewDataSource":{} }
Đáp
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api data source",
"merchantReviewDataSource": {},
"input": "API"
}
Để biết thêm thông tin, hãy xem phần Tạo nguồn dữ liệu bài đánh giá sản phẩm.
Tạo bài đánh giá của người bán
Bạn có thể sử dụng phương thức
accounts.merchantReviews.insert
để tạo hoặc cập nhật bài đánh giá của người bán. Phương thức accounts.merchantReviews.insert lấy tài nguyên merchantreview và tên nguồn dữ liệu làm dữ liệu đầu vào. Phương thức này sẽ trả về bài đánh giá mới hoặc đã cập nhật của người bán (nếu thành công). Để tạo bài đánh giá của người bán, bạn cần có
accounts.dataSources.name.
Biểu mẫu của yêu cầu:
POST https://merchantapi.googleapis.com/reviews/v1alpha/{parent=accounts/*/}merchantReviews:insert
Hãy tham khảo mẫu bài đánh giá của người bán sau đây.
POST https://merchantapi.googleapis.com/reviews/v1alpha/accounts/{ACCOUNT_ID}/merchantReviews:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
merchantReviewId = 'my_own_review'
merchantReviewAttributes {
merchantId = 'merchant_id'
merchantDisplayName = 'merchant_display_name'
merchantLink = 'publisher_name'
merchantRatingLink = 'https://www.google.com'
minRating = 1
maxRating = 10
rating = 7.9
title = 'Amazing Merchant'
content = 'This is an incredible merchant'
reviewerId = 'reviewer_id'
reviewerUsername = 'reviewer_username'
isAnonymous = false
collectionMethod = 'AFTER_FULFILLMENT'
reviewTime = '2024-04-01T00:00:00Z'
reviewLanguage = 'en'
reviewCountry = 'US'
}
Sau khi bạn tạo bài đánh giá của người bán, có thể mất vài phút để bài đánh giá đó được truyền tải.
Xem bài đánh giá của người bán
Để xem bài đánh giá của người bán, hãy sử dụng
accounts.merchantReviews.get.
Đây là thông tin chỉ cho phép đọc. Bạn cần có merchantId và mã nhận dạng của bài đánh giá của người bán trong trường tên. Phương thức get sẽ trả về tài nguyên bài đánh giá tương ứng của người bán.
Ví dụ:
GET https://merchantapi.googleapis.com/reviews/v1alpha/{name=accounts/*/merchantReviews/*}
Để truy xuất một sản phẩm cho một tài khoản Merchant Center nhất định, bạn có thể sử dụng
phương thức
google.shopping.merchant.accounts.v1.GetProductRequest, như trong mẫu sau.
Java
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.common.io.BaseEncoding;
import com.google.shopping.merchant.products.v1.GetProductRequest;
import com.google.shopping.merchant.products.v1.Product;
import com.google.shopping.merchant.products.v1.ProductsServiceClient;
import com.google.shopping.merchant.products.v1.ProductsServiceSettings;
import java.nio.charset.StandardCharsets;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;
/** This class demonstrates how to get a single product for a given Merchant Center account */
public class GetProductSample {
// Base64Url encoder/decoder without padding
private static final BaseEncoding BASE64URL_NOPADDING = BaseEncoding.base64Url().omitPadding();
// Encodes a string to base64url without padding
public static String encodeProductId(String productId) {
return BASE64URL_NOPADDING.encode(productId.getBytes(StandardCharsets.UTF_8));
}
public static void getProduct(Config config, String accountId, String productId)
throws Exception {
// Obtains OAuth token based on the user's configuration.
GoogleCredentials credential = new Authenticator().authenticate();
// Creates service settings using the credentials retrieved above.
ProductsServiceSettings productsServiceSettings =
ProductsServiceSettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(credential))
.build();
// Calls the API and catches and prints any network failures/errors.
try (ProductsServiceClient productsServiceClient =
ProductsServiceClient.create(productsServiceSettings)) {
// The name has the format: accounts/{account}/products/{productId}
String name = "accounts/" + accountId + "/products/" + productId;
// The name has the format: accounts/{account}/products/{productId}
GetProductRequest request = GetProductRequest.newBuilder().setName(name).build();
System.out.println("Sending get product request:");
Product response = productsServiceClient.getProduct(request);
System.out.println("Retrieved Product below");
System.out.println(response);
} catch (Exception e) {
System.out.println(e);
}
}
public static void main(String[] args) throws Exception {
Config config = Config.load();
String accountId = config.getAccountId().toString();
// The name of the `product`, returned after a `Product.insert` request. We recommend
// having stored this value in your database to use for all future requests.
String productId = "en~US~sku123"; // Replace with your actual product ID
// Uncomment the following line if the product name contains special characters (such as forward
// slashes) and needs base64url encoding.
// productId = encodeProductId(productId);
getProduct(config, accountId, productId);
}
}
Liệt kê bài đánh giá của người bán
Bạn có thể sử dụng
accounts.merchantReviews.list
phương thức để xem tất cả bài đánh giá của người bán đã tạo.
GET https://merchantapi.googleapis.com/reviews/v1alpha/accounts/{ACCOUNT_ID}/merchantReviews
Xoá bài đánh giá của người bán
Để xoá bài đánh giá của người bán, hãy sử dụng
accounts.merchantReviews.delete.
Tương tự như phương thức accounts.merchantReviews.get, phương thức này yêu cầu trường tên của bài đánh giá của người bán được trả về trong quá trình tạo.
Ví dụ:
DELETE https://merchantapi.googleapis.com/reviews/v1alpha/{name=accounts/*/merchantReviews/*}
Trạng thái bài đánh giá của người bán
Tài nguyên bài đánh giá của người bán chứa trạng thái tương tự như các API khác, đây là phần không thể thiếu của tài nguyên và tuân theo cùng một cấu trúc vấn đề và đích đến.