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 da loja ajudam as empresas a melhorar a performance dos anúncios e das listagens orgânicas e a atrair mais clientes qualificados para as páginas de destino.

Esta página explica como gerenciar as 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 do comerciante ativa no Google Merchant Center.
• Sua conta precisa estar inscrita no programa de classificações da loja. Se você não tiver certeza se já se inscreveu, verifique no Merchant Center. Se você não estiver matriculado, envie o formulário de solicitação.

Observação: uma fonte de dados de avaliações do comerciante não é a mesma que uma fonte de dados de avaliações de produtos.

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 estiver disponível, use accounts.dataSources.get para buscar o campo dataSource.name.

O formato da solicitação é o seguinte:

POST https://merchantapi.googleapis.com/datasources/v1beta/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/v1beta/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 Visão geral da API Merchant Data Sources.

Criar uma avaliação do 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 bem-sucedida. Para criar uma avaliação do comerciante, é necessário ter datasource.name.

Importante: essa solicitação substitui todo o recurso de avaliação do comerciante. Portanto, ela precisa incluir todos os detalhes para evitar a perda de informações.

O formato da solicitação:

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

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

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

Após a criação da avaliação do comerciante, pode levar alguns minutos para que ela seja propagada.

Conferir avaliações sobre o comerciante

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

Exemplo:

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

Para recuperar um único produto de uma determinada conta do Merchant Center, use o método google.shopping.merchant.accounts.v1beta.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.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);
  }
}
GetProductSample.java

Listar avaliações sobre comerciantes

Você pode usar o método accounts.merchantReviews.list para conferir todas as avaliações do comerciante criadas.

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

Excluir avaliações do comerciante

Para excluir uma avaliação do comerciante, use accounts.merchantReviews.delete. Semelhante ao método accounts.merchantReviews.get, esse método exige o campo de nome da avaliação do comerciante retornada durante a criação.

Exemplo:

DELETE https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}

Status da análise do comerciante

O recurso de análise do comerciante contém o status semelhante a outras APIs, que é parte integrante do recurso e segue a mesma estrutura de destino e problema.