مراجعة البائعين الذين يستخدمون Merchant API

تساعد مراجعات البائعين المستخدمين في العثور على الأنشطة التجارية التي تترك انطباعًا جيدًا لدى العملاء، ما يعزز ثقة المستخدمين في هذه الأنشطة ويساعدهم في اتخاذ قرارات شراء مدروسة. نتيجةً لذلك، يمكن أن تساعد تقييمات المتاجر المؤسسات في تحسين أداء الإعلانات والبيانات المجانية وجذب المزيد من العملاء المؤهَّلين إلى الصفحات المقصودة.

توضّح هذه الصفحة كيفية إدارة مراجعات البائعين باستخدام Merchant API.

المتطلبات الأساسية

تحتاج Google إلى تقديم معلومات محدّدة. يجب توفّر ما يلي:

  • مصدر بيانات نشط لمراجعات التجّار في Google Merchant Center
  • يجب أن يكون حسابك مسجّلاً في برنامج تقييمات المتاجر. إذا لم تكن متأكدًا مما إذا كنت مسجّلاً في البرنامج، يمكنك التحقّق من Merchant Center. إذا لم تكن مسجّلاً، أرسِل نموذج الطلب.

إنشاء مصدر بيانات

استخدِم طريقة accounts.dataSources.create لإنشاء مصدر بيانات لمراجعات التجّار. إذا كان هناك مصدر بيانات حالي لمراجعات التجّار، استخدِم accounts.dataSources.list لجلب الحقل accounts.dataSources.name.

للإشارة إليها مباشرةً في طلبات البيانات المستقبلية من واجهة برمجة التطبيقات، ننصحك بتخزين accounts.dataSources.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 data source", "merchantReviewDataSource":{} }

الردّ

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

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء مصدر بيانات لمراجعات المنتجات.

إنشاء مراجعة للتاجر

يمكنك استخدام طريقة accounts.merchantReviews.insert لإنشاء مراجعة بائع أو تعديلها. تتطلّب طريقة accounts.merchantReviews.insert إدخال مورد merchantreview واسم مصدر بيانات. وتعرض المراجعة الجديدة أو المعدَّلة للتاجر في حال نجاح العملية. يتطلّب إنشاء مراجعة للتاجر accounts.dataSources.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 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);
  }
}

عرض مراجعات التجار

يمكنك استخدام طريقة 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/*}

حالة مراجعة التاجر

يحتوي مورد مراجعات التجّار على الحالة المشابهة لواجهات برمجة التطبيقات الأخرى، وهو جزء لا يتجزأ من المورد ويتّبع بنية المشكلة والوجهة نفسها.