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 sur le marchand à l'aide de l'API Merchant.
Prérequis
Vous devez fournir des informations spécifiques à Google. Vous devez disposer des éléments suivants :
- Une source de données d'avis sur le marchand active dans Google Merchant Center.
- Votre compte doit être inscrit au programme des notes de magasin. 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
accounts.dataSources.create
pour créer un flux d'avis sur le marchand. Si un flux d'avis sur le marchand
existe déjà, utilisez
accounts.dataSources.get
pour récupérer le champ dataSource.name.
La requête se présente comme suit :
POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Exemple
L'exemple montre une requête et une réponse typiques.
Demande
POST https://merchantapi.googleapis.com/datasources/v1/accounts/123/dataSources {"displayName": "test api feed", "merchantReviewDataSource":{} }
Réponse
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api feed",
"merchantReviewDataSource": {},
"input": "API"
}
Pour en savoir plus, consultez Créer une source de données d'avis sur les produits.
Créer un avis sur le marchand
Vous pouvez utiliser la
accounts.merchantReviews.insert
méthode pour créer ou mettre à jour un avis sur le marchand. La méthode accounts.merchantReviews.insert prend en entrée une ressource merchantreview et un nom de source de données. Si l'opération réussit, elle renvoie l'avis sur le marchand nouveau ou mis à jour. Pour créer un avis sur le marchand, vous devez disposer de datasource.name.
La requête se présente comme suit :
POST https://merchantapi.googleapis.com/reviews/v1alpha/{parent=accounts/*/}merchantReviews:insert
Consultez l'exemple d'avis sur le marchand suivant pour référence.
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'
}
Une fois l'avis sur le marchand créé, sa propagation peut prendre quelques minutes.
Afficher les avis sur le marchand
Pour afficher un avis sur le marchand, utilisez
accounts.merchantReviews.get.
Il est en lecture seule. Il nécessite votre merchantId et l'ID de l'avis sur le marchand dans le champ "name". La méthode "get" renvoie la ressource d'avis sur le marchand correspondante.
Exemple :
GET https://merchantapi.googleapis.com/reviews/v1alpha/{name=accounts/*/merchantReviews/*}
Pour récupérer un seul produit pour un compte Merchant Center donné, vous pouvez utiliser
la
google.shopping.merchant.accounts.v1.GetProductRequest
méthode, comme illustré dans l'exemple suivant.
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);
}
}
Lister les avis sur le marchand
Vous pouvez utiliser la
accounts.merchantReviews.list
méthode pour afficher tous les avis sur le marchand créés.
GET https://merchantapi.googleapis.com/reviews/v1alpha/accounts/{ACCOUNT_ID}/merchantReviews
Supprimer les avis sur le marchand
Pour supprimer un avis sur le marchand, utilisez
accounts.merchantReviews.delete.
Comme la méthode accounts.merchantReviews.get, cette méthode nécessite le champ "name" de l'avis sur le marchand renvoyé lors de la création.
Exemple :
DELETE https://merchantapi.googleapis.com/reviews/v1alpha/{name=accounts/*/merchantReviews/*}
État de l'avis sur le marchand
La ressource d'avis sur le marchand contient l'état, comme les autres API. Il s'agit d'une partie intégrale de la ressource qui suit la même structure de problème et de destination.