مراجعة البائعين الذين يستخدمون 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 ، كما هو موضّح في المثال التالي.

جافا

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);
  }
}
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/*}

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

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