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 von Händlerbewertungen die Leistung von Anzeigen und organischen Einträgen verbessern sowie qualifiziertere Kunden auf ihre Landingpages leiten.

Auf dieser Seite wird erläutert, wie Sie Rezensionen von Verkäufern mit der Merchant API verwalten können.

Vorbereitung

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

• Eine aktive Datenquelle für Händlerrezensionen im Google Merchant Center.
• Ihr Konto muss für das Programm für Store-Bewertungen registriert sein. Wenn Sie nicht sicher sind, ob Sie bereits registriert sind, sehen Sie im Merchant Center nach. Wenn Sie nicht registriert sind, reichen Sie das Anfrageformular ein.

Hinweis :Eine Datenquelle für Händlerrezensionen ist nicht mit einer Datenquelle für Rezensionen zu verwechseln.

Datenquelle erstellen

Verwenden Sie die Methode accounts.dataSources.create, um einen Feed mit Händlerrezensionen zu erstellen. Wenn ein vorhandener Feed mit Händlerrezensionen verfügbar ist, verwenden Sie accounts.dataSources.get, um das Feld dataSource.name abzurufen.

Die Anfrage hat folgendes Format:

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

Beispiel

Das Beispiel zeigt eine typische Anfrage und Antwort.

Anfrage

POST https://merchantapi.googleapis.com/datasources/v1beta/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 Übersicht über die Merchant Data Sources API.

Händlerbewertung erstellen

Sie können die Methode accounts.merchantReviews.insert verwenden, um eine Verkäuferrezension zu erstellen oder zu aktualisieren. Die Methode accounts.merchantReviews.insert nimmt eine merchantreview-Ressource und den Namen einer Datenquelle als Eingabe an. Bei Erfolg wird die neue oder aktualisierte Händlerbewertung zurückgegeben. Für die Erstellung einer Händlerrezension ist datasource.name erforderlich.

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

Das Formular der Anfrage:

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

Sehen Sie sich die folgende Beispielrezension für einen Händler an.

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

Nach dem Erstellen einer Händlerrezension kann es einige Minuten dauern, bis die Rezension übernommen wird.

Händlerrezensionen ansehen

Verwenden Sie accounts.merchantReviews.get, um eine Händlerrezension aufzurufen. Dieser Bereich ist schreibgeschützt. Sie benötigen Ihre merchantId und die ID der Händlerüberprüfung als Teil des Namensfelds. Die Methode „get“ gibt die entsprechende Ressource für Händlerrezensionen zurück.

Beispiel:

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

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

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

Händlerrezensionen auflisten

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

GET https://merchantapi.googleapis.com/reviews/v1beta/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 Feld „name“ der Händlerrezension erforderlich, das bei der Erstellung zurückgegeben wurde.

Beispiel:

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

Status der Händlerrezension

Die Ressourcen für Händlerrezensionen enthalten einen Status, der ähnlich wie bei anderen APIs ein wesentlicher Bestandteil der Ressource ist und derselben Struktur für Probleme und Ziele folgt.