Questa pagina è stata tradotta dall'API Cloud Translation.

Recensisci i venditori utilizzando l'API Merchant

Le recensioni del venditore aiutano le persone a trovare attività che offrono customer experience di alta qualità, contribuendo a creare fiducia e consentendo di prendere decisioni di acquisto più consapevoli. Di conseguenza, le valutazioni negozio possono aiutare le attività a migliorare il rendimento degli annunci e delle schede organiche e indirizzare clienti più qualificati alle loro pagine di destinazione.

Questa pagina spiega come gestire le recensioni del venditore utilizzando l'API Merchant.

Prerequisiti

Google ha bisogno che tu fornisca informazioni specifiche. Devi disporre di quanto segue:

Un'origine dati delle recensioni del commerciante attiva in Google Merchant Center.
Il tuo account deve essere registrato al programma di valutazione dello store. Se non sai se hai già effettuato la registrazione, controlla Merchant Center. Se non hai effettuato la registrazione, invia il modulo di richiesta.

Creare un'origine dati

Utilizza il metodo accounts.dataSources.create per creare un feed delle recensioni dei commercianti. Se è disponibile un feed di recensioni del commerciante esistente, utilizza accounts.dataSources.get per recuperare il campo dataSource.name.

Il formato della richiesta è il seguente:

POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}

Esempio

L'esempio mostra una richiesta e una risposta tipiche.

Richiedi

POST https://merchantapi.googleapis.com/datasources/v1/accounts/123/dataSources {"displayName": "test api feed", "merchantReviewDataSource":{} }

Risposta

{
  "name": "accounts/123/dataSources/1000000573361824",
  "dataSourceId": "1000000573361824",
  "displayName": "test api feed",
  "merchantReviewDataSource": {},
  "input": "API"
}

Per saperne di più, consulta Creare un'origine dei dati delle recensioni di prodotto.

Crea recensione commerciante

Puoi utilizzare il metodo accounts.merchantReviews.insert per creare o aggiornare una recensione del venditore. Il metodo accounts.merchantReviews.insert accetta come input una risorsa merchantreview e un nome dell'origine dati. Restituisce la recensione del commerciante nuova o aggiornata, se l'operazione è andata a buon fine. Per creare una recensione del commerciante è necessario datasource.name.

La forma della richiesta:

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

Per riferimento, esamina la seguente recensione del commerciante di esempio.

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'
  }

Dopo la creazione della recensione del commerciante, potrebbero essere necessari alcuni minuti prima che la recensione venga propagata.

Visualizzare le recensioni del commerciante

Per visualizzare una recensione del commerciante, utilizza accounts.merchantReviews.get. Questo è di sola lettura. Richiede il tuo merchantId e l'ID della recensione del commerciante come parte del campo del nome. Il metodo get restituisce la risorsa recensione del commerciante corrispondente.

Ad esempio:

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

Per recuperare un singolo prodotto per un determinato account Merchant Center, puoi utilizzare il metodo google.shopping.merchant.accounts.v1.GetProductRequest, come mostrato nell'esempio seguente.

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

Elencare le recensioni commerciante

Puoi utilizzare il metodo accounts.merchantReviews.list per visualizzare tutte le recensioni dei commercianti create.

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

Eliminare le recensioni del commerciante

Per eliminare una recensione del commerciante, utilizza accounts.merchantReviews.delete. Analogamente al metodo accounts.merchantReviews.get, questo metodo richiede il campo del nome della recensione del commerciante restituita durante la creazione.