Trang này được dịch bởi Cloud Translation API.

Xem xét người bán bằng Merchant API

Bài đánh giá về người bán giúp mọi người tìm thấy những doanh nghiệp mang đến trải nghiệm chất lượng cao cho khách hàng, giúp tạo dựng niềm tin và nhờ đó khách hàng có thể đư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 các 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ó:

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ý tham gia chương trình phân loại trên cửa hàng. Nếu bạn không chắc chắn 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 cấp dữ liệu bài đánh giá của người bán. Nếu có nguồn cấp dữ liệu bài đánh giá của người bán hiện có, hãy sử dụng accounts.dataSources.get để tìm nạp trường dataSource.name.

Dạng của yêu cầu như sau:

POST https://merchantapi.googleapis.com/datasources/v1beta/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 thông thường.

Yêu cầu

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "merchantReviewDataSource":{} }

Đáp

{
  "name": "accounts/123/dataSources/1000000573361824",
  "dataSourceId": "1000000573361824",
  "displayName": "test api feed",
  "merchantReviewDataSource": {},
  "input": "API"
}

Để biết thêm thông tin, hãy xem bài viết Tổng quan về API nguồn dữ liệu người bán.

Tạo bài đánh giá 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á 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. Bạn cần có datasource.name để tạo bài đánh giá người bán.

Hình thức của yêu cầu:

POST https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/*/}merchantReviews:insert

Hãy tham khảo bài đánh giá mẫu sau đây về người bán để tham khảo.

POST https://merchantapi.googleapis.com/reviews/v1beta/accounts/{ACCOUNT_ID}/merchantReviews:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}

  merchantReviewId = 'my_own_review'
  attributes {
    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 thì bài đánh giá mới được truyền tải.

Xem bài đánh giá về người bán

Để xem bài đánh giá của người bán, hãy sử dụng accounts.merchantReviews.get. Thuộc tính này chỉ có thể đọc. Bạn cần cung cấp merchantId và mã nhận dạng của bài đánh giá người bán trong trường tên. Phương thức get trả về tài nguyên bài đánh giá của người bán tương ứng.

Ví dụ:

GET https://merchantapi.googleapis.com/reviews/v1beta/{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.v1beta.GetProductRequest như trong mẫu sau.

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.products.v1beta.GetProductRequest;
import com.google.shopping.merchant.products.v1beta.Product;
import com.google.shopping.merchant.products.v1beta.ProductsServiceClient;
import com.google.shopping.merchant.products.v1beta.ProductsServiceSettings;
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 {

  public static void getProduct(Config config, String product) 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}
      GetProductRequest request = GetProductRequest.newBuilder().setName(product).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();
    // 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 product = "accounts/{datasource}/products/{productId}";

    getProduct(config, product);
  }
}GetProductSample.java

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

Bạn có thể sử dụng phương thức accounts.merchantReviews.list để xem tất cả bài đánh giá của người bán đã tạo.

GET https://merchantapi.googleapis.com/reviews/v1beta/accounts/{ACCOUNT_ID}/merchantReviews

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

Để xoá bài đánh giá 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á người bán được trả về trong quá trình tạo.

Ví dụ:

DELETE https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}

Trạng thái xem xét người bán

Tài nguyên bài đánh giá người bán có trạng thái tương tự như các API khác. Đây là một 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.