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

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

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

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

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

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

ملاحظة: مصدر بيانات مراجعات التاجر ليس هو نفسه مصدر بيانات مراجعات المنتجات.

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

استخدِم طريقة 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 كما هو موضّح في المثال التالي.

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

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

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

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

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