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

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

בדף הזה נסביר איך לנהל ביקורות של מוכרים באמצעות Merchant API.

דרישות מוקדמות

Google זקוקה למידע ספציפי. נדרש:

• מקור נתונים פעיל של ביקורות על מוכרים ב-Google Merchant Center.
• החשבון שלכם צריך להיות רשום בתוכנית הדירוגים של החנויות. אם אתם לא בטוחים אם כבר נרשמתם, תוכלו לבדוק ב-Merchant Center. אם אתם לא רשומים, תוכלו לשלוח את טופס הבקשה.

הערה: מקור נתונים של ביקורות על מוכרים הוא לא אותו הדבר כמו מקור נתונים של ביקורות על מוצרים.

יצירת מקור נתונים

משתמשים ב-method‏ 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 sources API.

יצירת ביקורת על מוכר

אפשר להשתמש ב-method‏ 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 נתון, אפשר להשתמש ב-method‏ 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

הצגת רשימה של ביקורות על מוכרים

אפשר להשתמש ב-method‏ 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/*}

סטטוס הבדיקה של המוֹכר

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