Package google.shopping.merchant.reviews.v1beta

Índice

MerchantReviewsService

Servicio para administrar las opiniones de los comercios.

DeleteMerchantReview

rpc DeleteMerchantReview(DeleteMerchantReviewRequest) returns (Empty)

Borra la opinión sobre el comercio.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta OAuth 2.0 Overview.

GetMerchantReview

rpc GetMerchantReview(GetMerchantReviewRequest) returns (MerchantReview)

Obtiene una opinión sobre el comercio.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta OAuth 2.0 Overview.

InsertMerchantReview

rpc InsertMerchantReview(InsertMerchantReviewRequest) returns (MerchantReview)

Inserta una opinión para tu cuenta de Merchant Center. Si la opinión ya existe, se reemplazará por la instancia nueva.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta OAuth 2.0 Overview.

ListMerchantReviews

rpc ListMerchantReviews(ListMerchantReviewsRequest) returns (ListMerchantReviewsResponse)

Muestra las opiniones sobre el comercio.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta OAuth 2.0 Overview.

ProductReviewsService

Servicio para administrar las opiniones sobre productos.

DeleteProductReview

rpc DeleteProductReview(DeleteProductReviewRequest) returns (Empty)

Borra una opinión sobre un producto.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta OAuth 2.0 Overview.

GetProductReview

rpc GetProductReview(GetProductReviewRequest) returns (ProductReview)

Obtiene una opinión sobre el producto.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta OAuth 2.0 Overview.

InsertProductReview

rpc InsertProductReview(InsertProductReviewRequest) returns (ProductReview)

Inserta una opinión sobre el producto.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta OAuth 2.0 Overview.

ListProductReviews

rpc ListProductReviews(ListProductReviewsRequest) returns (ListProductReviewsResponse)

Muestra las opiniones sobre productos.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta OAuth 2.0 Overview.

DeleteMerchantReviewRequest

Mensaje de la solicitud para el método DeleteMerchantReview.

Campos
name

string

Obligatorio. Es el ID de la opinión sobre el comercio. Formato: accounts/{account}/merchantReviews/{merchantReview}

DeleteProductReviewRequest

Mensaje de la solicitud para el método DeleteProductReview.

Campos
name

string

Obligatorio. Es el ID de la opinión sobre el producto. Formato: accounts/{account}/productReviews/{productReview}

GetMerchantReviewRequest

Mensaje de la solicitud para el método GetMerchantReview.

Campos
name

string

Obligatorio. Es el ID de la opinión sobre el comercio. Formato: accounts/{account}/merchantReviews/{merchantReview}

GetProductReviewRequest

Mensaje de solicitud para el método GetProductReview.

Campos
name

string

Obligatorio. Es el ID de la opinión sobre el comercio. Formato: accounts/{account}/productReviews/{productReview}

InsertMerchantReviewRequest

Mensaje de la solicitud para el método InsertMerchantReview.

Campos
parent

string

Obligatorio. Es la cuenta en la que se insertará la opinión del comercio. Formato: accounts/{account}

merchant_review

MerchantReview

Obligatorio. Es la opinión sobre el comercio que se va a insertar.

data_source

string

Obligatorio. La fuente de datos del formato merchantreview: accounts/{account}/dataSources/{datasource}.

InsertProductReviewRequest

Mensaje de la solicitud para el método InsertProductReview.

Campos
parent

string

Obligatorio. Es la cuenta en la que se insertará la opinión sobre el producto. Formato: accounts/{account}

product_review

ProductReview

Obligatorio. Es la opinión sobre el producto que se insertará.

data_source

string

Obligatorio. Formato: accounts/{account}/dataSources/{datasource}.

ListMerchantReviewsRequest

Mensaje de la solicitud para el método ListMerchantsReview.

Campos
parent

string

Obligatorio. La cuenta para la que se mostrarán las opiniones sobre el comercio. Formato: accounts/{account}

page_size

int32

Opcional. Es la cantidad máxima de opiniones sobre comercios que se mostrarán. El servicio puede mostrar menos que este valor. El valor máximo es 1,000, y los valores superiores se convertirán a 1,000. Si no se especifica, se muestra la cantidad máxima de opiniones.

page_token

string

Opcional. Un token de página, recibido desde una llamada ListMerchantReviews anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a ListMerchantReviews deben coincidir con la llamada que proporcionó el token de la página.

ListMerchantReviewsResponse

Mensaje de respuesta para el método ListMerchantsReview.

Campos
merchant_reviews[]

MerchantReview

La opinión sobre el comercio

next_page_token

string

El token para recuperar los resultados de la página siguiente.

ListProductReviewsRequest

Mensaje de solicitud para el método ListProductReviews.

Campos
parent

string

Obligatorio. La cuenta para la que se mostrarán las opiniones sobre productos. Formato: accounts/{account}

page_size

int32

Opcional. Es la cantidad máxima de productos que se mostrarán. El servicio puede mostrar menos que este valor.

page_token

string

Opcional. Un token de página, recibido desde una llamada ListProductReviews anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a ListProductReviews deben coincidir con la llamada que proporcionó el token de la página.

ListProductReviewsResponse

Mensaje de respuesta para el método ListProductReviews.

Campos
product_reviews[]

ProductReview

La opinión sobre el producto.

next_page_token

string

Un token, que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

MerchantReview

Es una opinión sobre un comercio. Para obtener más información, consulta Introducción a los feeds de opiniones sobre comercios.

Campos
name

string

Identificador. Es el nombre de la opinión del comercio. Formato: "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"

merchant_review_id

string

Obligatorio. El usuario proporcionó el ID de opinión del comercio para identificarla de forma única.

attributes

MerchantReviewAttributes

Opcional. Es una lista de atributos de opiniones sobre comercios.

custom_attributes[]

CustomAttribute

Obligatorio. Es una lista de atributos personalizados (proporcionados por el comercio). También se puede usar para enviar cualquier atributo de la especificación de datos en su forma genérica (por ejemplo, { "name": "size type", "value": "regular" }). Esto es útil para enviar atributos que la API no expone de forma explícita, como los atributos experimentales. La cantidad máxima de caracteres permitida para cada atributo personalizado es de 10,240 (representa la suma de caracteres para el nombre y el valor). Se pueden establecer un máximo de 2,500 atributos personalizados por producto, con un tamaño total de 102.4 KB. Los guiones bajos en los nombres de atributos personalizados se reemplazan por espacios cuando se insertan.

data_source

string

Solo salida. Es la fuente de datos principal de la opinión sobre el comercio.

merchant_review_status

MerchantReviewStatus

Solo salida. El estado de una opinión sobre un comercio, los problemas de validación de datos, es decir, la información sobre una opinión sobre un comercio calculada de forma asíncrona

MerchantReviewAttributes

Atributos

Campos
merchant_id

string

Obligatorio. Debe ser único y estable en todas las solicitudes. En otras palabras, si una solicitud de hoy y otra de hace 90 días hacen referencia al mismo comercio, deben tener el mismo ID.

merchant_display_name

string

Opcional. Es el nombre visible legible por humanos del comercio.

min_rating

int64

Opcional. Es el número mínimo posible para la calificación. Esta debe ser la peor calificación posible y no debe ser un valor para no calificar.

max_rating

int64

Opcional. Es el número máximo posible para la calificación. El valor de la calificación máxima debe ser mayor que el valor de la calificación mínima.

rating

double

Opcional. Es la calificación general del comercio que hizo el usuario que escribió la opinión.

title

string

Opcional. Es el título de la opinión.

content

string

Obligatorio. Debe ser cualquier texto de formato libre que proporcione el usuario y no debe truncarse. Si se proporcionan varias respuestas a diferentes preguntas, se deben incluir todas, con el contexto mínimo para que las respuestas tengan sentido. No se debe proporcionar contexto si quedaron preguntas sin responder.

reviewer_id

string

Opcional. Es un identificador permanente y único para el autor de la opinión en el sistema del publicador.

reviewer_username

string

Opcional. Es el nombre visible del autor de la opinión.

is_anonymous

bool

Opcional. Establece este valor en verdadero si el revisor debe permanecer anónimo.

collection_method

CollectionMethod

Opcional. Es el método que se usó para recopilar la opinión.

review_time

Timestamp

Obligatorio. Es la marca de tiempo que indica cuándo se escribió la opinión.

review_language

string

Obligatorio. Es el idioma de la opinión definido por el código de idioma BCP-47.

review_country

string

Opcional. Es el país en el que el revisor realizó el pedido, definido por el código de país ISO 3166-1 alpha-2.

CollectionMethod

Es el método que se usó para recopilar la opinión.

Enumeraciones
COLLECTION_METHOD_UNSPECIFIED No se especificó el método de recopilación.
MERCHANT_UNSOLICITED El usuario no envió la opinión en respuesta a una solicitud específica.
POINT_OF_SALE El usuario envió la opinión en respuesta a una solicitud cuando realizó un pedido.
AFTER_FULFILLMENT El usuario envió la opinión en respuesta a una solicitud después de que se completó el pedido.

MerchantReviewStatus

El estado de una opinión sobre un comercio, los problemas de validación de datos, es decir, la información sobre una opinión sobre un comercio calculada de forma asíncrona

Campos
destination_statuses[]

MerchantReviewDestinationStatus

Solo salida. Los destinos previstos para la opinión sobre el comercio.

item_level_issues[]

MerchantReviewItemLevelIssue

Solo salida. Una lista de todos los problemas asociados con la opinión sobre el comercio

create_time

Timestamp

Solo salida. Es la fecha en la que se creó el elemento, en formato ISO 8601.

last_update_time

Timestamp

Solo salida. Es la fecha en la que se actualizó el artículo por última vez, en formato ISO 8601.

MerchantReviewDestinationStatus

Es el estado de destino del estado de las opiniones del comercio.

Campos
reporting_context

ReportingContextEnum

Solo salida. Es el nombre del contexto de informes.

MerchantReviewItemLevelIssue

El ItemLevelIssue del estado de revisión del comercio.

Campos
code

string

Solo salida. El código de error del problema.

severity

Severity

Solo salida. Cómo afecta este problema a la publicación de la opinión sobre el comercio

resolution

string

Solo salida. Si el comercio puede resolver el problema.

attribute

string

Solo salida. El nombre del atributo, si el problema se debe a un solo atributo.

reporting_context

ReportingContextEnum

Solo salida. Es el contexto de informes al que se aplica el problema.

description

string

Solo salida. Una breve descripción del problema en inglés.

detail

string

Solo salida. Una descripción detallada del problema en inglés.

documentation

string

Solo salida. La URL de una página web para ayudar a resolver este problema

Gravedad

Cómo afecta el problema a la publicación de la opinión sobre el comercio

Enumeraciones
SEVERITY_UNSPECIFIED No se especifica.
NOT_IMPACTED Este problema representa una advertencia y no tiene un efecto directo en la revisión del comercio.
DISAPPROVED El problema rechaza la opinión sobre el comercio.

ProductReview

Es una opinión sobre un producto. Para obtener más información, consulta Introducción a los feeds de opiniones sobre productos.

Campos
name

string

Identificador. Es el nombre de la opinión sobre el producto. Formato: "{productreview.name=accounts/{account}/productReviews/{productReview}}"

product_review_id

string

Obligatorio. Es el identificador permanente y único de la opinión sobre el producto en el sistema del publicador.

attributes

ProductReviewAttributes

Opcional. Es una lista de atributos de opiniones sobre productos.

custom_attributes[]

CustomAttribute

Opcional. Es una lista de atributos personalizados (proporcionados por el comercio).

data_source

string

Solo salida. Es la fuente de datos principal de la opinión sobre el producto.

product_review_status

ProductReviewStatus

Solo salida. El estado de una opinión sobre un producto, los problemas de validación de datos, es decir, la información sobre una opinión sobre un producto calculada de forma asíncrona

ProductReviewAttributes

Atributos

Campos
review_time

Timestamp

Obligatorio. Es la marca de tiempo que indica cuándo se escribió la opinión.

pros[]

string

Opcional. Contiene las ventajas según la opinión del revisor. Omite el texto estándar, como "pro:", a menos que lo haya escrito el revisor.

cons[]

string

Opcional. Contiene las desventajas según la opinión del revisor. Omite el texto estándar, como "con:", a menos que lo haya escrito el revisor.

product_names[]

string

Opcional. Es el nombre descriptivo de un producto.

asins[]

string

Opcional. Contiene los ASIN (números de identificación estándar de Amazon) asociados con un producto.

gtins[]

string

Opcional. Contiene los GTIN (códigos comerciales globales de artículo) asociados con un producto. Se admiten subtipos de GTIN (p.ej., UPC, EAN, ISBN y JAN).

mpns[]

string

Opcional. Contiene los MPN (números de pieza del fabricante) asociados con un producto.

skus[]

string

Opcional. Contiene los SKU (unidades de mantenimiento de inventario) asociados con un producto. A menudo, coincide con el ID de oferta del producto en el feed de productos.

brands[]

string

Opcional. Contiene nombres de marcas asociados con un producto.

collection_method

CollectionMethod

Opcional. Es el método que se usó para recopilar la opinión.

transaction_id

string

Opcional. Es un identificador permanente y único de la transacción asociada con la opinión en el sistema del publicador. Este ID se puede usar para indicar que varias opiniones están asociadas con la misma transacción.

aggregator_name

string

Opcional. Es el nombre del agregador de las opiniones sobre productos.

Un editor puede usar un agregador de opiniones para administrar las opiniones y proporcionar los feeds. Este elemento indica el uso de un agregador y contiene información sobre este.

subclient_name

string

Opcional. Es el nombre del subcliente de las opiniones sobre productos.

El subcliente es un identificador de la fuente de opiniones sobre productos. Debe ser equivalente al directorio proporcionado en la ruta de acceso de la fuente de datos del archivo.

publisher_name

string

Opcional. Es el nombre del publicador de las opiniones sobre productos.

La información sobre el publicador, que puede ser un minorista, un fabricante, una empresa de servicios de opiniones o cualquier entidad que publique opiniones sobre productos.

publisher_favicon

string

Opcional. Es un vínculo al favicon de la empresa del publicador. Las dimensiones de la imagen deben ser del tamaño de un favicon: 16 × 16 píxeles. El formato de la imagen debe ser GIF, JPG o PNG.

reviewer_id

string

Opcional. Es el autor de la opinión sobre el producto.

Es un identificador permanente y único para el autor de la opinión en el sistema del publicador.

reviewer_is_anonymous

bool

Opcional. Establece este valor en verdadero si el revisor debe permanecer anónimo.

reviewer_username

string

Opcional. Es el nombre del usuario que dejó la opinión sobre el producto.

review_language

string

Opcional. Es el idioma de la opinión definido por el código de idioma BCP-47.

review_country

string

Opcional. Es el país de la revisión definido por el código de país ISO 3166-1 alpha-2.

title

string

Opcional. Es el título de la opinión.

content

string

Obligatorio. El contenido de la opinión

min_rating

int64

Opcional. Contiene las calificaciones asociadas con la opinión. Es el número mínimo posible para la calificación. Esta debe ser la peor calificación posible y no debe ser un valor para no calificar.

max_rating

int64

Opcional. Es el número máximo posible para la calificación. El valor de la calificación máxima debe ser mayor que el valor del atributo mínimo.

rating

double

Opcional. Es la calificación general del producto que hizo el revisor.

is_spam

bool

Opcional. Indica si la opinión está marcada como spam en el sistema del publicador.

CollectionMethod

Es el método que se usó para recopilar la opinión.

Enumeraciones
COLLECTION_METHOD_UNSPECIFIED No se especificó el método de recopilación.
UNSOLICITED El usuario no envió la opinión en respuesta a una solicitud específica.
POST_FULFILLMENT El usuario envió la opinión en respuesta a una solicitud después de que se completó el pedido.

Tipo

Es el tipo de URI de la opinión.

Enumeraciones
TYPE_UNSPECIFIED Indica un tipo no especificado.
SINGLETON La página de opiniones solo contiene esta opinión.
GROUP La página de opiniones contiene un grupo de opiniones, incluida esta.

ProductReviewStatus

Estado de la revisión del producto

Campos
destination_statuses[]

ProductReviewDestinationStatus

Solo salida. Los destinos previstos para la opinión sobre el producto.

item_level_issues[]

ProductReviewItemLevelIssue

Solo salida. Una lista de todos los problemas asociados con la opinión sobre el producto.

create_time

Timestamp

Solo salida. Es la fecha en la que se creó el elemento, en formato ISO 8601.

last_update_time

Timestamp

Solo salida. Es la fecha en la que se actualizó el artículo por última vez, en formato ISO 8601.

ProductReviewDestinationStatus

Es el estado de destino del estado de revisión del producto.

Campos
reporting_context

ReportingContextEnum

Solo salida. Es el nombre del contexto de informes.

ProductReviewItemLevelIssue

El ItemLevelIssue del estado de la opinión sobre el producto.

Campos
code

string

Solo salida. El código de error del problema.

severity

Severity

Solo salida. Cómo afecta este problema a la publicación de la opinión sobre el producto

resolution

string

Solo salida. Si el comercio puede resolver el problema.

attribute

string

Solo salida. El nombre del atributo, si el problema se debe a un solo atributo.

reporting_context

ReportingContextEnum

Solo salida. Es el contexto de informes al que se aplica el problema.

description

string

Solo salida. Una breve descripción del problema en inglés.

detail

string

Solo salida. Una descripción detallada del problema en inglés.

documentation

string

Solo salida. La URL de una página web para ayudar a resolver este problema

Gravedad

Cómo afecta el problema a la publicación de la opinión sobre el producto

Enumeraciones
SEVERITY_UNSPECIFIED No se especifica.
NOT_IMPACTED Este problema representa una advertencia y no tiene un efecto directo en la opinión del producto.
DISAPPROVED El problema rechaza la opinión del producto.