Verkäufer mit der Merchant API überprüfen

Mithilfe von Verkäuferbewertungen können Nutzer Unternehmen mit besonders hochwertigem Service finden. Das steigert das Vertrauen und ermöglicht fundiertere Kaufentscheidungen. So können Unternehmen anhand solcher Bewertungen die Leistung von Anzeigen und organischen Einträgen verbessern sowie qualifiziertere Kunden auf ihre Landingpages leiten.

Auf dieser Seite wird erläutert, wie Sie Verkäuferbewertungen mit der Merchant API verwalten.

Vorbereitung

Google benötigt bestimmte Informationen von Ihnen. Sie benötigen Folgendes:

• Eine aktive Datenquelle für Händlerbewertungen im Google Merchant Center
• Ihr Konto muss für das Programm für Händlerbewertungen registriert sein. Wenn Sie nicht sicher sind, ob Sie bereits registriert sind, prüfen Sie das im Merchant Center. Wenn Sie nicht registriert sind, senden Sie das Antragsformular.

Hinweis: Eine Datenquelle für Händlerbewertungen ist nicht dasselbe wie eine Datenquelle für Produktrezensionen.

Datenquelle erstellen

Verwenden Sie die accounts.dataSources.create Methode, um einen Feed für Händlerbewertungen zu erstellen. Wenn bereits ein Feed für Händler bewertungen vorhanden ist, rufen Sie das dataSource.name Feld mit accounts.dataSources.get ab.

Die Anfrage sieht so aus:

POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}

Beispiel

Das Beispiel zeigt eine typische Anfrage und Antwort.

Anfrage

POST https://merchantapi.googleapis.com/datasources/v1/accounts/123/dataSources {"displayName": "test api feed", "merchantReviewDataSource":{} }

Antwort

{
  "name": "accounts/123/dataSources/1000000573361824",
  "dataSourceId": "1000000573361824",
  "displayName": "test api feed",
  "merchantReviewDataSource": {},
  "input": "API"
}

Weitere Informationen finden Sie unter Datenquelle für Produktrezensionen erstellen.

**Hinweis**: Die Datenquelle ist nach der Erstellung sofort verfügbar. Sie müssen also nicht auf die Verarbeitung warten.

Händlerbewertung erstellen

Mit der accounts.merchantReviews.insert Methode können Sie eine Verkäuferbewertung erstellen oder aktualisieren. Die Methode accounts.merchantReviews.insert verwendet eine merchantreview-Ressource und einen Datenquellennamen als Eingabe. Bei Erfolg wird die neue oder aktualisierte Händlerbewertung zurückgegeben. Zum Erstellen einer Händlerbewertung ist datasource.name erforderlich.

Wichtig:Mit dieser Anfrage wird die gesamte Ressource für Händlerbewertungen überschrieben. Die Anfrage muss daher alle Details enthalten, damit keine Informationen verloren gehen.

Die Anfrage sieht so aus:

POST https://merchantapi.googleapis.com/reviews/v1alpha/{parent=accounts/*/}merchantReviews:insert

Sehen Sie sich die folgende Beispiel-Händlerbewertung an.

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'
  }

Nach der Erstellung der Händlerbewertung kann es einige Minuten dauern, bis sie weitergegeben wird.

Händlerbewertungen ansehen

Verwenden Sie accounts.merchantReviews.get, um eine Händlerbewertung anzusehen. Diese ist schreibgeschützt. Sie benötigen Ihre merchantId und die ID der Händlerbewertung als Teil des Namensfelds. Die Methode „get“ gibt die entsprechende Ressource für Händlerbewertungen zurück.

Beispiel:

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

Wenn Sie ein einzelnes Produkt für ein bestimmtes Merchant Center-Konto abrufen möchten, können Sie die google.shopping.merchant.accounts.v1.GetProductRequest Methode verwenden, wie im folgenden Beispiel gezeigt.

Java

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

Händlerbewertungen auflisten

Mit der accounts.merchantReviews.list Methode können Sie alle erstellten Händlerbewertungen ansehen.

GET https://merchantapi.googleapis.com/reviews/v1alpha/accounts/{ACCOUNT_ID}/merchantReviews

Händlerbewertungen löschen

Verwenden Sie accounts.merchantReviews.delete, um eine Händlerbewertung zu löschen. Ähnlich wie bei der Methode accounts.merchantReviews.get ist für diese Methode das Namensfeld der Händlerbewertung erforderlich, die bei der Erstellung zurückgegeben wurde.

Beispiel:

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

Status der Händlerbewertung

Die Ressource für Händlerbewertungen enthält den Status ähnlich wie bei anderen APIs. Er ist ein integraler Bestandteil der Ressource und folgt derselben Struktur für Probleme und Ziele.