Esta página foi traduzida pela API Cloud Translation.

Revisar vendedores usando a API Merchant

As avaliações do vendedor ajudam as pessoas a encontrar empresas que oferecem experiências de alta qualidade para os clientes, o que gera confiança e viabiliza decisões de compra mais fundamentadas. Por outro lado, as classificações podem ajudar as empresas a melhorar a performance dos anúncios e das listagens orgânicas e atrair clientes mais qualificados para as páginas de destino.

Nesta página, explicamos como gerenciar avaliações do vendedor usando a API Merchant.

Pré-requisitos

O Google precisa que você forneça informações específicas. Você precisa ter o seguinte:

Uma fonte de dados de avaliações de comerciantes ativa no Google Merchant Center.
Sua conta precisa estar inscrita no programa de avaliações da loja. Se você não tiver certeza se já está inscrito, verifique o Merchant Center. Se você não estiver inscrito, envie o formulário de solicitação.

Criar uma fonte de dados

Use o método accounts.dataSources.create para criar um feed de avaliações do comerciante. Se um feed de avaliações de comerciantes já existir, use accounts.dataSources.get para buscar o campo dataSource.name.

O formato da solicitação é o seguinte:

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

Exemplo

O exemplo mostra uma solicitação e uma resposta típicas.

Solicitação

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

Resposta

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

Para mais informações, consulte Criar uma fonte de dados de avaliações de produtos.

Criar avaliação sobre o comerciante

Use o método accounts.merchantReviews.insert para criar ou atualizar uma avaliação do vendedor. O método accounts.merchantReviews.insert usa um recurso merchantreview e um nome de fonte de dados como entrada. Ele retorna a avaliação do comerciante nova ou atualizada, se for bem-sucedida. Para criar uma avaliação do comerciante, é necessário ter datasource.name.

A forma da solicitação:

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

Estude o exemplo de avaliação de comerciante a seguir para referência.

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

Depois da criação da avaliação do comerciante, pode levar alguns minutos para que ela seja propagada.

Ver avaliações sobre o comerciante

Para conferir uma avaliação do comerciante, use accounts.merchantReviews.get. Ele é somente leitura. Ele exige seu merchantId e o ID da avaliação do comerciante como parte do campo "name". O método "get" retorna o recurso de avaliação do comerciante correspondente.

Exemplo:

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

Para recuperar um único produto de uma determinada conta do Merchant Center, use o método google.shopping.merchant.accounts.v1.GetProductRequest, conforme mostrado no exemplo a seguir.

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

Listar avaliações sobre o comerciante

Use o método accounts.merchantReviews.list para conferir todas as avaliações do comerciante criadas.

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

Excluir avaliações sobre o comerciante

Para excluir uma avaliação sobre o comerciante, use accounts.merchantReviews.delete. Assim como o método accounts.merchantReviews.get, esse método exige o campo "name" da avaliação do comerciante retornada durante a criação.