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

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

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

پیش‌نیازها

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

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

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

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

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

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

مثال

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

درخواست

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

پاسخ

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

برای اطلاعات بیشتر، به ایجاد منبع داده بررسی محصول مراجعه کنید.

ایجاد نقد و بررسی فروشنده

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

فرم درخواست:

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

برای مرجع، نمونه نقد و بررسی فروشنده زیر را مطالعه کنید.

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

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

مشاهده نظرات فروشندگان

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

برای مثال:

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

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

جاوا


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

    // 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}
      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);
    } catch (Exception e) {
      System.out.println(e);
    }
  }

  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~US~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);
  }
}

فهرست نظرات فروشندگان

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

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

نظرات فروشندگان را حذف کنید

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

برای مثال:

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

وضعیت بررسی فروشنده

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