REST Resource: accounts.productReviews

Recurso: ProductReview

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

Representación JSON 
{
  "name": string,
  "productReviewId": string,
  "attributes": {
    object (ProductReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "productReviewStatus": {
    object (ProductReviewStatus)
  }
}
Campos
name

string

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

string

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

object (ProductReviewAttributes)

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

object (CustomAttribute)

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

string

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

object (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 que se calcula de forma asíncrona

ProductReviewAttributes

Atributos

Representación JSON 
{
  "reviewTime": string,
  "pros": [
    string
  ],
  "cons": [
    string
  ],
  "reviewLink": {
    object (ReviewLink)
  },
  "reviewerImageLinks": [
    string
  ],
  "productNames": [
    string
  ],
  "productLinks": [
    string
  ],
  "asins": [
    string
  ],
  "gtins": [
    string
  ],
  "mpns": [
    string
  ],
  "skus": [
    string
  ],
  "brands": [
    string
  ],
  "collectionMethod": enum (CollectionMethod),
  "transactionId": string,
  "aggregatorName": string,
  "subclientName": string,
  "publisherName": string,
  "publisherFavicon": string,
  "reviewerId": string,
  "reviewerIsAnonymous": boolean,
  "reviewerUsername": string,
  "reviewLanguage": string,
  "reviewCountry": string,
  "title": string,
  "content": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "isSpam": boolean
}
Campos
reviewTime

string (Timestamp format)

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 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.
productNames[]

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 (números de artículo comerciales globales) 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 los nombres de marcas asociados con un producto.
collectionMethod

enum (CollectionMethod)

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

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

string

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

Los publicadores pueden usar un agregador de opiniones para administrarlas y proporcionar los feeds. Este elemento indica el uso de un agregador y contiene información sobre este.
subclientName

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

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

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

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

boolean

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

string

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

string

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

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
minRating

string (int64 format)

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 ninguna calificación.
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 del atributo min.
rating

number

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

boolean

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

Tipo

Tipo de URI de la opinión.

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

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 estaba respondiendo a una solicitud específica cuando envió la opinión.
POST_FULFILLMENT El usuario envió la opinión en respuesta a una solicitud después de que se completó el pedido.

ProductReviewStatus

Estado de la revisión del producto

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

object (ProductReviewDestinationStatus)

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

object (ProductReviewItemLevelIssue)

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

string (Timestamp format)

Solo salida. Es la fecha en la que se creó el elemento. Debe mostrarse 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.

ProductReviewDestinationStatus

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

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

enum (ReportingContextEnum)

Solo salida. Es el nombre del contexto del informe.

ProductReviewItemLevelIssue

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

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

Métodos

delete

 Borra una opinión sobre un producto.

get

 Obtiene una opinión sobre el producto.

insert

 Inserta una opinión sobre un producto.

list

 Muestra las opiniones sobre productos.