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

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 thông tin sau:

  • Một nguồn dữ liệu bài đánh giá người bán đang hoạt động trong Google Merchant Center.
  • Tài khoản của bạn phải đăng ký tham gia chương trình điểm xếp hạng của cửa hàng. Nếu bạn không chắc chắn liệu 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á hiện có của người bán, 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 đó 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ộ để người bán xem xét. Đố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 tên của các nguồn dữ liệu đó vào cơ sở dữ liệu cục bộ.

Biểu mẫu 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 thông thường.

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 bài viết Tạo nguồn dữ liệu bài đánh giá sản phẩm.

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á 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 trả về bài đánh giá mới hoặc đã cập nhật về người bán, nếu thành công. Để tạo bài đánh giá người bán, bạn cần có accounts.dataSources.name.

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

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

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

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á người bán

Để xem bài đánh giá về 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 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á người bán tương ứng.

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 Product 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();

    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);
      return response;
    }
  }

  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~GB~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á 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á về người bán đã tạo.

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

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

Để xoá một bài đánh giá về 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/v1alpha/{name=accounts/*/merchantReviews/*}

Trạng thái bài đánh giá về 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.

Trước
Review products