Mithilfe von Verkäuferbewertungen können Nutzer Unternehmen mit besonders hochwertiger Kundenzufriedenheit finden. Das steigert das Vertrauen und ermöglicht fundiertere Kaufentscheidungen. So können Unternehmen anhand von Shopbewertungen 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 mithilfe der Merchant API verwalten können.
Vorbereitung
Google benötigt bestimmte Informationen von Ihnen. Folgende Voraussetzungen müssen erfüllt sein:
- Eine aktive Datenquelle für Händlerrezensionen im Google Merchant Center.
- Ihr Konto muss für das Händlerbewertungsprogramm registriert sein. Wenn Sie sich nicht sicher sind, ob Sie bereits registriert sind, sehen Sie im Merchant Center nach. Wenn Sie nicht registriert sind, reichen Sie das Anfrageformular ein.
Datenquelle erstellen
Verwenden Sie die Methode accounts.dataSources.create, um eine Datenquelle für Händlerrezensionen zu erstellen. Wenn eine vorhandene Datenquelle für Händlerrezensionen verfügbar ist, rufen Sie das Feld accounts.dataSources.name mit accounts.dataSources.list ab.
Wenn Sie in zukünftigen API-Aufrufen direkt auf sie verweisen möchten, empfehlen wir, die accounts.dataSources.name für die von Ihnen erstellten Datenquellen in Ihrer lokalen Datenbank für die Händlerüberprüfung zu speichern. Führen Sie für Ihre vorhandenen Datenquellen einen einmaligen Backfill Ihrer lokalen Datenbank mit deren Namen durch.
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.
Ersuchen
POST https://merchantapi.googleapis.com/datasources/v1/accounts/123/dataSources {"displayName": "test api data source", "merchantReviewDataSource":{} }
Antwort
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api data source",
"merchantReviewDataSource": {},
"input": "API"
}
Weitere Informationen finden Sie unter Datenquelle für Rezensionen erstellen.
Händlerrezension erstellen
Mit der Methode accounts.merchantReviews.insert 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ändlerrezension zurückgegeben. Zum Erstellen einer Händlerrezension ist accounts.dataSources.name erforderlich.
Die Form der Anfrage:
POST https://merchantapi.googleapis.com/reviews/v1alpha/{parent=accounts/*/}merchantReviews:insert
Sehen Sie sich 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 angezeigt wird.
Händlerrezensionen ansehen
Verwenden Sie accounts.merchantReviews.get, um eine Händlerrezension aufzurufen.
Diese ist schreibgeschützt. Sie müssen Ihre merchantId und die ID der Händlerrezension im Feld „Name“ angeben. Die GET-Methode gibt die entsprechende Ressource für die Händlerrezension 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.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 Product 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();
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);
return response;
}
}
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~GB~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);
}
}
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 Händlerrezension erforderlich, das bei der Erstellung zurückgegeben wurde.
Beispiel:
DELETE https://merchantapi.googleapis.com/reviews/v1alpha/{name=accounts/*/merchantReviews/*}
Status der Händlerrezensionen
Die Ressource für Händlerrezensionen enthält den Status ähnlich wie andere APIs. Er ist ein integraler Bestandteil der Ressource und folgt derselben Problem- und Zielstruktur.