Se usó la API de Cloud Translation para traducir esta página.

Opinar sobre los vendedores con la API de Merchant Center

Las opiniones sobre el vendedor ayudan a las personas a encontrar empresas que ofrecen experiencias de alta calidad a los clientes, lo que genera confianza y permite tomar decisiones de compra más fundamentadas. Como resultado, las calificaciones de la tienda pueden ayudar a las empresas a mejorar el rendimiento de los anuncios y de las fichas orgánicas, y dirigir a más clientes calificados a sus páginas de destino.

En esta página, se explica cómo puedes administrar las opiniones sobre el vendedor con la API de Merchant.

Requisitos previos

Google necesita que proporciones información específica. Debes tener lo siguiente:

Una fuente de datos de opiniones sobre comercios activa en Google Merchant Center
Tu cuenta debe estar inscrita en el programa de calificaciones de la tienda. Si no sabes con certeza si ya te inscribiste, consulta Merchant Center. Si no te inscribiste, envía el formulario de solicitud.

Cómo crear una fuente de datos

Usa el método accounts.dataSources.create para crear un feed de opiniones sobre comercios. Si hay un feed de opiniones de comercios existente disponible, usa accounts.dataSources.get para recuperar el campo dataSource.name.

La forma de la solicitud es la siguiente:

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

Ejemplo

En el ejemplo, se muestra una solicitud y una respuesta típicas.

Solicitud

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

Respuesta

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

Para obtener más información, consulta Cómo crear una fuente de datos de opiniones sobre productos.

Crea una opinión sobre el comercio

Puedes usar el método accounts.merchantReviews.insert para crear o actualizar una opinión sobre el vendedor. El método accounts.merchantReviews.insert toma un recurso merchantreview y un nombre de fuente de datos como entrada. Si la operación se realiza correctamente, devuelve la opinión del comercio nueva o actualizada. Para crear una opinión sobre el comercio, se requiere datasource.name.

Forma de la solicitud:

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

Estudia la siguiente opinión de comercio de muestra como referencia.

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

Después de crear la opinión sobre el comercio, es posible que esta tarde unos minutos en propagarse.

Cómo ver las opiniones sobre el comercio

Para ver una opinión sobre un comercio, usa accounts.merchantReviews.get. Este campo es de solo lectura. Requiere tu merchantId y el ID de la opinión sobre el comercio como parte del campo de nombre. El método get devuelve el recurso de revisión del comercio correspondiente.

Por ejemplo:

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

Para recuperar un solo producto de una cuenta de Merchant Center determinada, puedes usar el método google.shopping.merchant.accounts.v1.GetProductRequest, como se muestra en el siguiente ejemplo.

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

Enumera las opiniones sobre el comercio

Puedes usar el método accounts.merchantReviews.list para ver todas las opiniones sobre comercios creadas.

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

Borra opiniones sobre el comercio

Para borrar una opinión sobre el comercio, usa accounts.merchantReviews.delete. Al igual que el método accounts.merchantReviews.get, este método requiere el campo name de la opinión sobre el comercio que se devolvió durante la creación.