בדיקת מוכרים באמצעות Merchant API

ביקורות על מוכרים עוזרות לאנשים למצוא עסקים שמציעים חוויית לקוח (CX) באיכות גבוהה. הן עוזרות לבנות אמון אצל הלקוחות ומאפשרות להם לקבל החלטות קנייה יותר מושכלות. כתוצאה מכך, דירוג של חנויות יכול לעזור לעסקים לשפר את הביצועים של מודעות ושל כרטיסי מוצר אורגניים ולמשוך יותר לקוחות מתאימים לדפי הנחיתה שלהם.

בדף הזה מוסבר איך לנהל ביקורות על מוכרים באמצעות 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/*}

סטטוס הביקורת על המוֹכר

משאב הביקורות על מוכרים מכיל את הסטטוס בדומה לממשקי API אחרים. הסטטוס הוא חלק בלתי נפרד מהמשאב, והוא מופיע באותה מבנה של בעיה ויעד.