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 de los vendedores 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 de comercios activa en Google Merchant Center
- Tu cuenta debe estar inscrita en el programa de calificaciones de tiendas. Si no estás seguro de si ya te inscribiste, consulta Merchant Center. Si no estás matriculado, 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.
El formato de la solicitud es el siguiente:
POST https://merchantapi.googleapis.com/datasources/v1beta/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/v1beta/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 la descripción general de la API de Merchant Data Sources.
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. Devuelve la opinión del comercio nueva o actualizada, si se realiza correctamente. Para crear una opinión sobre un comercio, se requiere datasource.name.
El formato de la solicitud:
POST https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/*/}merchantReviews:insert
Consulta el siguiente ejemplo de opinión sobre un comercio como referencia.
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'
}
Después de crear la opinión sobre el comercio, es posible que esta tarde unos minutos en propagarse.
Ver opiniones sobre el comercio
Para ver una opinión sobre un comercio, usa accounts.merchantReviews.get.
Esta opción es de solo lectura. Requiere tu merchantId y el ID de la opinión del comercio como parte del campo de nombre. El método get muestra el recurso de opinión del comercio correspondiente.
Por ejemplo:
GET https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}
Para recuperar un solo producto de una cuenta de Merchant Center determinada, puedes usar el método google.shopping.merchant.accounts.v1beta.GetProductRequest, como se muestra en el siguiente ejemplo.
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);
}
}
Cómo ver las opiniones sobre el comercio
Puedes usar el método accounts.merchantReviews.list para ver todas las opiniones de comercios creadas.
GET https://merchantapi.googleapis.com/reviews/v1beta/accounts/{ACCOUNT_ID} /merchantReviews
Borra opiniones sobre comercios
Para borrar una opinión sobre un comercio, usa accounts.merchantReviews.delete.
Al igual que el método accounts.merchantReviews.get, este método requiere que se muestre el campo de nombre de la opinión del comercio durante la creación.
Por ejemplo:
DELETE https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}
Estado de la revisión del comercio
El recurso de opiniones sobre comercios contiene un estado similar al de otras APIs, que es la parte integral del recurso y sigue la misma estructura de problemas y destinos.