فروشندگان را با استفاده از Merchant API بررسی کنید

بررسی‌های فروشنده به افراد کمک می‌کند کسب‌وکارهایی را پیدا کنند که تجربیات مشتری باکیفیت را ارائه می‌دهند، به ایجاد اعتماد و امکان تصمیم‌گیری آگاهانه‌تر خرید کمک می‌کنند. در نتیجه، رتبه‌بندی فروشگاه‌ها می‌تواند به کسب‌وکارها کمک کند تا عملکرد تبلیغات و فهرست‌های ارگانیک را بهبود بخشند و مشتریان واجد شرایط بیشتری را به صفحات فرود خود سوق دهند.

این صفحه توضیح می دهد که چگونه می توانید نظرات فروشنده را با استفاده از Merchant API مدیریت کنید.

پیش نیازها

گوگل به شما نیاز دارد که اطلاعات خاصی را ارائه دهید. شما باید موارد زیر را داشته باشید:

• منبع داده بازنگری فعال در Google Merchant Center.
• حساب شما باید در برنامه رتبه بندی فروشگاه ثبت شود. اگر مطمئن نیستید که قبلا ثبت نام کرده اید، مرکز تجاری را بررسی کنید. اگر ثبت نام نکرده اید، فرم درخواست را ارسال کنید.

توجه: منبع داده بازبینی تجاری با منبع داده بررسی محصول یکسان نیست.

یک منبع داده ایجاد کنید

از روش accounts.dataSources.create برای ایجاد فید نظرات بازرگان استفاده کنید. اگر فید بررسی‌های تجاری موجود در دسترس است، از accounts.dataSources.get برای واکشی فیلد dataSource.name استفاده کنید.

فرم درخواست به شرح زیر است:

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

مثال

مثال یک درخواست و پاسخ معمولی را نشان می دهد.

درخواست کنید

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

پاسخ

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

برای اطلاعات بیشتر، مروری بر API منابع داده تجاری را ببینید.

ایجاد بررسی تجاری

می‌توانید از روش accounts.merchantReviews.insert برای ایجاد یا به‌روزرسانی نظر فروشنده استفاده کنید. روش accounts.merchantReviews.insert یک منبع merchantreview و نام منبع داده را به عنوان ورودی می گیرد. در صورت موفقیت آمیز بودن، بازبینی تجاری جدید یا به روز شده را برمی گرداند. ایجاد یک بررسی تجاری به datasource.name نیاز دارد.

مهم: این درخواست کل منبع بازبینی تاجر را بازنویسی می‌کند، بنابراین درخواست باید شامل تمام جزئیات باشد تا اطلاعات از دست نرود.

فرم درخواست:

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

نمونه بررسی بازرگان زیر را برای مرجع مطالعه کنید.

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

پس از ایجاد نظر تجاری، ممکن است چند دقیقه طول بکشد تا بازبینی منتشر شود.

مشاهده نظرات بازرگانان

برای مشاهده نظر تجاری، از accounts.merchantReviews.get استفاده کنید. این فقط خواندنی است. به merchantId شما و شناسه بازبینی تاجر به عنوان بخشی از قسمت نام نیاز دارد. متد دریافت منبع بررسی بازرگان مربوطه را برمی گرداند.

به عنوان مثال:

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

برای بازیابی یک محصول واحد برای یک حساب Merchant Center معین، می‌توانید از روش google.shopping.merchant.accounts.v1beta.GetProductRequest استفاده کنید، همانطور که در نمونه زیر نشان داده شده است.

جاوا

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

نظرات بازرگان را فهرست کنید

می‌توانید از روش accounts.merchantReviews.list برای مشاهده همه نظرات تجاری ایجاد شده استفاده کنید.

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

نظرات بازرگان را حذف کنید

برای حذف نظر تجاری، از accounts.merchantReviews.delete استفاده کنید. مشابه روش accounts.merchantReviews.get ، این روش مستلزم فیلد نام بررسی تجاری است که در حین ایجاد بازگردانده شده است.

به عنوان مثال:

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

وضعیت بررسی تاجر

منبع بررسی بازرگان دارای وضعیتی مشابه سایر APIها است که بخش جدایی ناپذیر منبع است و از ساختار موضوع و مقصد مشابهی پیروی می کند.