REST Resource: accounts.merchantReviews

Recurso: MerchantReview

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

Representación JSON 
{
  "name": string,
  "merchantReviewId": string,
  "attributes": {
    object (MerchantReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "merchantReviewStatus": {
    object (MerchantReviewStatus)
  }
}
Campos
name

string

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

string

Obligatorio. El usuario proporcionó el ID de opinión del comercio para identificar de forma exclusiva la opinión.
attributes

object (MerchantReviewAttributes)

Opcional. Es una lista de atributos de opiniones sobre comercios.
customAttributes[]

object (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 puede configurar 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.
dataSource

string

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

object (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

Representación JSON 
{
  "merchantId": string,
  "merchantDisplayName": string,
  "merchantLink": string,
  "merchantRatingLink": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "title": string,
  "content": string,
  "reviewerId": string,
  "reviewerUsername": string,
  "isAnonymous": boolean,
  "collectionMethod": enum (CollectionMethod),
  "reviewTime": string,
  "reviewLanguage": string,
  "reviewCountry": string
}
Campos
merchantId

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.
merchantDisplayName

string

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

string (int64 format)

Opcional. 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.
maxRating

string (int64 format)

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

number

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 las respuestas, con el contexto mínimo para que las respuestas tengan sentido. No se debe proporcionar contexto si las preguntas no se respondieron.
reviewerId

string

Opcional. Es un identificador único permanente del autor de la opinión en el sistema del editor.
reviewerUsername

string

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

boolean

Opcional. Se establece como verdadero si el revisor debe permanecer anónimo.
collectionMethod

enum (CollectionMethod)

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

string (Timestamp format)

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

string

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

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 utilizado para recopilar la opinión.

Enumeraciones
COLLECTION_METHOD_UNSPECIFIED No se especificó el método de recopilación.
MERCHANT_UNSOLICITED El usuario no estaba respondiendo a una solicitud específica cuando envió la opinión.
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 del usuario.

MerchantReviewStatus

El estado de la opinión de un comercio, los problemas de validación de datos, es decir, la información sobre la opinión de un comercio que se calculó de forma asíncrona.

Representación JSON 
{
  "destinationStatuses": [
    {
      object (MerchantReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (MerchantReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
Campos
destinationStatuses[]

object (MerchantReviewDestinationStatus)

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

object (MerchantReviewItemLevelIssue)

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

string (Timestamp format)

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

string (Timestamp format)

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.

Representación JSON 
{
  "reportingContext": enum (ReportingContextEnum)
}
Campos
reportingContext

enum (ReportingContextEnum)

Solo salida. Es el nombre del contexto de informes.

MerchantReviewItemLevelIssue

El ItemLevelIssue del estado de revisión del comercio.

Representación JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string
}
Campos
code

string

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

enum (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.
reportingContext

enum (ReportingContextEnum)

Solo salida. El contexto de la denuncia 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 opinión del comercio.
DISAPPROVED El problema rechaza la opinión sobre el comercio.

Métodos

delete

 Borra la opinión sobre el comercio.

get

 Obtiene una opinión sobre el comercio.

insert

 Inserta una opinión para su cuenta de Merchant Center.

list

 Muestra una lista de opiniones sobre comercios.