Les avis sur le marchand aident les utilisateurs à identifier des entreprises qui offrent une expérience client de grande qualité. Ils permettent de gagner la confiance des clients, qui peuvent prendre des décisions d'achat plus éclairées. Ces notes peuvent donc aider les entreprises à améliorer les performances de leurs annonces et de leurs fiches dans les résultats naturels, et à attirer plus de clients qualifiés sur leurs pages de destination.
Cette page explique comment gérer les avis des vendeurs à l'aide de l'API Merchant.
Prérequis
Vous devez nous fournir certaines informations. Vous devez disposer des éléments suivants:
- Une source de données d'avis de marchand active dans Google Merchant Center.
- Votre compte doit être inscrit au programme d'évaluation des magasins. Si vous ne savez pas si vous êtes déjà inscrit, consultez Merchant Center. Si ce n'est pas le cas, envoyez le formulaire de demande.
Créer une source de données
Utilisez la méthode accounts.dataSources.create pour créer un flux d'avis sur les marchands. Si un flux d'avis sur les marchands existant est disponible, utilisez accounts.dataSources.get pour extraire le champ dataSource.name.
La requête se présente comme suit:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID} /dataSources/{DATASOURCE_ID}
Exemple
L'exemple montre une requête et une réponse typiques.
Requête
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "merchantReviewDataSource":{} }
Response (Réponse)
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api feed",
"merchantReviewDataSource": {},
"input": "API"
}
Pour en savoir plus, consultez la page Présentation de l'API Sources de données Merchant Center.
Créer un avis sur un marchand
Vous pouvez utiliser la méthode accounts.merchantReviews.insert pour créer ou modifier un avis sur un vendeur. La méthode accounts.merchantReviews.insert utilise une ressource merchantreview et un nom de source de données en tant qu'entrée. Elle renvoie l'avis sur le marchand (nouveau ou modifié) si elle aboutit. Pour créer un avis sur un marchand, vous devez disposer de datasource.name.
Forme de la demande:
POST https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/*/}merchantReviews:insert
Consultez l'exemple d'avis sur un marchand ci-dessous pour référence.
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'
}
Après la création de l'avis du marchand, la propagation de l'avis peut prendre quelques minutes.
Afficher les avis sur le marchand
Pour afficher un avis sur un marchand, utilisez accounts.merchantReviews.get.
Ce champ est en lecture seule. Il nécessite votre merchantId et l'ID de l'avis sur le marchand dans le champ "nom". La méthode get renvoie la ressource d'avis sur le marchand correspondante.
Exemple :
GET https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}
Pour récupérer un seul produit pour un compte Merchant Center donné, vous pouvez utiliser la méthode google.shopping.merchant.accounts.v1beta.GetProductRequest, comme illustré dans l'exemple suivant.
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);
}
}
Afficher les avis sur le marchand
Vous pouvez utiliser la méthode accounts.merchantReviews.list pour afficher tous les avis sur les marchands créés.
GET https://merchantapi.googleapis.com/reviews/v1beta/accounts/{ACCOUNT_ID} /merchantReviews
Supprimer des avis sur un marchand
Pour supprimer un avis sur un marchand, utilisez accounts.merchantReviews.delete.
Comme la méthode accounts.merchantReviews.get, cette méthode nécessite le champ de nom de l'avis sur le marchand renvoyé lors de la création.
Exemple :
DELETE https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}
État de l'avis sur le marchand
La ressource d'avis sur le marchand contient un état semblable à celui des autres API, qui fait partie intégrante de la ressource et suit la même structure de problème et de destination.