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

Yêu cầu có dạng như sau:

POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}

Ví dụ:

Ví dụ này minh hoạ 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 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ạo nguồn dữ liệu đá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 của người bán (nếu thành công). Bạn cần phải có datasource.name để tạo bài đánh giá người bán.

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

Để xem một bài đánh giá về người bán, hãy sử dụng accounts.merchantReviews.get. Đây là chế độ chỉ đọc. Bạn phải 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á 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ư minh hoạ trong mẫu sau.

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
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 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ả các bài đánh giá đã tạo về người bán.

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

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

Để xoá bài đánh giá người bán, hãy 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á 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à phần không thể thiếu của tài nguyên và tuân theo cấu trúc vấn đề và đích đến tương tự.