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

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

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

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

تطلب منك Google تقديم معلومات محدّدة. يجب توفّر ما يلي:

• مصدر بيانات نشط لمراجعات التجار في Google Merchant Center
• يجب أن يكون حسابك مسجّلاً في برنامج تقييمات المتجر. إذا لم تكن متأكّدًا مما إذا سبق لك الاشتراك، يُرجى التحقّق من 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"
}

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على Merchant Data 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 المرجع المرتبط بمراجعة التاجر.

على سبيل المثال:

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

لاسترداد منتج واحد لحساب معيّن على Merchant Center، يمكنك استخدام طريقة google.shopping.merchant.accounts.v1beta.GetProductRequest ، كما هو موضّح في العيّنة التالية.

Java

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، تتطلّب هذه الطريقة عرض الحقل name لمراجعة التاجر أثناء الإنشاء.

على سبيل المثال:

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

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

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