Halaman ini diterjemahkan oleh Cloud Translation API.

Meninjau penjual menggunakan Merchant API

Ulasan penjual membantu orang menemukan bisnis yang menawarkan pengalaman pelanggan berkualitas tinggi, sehingga membantu membangun kepercayaan dan memungkinkan keputusan pembelian yang lebih tepat. Hasilnya, rating toko dapat membantu bisnis meningkatkan performa iklan dan listingan organik serta mendorong lebih banyak pelanggan yang berkualitas ke halaman landing mereka.

Halaman ini menjelaskan cara mengelola ulasan penjual menggunakan Merchant API.

Prasyarat

Google memerlukan Anda untuk memberikan informasi spesifik. Anda harus memiliki hal berikut:

Sumber data ulasan penjual yang aktif di Google Merchant Center.
Akun Anda harus terdaftar dalam program rating toko. Jika Anda tidak yakin apakah Anda sudah terdaftar, periksa Merchant Center. Jika Anda belum terdaftar, kirimkan formulir permintaan.

Membuat sumber data

Gunakan metode accounts.dataSources.create untuk membuat feed ulasan penjual. Jika feed ulasan penjual yang ada tersedia, gunakan accounts.dataSources.get untuk mengambil kolom dataSource.name.

Bentuk permintaannya adalah sebagai berikut:

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

Contoh

Contoh ini menunjukkan permintaan dan respons umum.

Permintaan

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

Respons

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

Untuk mengetahui informasi selengkapnya, lihat Membuat sumber data ulasan produk.

Membuat ulasan penjual

Anda dapat menggunakan metode accounts.merchantReviews.insert untuk membuat atau memperbarui ulasan penjual. Metode accounts.merchantReviews.insert mengambil resource merchantreview dan nama sumber data sebagai input. Ini menampilkan ulasan penjual baru atau yang diperbarui, jika berhasil. Membuat ulasan penjual memerlukan datasource.name.

Bentuk permintaan:

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

Pelajari contoh ulasan penjual berikut sebagai referensi.

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

Setelah pembuatan ulasan penjual, mungkin perlu waktu beberapa menit agar ulasan tersebut diterapkan.

Melihat ulasan penjual

Untuk melihat ulasan penjual, gunakan accounts.merchantReviews.get. Ini bersifat hanya baca. Metode ini memerlukan merchantId dan ID ulasan penjual sebagai bagian dari kolom nama. Metode get menampilkan resource ulasan penjual yang sesuai.

Contoh:

GET https://merchantapi.googleapis.com/reviews/v1alpha/{name=accounts/*/merchantReviews/*}

Untuk mengambil satu produk untuk akun Merchant Center tertentu, Anda dapat menggunakan metode google.shopping.merchant.accounts.v1.GetProductRequest, seperti yang ditunjukkan dalam contoh berikut.

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

Mencantumkan ulasan penjual

Anda dapat menggunakan metode accounts.merchantReviews.list untuk melihat semua ulasan penjual yang dibuat.

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

Menghapus ulasan penjual

Untuk menghapus ulasan penjual, gunakan accounts.merchantReviews.delete. Mirip dengan metode accounts.merchantReviews.get, metode ini memerlukan kolom nama ulasan penjual yang ditampilkan selama pembuatan.