Verkäufer mit der Merchant API überprüfen

Verkäuferrezensionen helfen Nutzern, Unternehmen mit besonders hochwertigem Service zu 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 beschrieben, wie Sie Händlerrezensionen 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 Händlerbewertungen registriert sein. Wenn Sie sich nicht sicher sind, ob Sie bereits registriert sind, können Sie das im Merchant Center überprüfen. Wenn Sie nicht registriert sind, reichen Sie das Antragsformular ein.

Hinweis :Eine Datenquelle für Händlerrezensionen ist nicht dasselbe wie eine Datenquelle für Rezensionen.

Datenquelle erstellen

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

So sieht die Anfrage 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 sofort nach der Erstellung verfügbar. Sie müssen also nicht auf die Verarbeitung warten.

Händlerrezension erstellen

Sie können die Methode accounts.merchantReviews.insert verwenden, um eine Verkäuferrezension zu erstellen oder zu aktualisieren. Für die Methode accounts.merchantReviews.insert werden als Eingabe eine merchantreview-Ressource und ein Datenquellname verwendet. Bei Erfolg wird die neue oder aktualisierte Händlerrezension zurückgegeben. Zum Erstellen einer Händlerrezension ist datasource.name erforderlich.

Wichtig :Bei dieser Anfrage wird die gesamte Händlerrezensionsressource überschrieben. Die Anfrage muss daher alle Details enthalten, damit keine Informationen verloren gehen.

Die Form der Anfrage:

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

Sehen Sie sich zur Orientierung die folgende Beispielrezension 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'
  }

Nachdem Sie eine Händlerrezension erstellt haben, kann es einige Minuten dauern, bis sie übernommen wird.

Händlerrezensionen ansehen

Verwenden Sie accounts.merchantReviews.get, um eine Händlerrezension aufzurufen. Dies ist schreibgeschützt. Dazu sind Ihre merchantId und die ID der Händlerrezension im Namensfeld erforderlich. Die Methode „get“ gibt die entsprechende Händlerrezensionsressource 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 Methode google.shopping.merchant.accounts.v1.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.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

Händlerrezensionen auflisten

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

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

Händlerrezensionen löschen

Verwenden Sie accounts.merchantReviews.delete, um eine Händlerrezension zu löschen. Ähnlich wie bei der Methode accounts.merchantReviews.get ist für diese Methode das Feld „name“ der bei der Erstellung zurückgegebenen Händlerrezension erforderlich.

Beispiel:

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

Status von Händlerrezensionen

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