Cette page a été traduite par l'API Cloud Translation.

Examiner les vendeurs qui utilisent l'API Merchant

Les avis sur le marchand aident les utilisateurs à identifier les 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 les marchands à l'aide de l'API Merchant.

Prérequis

Google a besoin que vous fournissiez des informations spécifiques. Vous devez disposer des éléments suivants :

Une source de données d'avis sur les marchands 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, remplissez 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 de marchand existant est disponible, 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.

Requête

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 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 prend en entrée une ressource merchantreview et un nom de source de données. 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/v1alpha/{parent=accounts/*/}merchantReviews:insert

Consultez l'exemple d'avis sur un marchand ci-dessous pour vous en inspirer.

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 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 du nom. 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 méthode google.shopping.merchant.accounts.v1.GetProductRequest, comme indiqué dans l'exemple suivant.

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

Lister 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/v1alpha/accounts/{ACCOUNT_ID}/merchantReviews

Supprimer des avis sur les marchands

Pour supprimer un avis sur un marchand, utilisez accounts.merchantReviews.delete. Comme la méthode accounts.merchantReviews.get, celle-ci nécessite le champ "name" de l'avis sur le marchand renvoyé lors de la création.