Referencia del esquema XML

Libro: /product-review-feeds/_book.yaml

Título: Referencia del esquema XML

El esquema XML de los feeds de opiniones sobre productos de Google define la estructura aceptable de tu feed XML. Los esquemas XML usan la extensión de archivo .xsd. Al igual que los archivos DTD, un esquema XML define los elementos y atributos que pueden aparecer en un documento XML.

Puedes obtener más información sobre los esquemas XML en Esquema de esquemas XML.

El esquema XML de los feeds de opiniones sobre productos se publica aquí: http://www.google.com/shopping/reviews/schema/product/2.3/product_reviews.xsd

A continuación, se incluye una descripción de la estructura del feed definida en este esquema. En esta descripción, los nombres de tipo con el prefijo xs: se refieren a los tipos de esquema XML integrados que están en el espacio de nombres XML http://www.w3.org/2001/XMLSchema.

Nuestro sistema siempre espera un feed completo. Se borrarán todas las opiniones que se hayan enviado anteriormente, pero que no se hayan incluido en tu próximo feed completo. Por lo tanto, siempre debes enviar todas las opiniones cuando envíes el feed.

Elemento <feed> de nivel superior

El elemento <feed> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<version> Obligatorio (1) xs:string Indica qué versión del esquema de feed de opiniones sobre productos se usa. En este momento, solo se admite <version>2.3</version>.
<aggregator> Opcional (1) aggregatorType 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 el agregador.
<publisher> Obligatorio (1) publisherType La información sobre el publicador, que puede ser un minorista, un fabricante de opiniones, una empresa de servicios o cualquier entidad que publique opiniones sobre productos
<reviews> Opcional (1) xs:sequence Contiene las opiniones sobre el producto.

El <feed> define restricciones de unicidad en los elementos que se usan en el feed.

Elementos secundarios

<aggregator>

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 el agregador. El elemento <aggregator> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<name> Obligatorio (1) nonEmptyStringType Es el nombre del agregador de las opiniones sobre productos.

<publisher>

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.El elemento <publisher> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<name> Obligatorio (1) nonEmptyStringType Es el nombre del publicador de las opiniones sobre productos.
<favicon> Opcional (1) httpUrlType Un vínculo al ícono de página de la empresa del publicador Las dimensiones de la imagen deben ser de 16 x 16 píxeles. El formato de imagen debe ser GIF, JPG o PNG.

<reviews>

Contiene las opiniones sobre productos. El elemento <reviews> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<review> Obligatorio (1-unlimited) reviewType Una opinión única sobre cada producto. Si una opinión pertenece a varios productos del inventario del editor, especifica la opinión una vez e incluye varios elementos <product> en el elemento <products>.

<review>

Una opinión única sobre cada producto. Si una opinión pertenece a varios productos del inventario del editor, especifica la opinión una vez y, luego, incluye varios elementos <product> en el elemento <products>.El elemento <review> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<review_id> Opcional (1) nonEmptyStringType Es el identificador único y permanente de la opinión del producto en el sistema del publicador.
<reviewer> Obligatorio (1) reviewerType Corresponde al autor de la opinión sobre el producto.
<review_timestamp> Obligatorio (1) xs:dateTime

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

Ejemplos:

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> Opcional (1) nonEmptyStringType Es el título de la opinión.
<content> Obligatorio (1) nonEmptyStringType El contenido de la opinión.
<pros> Opcional (1) xs:sequence Contiene los profesionales según la opinión del revisor. Omite texto estándar como &prot;pro:" a menos que lo haya escrito el revisor.
<cons> Opcional (1) xs:sequence Contiene las desventajas basadas en la opinión del revisor. Omite el texto estándar, como &cont;con:" a menos que lo haya escrito el revisor.
<reviewer_images> Opcional (1) xs:sequence Contiene vínculos a imágenes del producto que proporcionó el revisor.
<review_url> Obligatorio (1) reviewUrlType La URL de la página de destino de la opinión.
<ratings> Obligatorio (1) xs:sequence Contiene las calificaciones asociadas con la opinión.
<products> Obligatorio (1) xs:sequence Contiene los productos asociados con la opinión.
<is_spam> Opcional (1) xs:boolean Indica si la opinión está marcada como spam en el sistema del editor.
<collection_method> Opcional (1) collectionMethodType

Es el método que se usa para recopilar la opinión. El valor debe ser uno de los siguientes:

unsolicited
El usuario no respondió 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 cumpliera el pedido del usuario.
<transaction_id> Opcional (1) nonEmptyStringType Un identificador único y permanente para la transacción asociada con la revisión en el sistema del editor. Este ID se puede usar para indicar que varias opiniones están asociadas con la misma transacción.

<reviewer>

Corresponde al autor de la opinión sobre el producto. El elemento <reviewer> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<name> Obligatorio (1) reviewerNameType

Es el nombre del autor de la opinión.

Ejemplo:

<name>Jane</name>
<reviewer_id> Opcional (1) nonEmptyStringType

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

Ejemplo:

<reviewer_id>14295</reviewer_id>

<name>

Es el nombre del autor de la opinión. El elemento <name> es una extensión de nonEmptyStringType y contiene el nombre o alias del revisor. El elemento <name> contiene estos atributos.

Atributo Caso Tipo Descripción
is_anonymous Opcional xs:boolean

Indica si el usuario que deja la opinión es anónimo.

Ejemplo:

<name is_anonymous="true">Anonymous</name>

<pros>

Contiene los profesionales según la opinión del revisor. El elemento <pros> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<pro> Obligatorio (1-unlimited) nonEmptyStringType

Un profesional individual basado en la opinión del revisor. Los profesionales deben aparecer en el mismo orden en el que se muestran. Omite texto estándar como &prot;pro:" a menos que lo haya escrito el revisor.

Ejemplo:

<pros>
  <pro>Sleek design</pro>
</pros>

<cons>

Contiene las desventajas basadas en la opinión del revisor. El elemento <cons> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<con> Obligatorio (1-unlimited) nonEmptyStringType

Una persona física estafador basada en la opinión del revisor. Las desventajas deben aparecer en el mismo orden en el que se muestran. Omite el texto estándar, como &cont;con:" a menos que lo haya escrito el revisor.

Ejemplo:

<cons>
  <con>Pricey</con>
</cons>

<review_url>

La URL de la página de destino de la opinión. El elemento <review_url> es una extensión de httpUrlType y contiene el vínculo a la página de destino de la opinión. El elemento <review_url> contiene estos atributos.

Atributo Caso Tipo Descripción
type Obligatorio xs:string

El tipo debe ser uno de los siguientes:

singleton
La página de revisión contiene esta única opinión.
group
La página de opiniones contiene un grupo de opiniones, incluida esta.

Ejemplo:

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

Contiene imágenes del producto que proporcionó el revisor. La etiqueta <reviewer_images> contiene muchos elementos <reviewer_image>.

Elemento Caso Tipo Descripción
<reviewer_image> Obligatorio (1-unlimited) reviewImageType

Corresponde a una imagen del producto sobre el que creó el autor de la opinión.

<reviewer_image>

Un elemento de imagen de opinión único.

Elemento Caso Tipo Descripción
<url> Obligatorio (1) httpUrlType

Una URL a una imagen del producto sobre el que creó el autor de la opinión. No es necesario que la URL termine con una extensión de archivo de imagen.

Ejemplo:

<reviewer_images>
  <reviewer_image>
    <url>https://example.com/test.jpg</url>
  </reviewer_image>
  <reviewer_image>
    <url>https://example.com/test.gif</url>
  </reviewer_image>
</reviewer_images>

<ratings>

Contiene las calificaciones asociadas con la opinión. El elemento <ratings> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<overall> Obligatorio (1) ratingType La calificación general del usuario que dejó la opinión.

<overall>

La calificación general del usuario que dejó la opinión. El elemento <overall> extiende una xs:decimal simpleType y captura la calificación que asignó el usuario que deja la opinión. El valor debe estar dentro del rango inclusivo definido por los atributos min y max. El elemento <overall> contiene estos atributos.

Atributo Caso Tipo Descripción
min Obligatorio xs:integer El número mínimo posible para la calificación. Esta debe ser la peor calificación posible y no debe ser un valor si no hay calificación.
max Obligatorio xs:integer La cantidad máxima posible para la calificación. El valor del atributo max debe ser mayor que el del atributo min.

<products>

Contiene los productos asociados con la opinión. El elemento <products> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<product> Obligatorio (1-unlimited) productType Es un producto asociado con la opinión.

<product>

Es un producto asociado con la opinión. El elemento <product> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<product_ids> Opcional (1) productIdsType Los identificadores asociados con un producto.
<product_name> Opcional (1) nonEmptyStringType Nombre descriptivo de un producto.
<product_url> Obligatorio (1) httpUrlType La URL del producto. Esta URL puede tener el mismo valor que el elemento <review_url> si la URL de revisión y la URL de producto son iguales.

<product_ids>

Los identificadores asociados con un producto. El elemento <product_ids> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<gtins> Obligatorio (para todas las opiniones asociadas con productos con un GTIN conocido a fin de habilitar la coincidencia con las opiniones completas)

Opcional (muy recomendado) para todas las demás opiniones (1)		 gtinsType Contiene los GTIN (códigos comerciales globales de artículos) asociados a un producto.
<mpns> Obligatorio (el MPN se debe incluir para facilitar la coincidencia de opiniones si el producto asociado con la opinión no tiene un GTIN asignado. Se debe enviar con la marca.

Opcional para todas las demás opiniones (1)		 mpnsType Contiene MPN (números de pieza del fabricante) asociados a un producto.
<skus> Es obligatorio (el SKU debe incluirse para facilitar la coincidencia de opiniones si el producto asociado con la opinión no tiene asignado un GTIN o MPN). Se debe enviar con la marca.

Opcional para todas las demás opiniones (1)		 skusType Contiene los SKU (unidades de mantenimiento de existencias) asociados a un producto. A menudo, coincide con el ID de oferta del producto que aparece en el feed de productos.
<brands> Obligatorio (se debe incluir la marca para facilitar la coincidencia de opiniones si el producto asociado con la opinión no tiene un GTIN asignado). Se debe enviar con el MPN

Opcional para todas las opiniones (1)		 brandsType Contiene nombres de marcas asociados con un producto.
<asins> Opcional (1) asinsType Contiene los ASIN (números de identificación estándar de Amazon) asociados a un producto.

<gtins>

Contiene los GTIN (códigos comerciales globales de artículos) asociados a un producto. El elemento <gtins> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<gtin> Obligatorio (1-unlimited) nonEmptyStringType Es el número de artículo comercial global del producto.

<mpns>

Contiene MPN (números de pieza del fabricante) asociados a un producto. El elemento <mpns> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<mpn> Obligatorio (1-unlimited) nonEmptyStringType Es el número de pieza del fabricante del producto.

<skus>

Contiene los SKU (unidades de mantenimiento de existencias) asociados a un producto. El elemento <skus> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<sku> Obligatorio (1-unlimited) nonEmptyStringType La unidad de mantenimiento de existencias del producto en el inventario del editor.

<brands>

Contiene nombres de marcas asociados con un producto. El elemento <brands> contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<brand> Obligatorio (1-unlimited) nonEmptyStringType Es el nombre de la marca del producto.

<asins>

Contiene los ASIN (números de identificación estándar de Amazon) asociados a un producto. El elemento contiene estos elementos en el orden indicado.

Elemento Caso Tipo Descripción
<asin> Obligatorio (1-unlimited) nonEmptyStringType El número de identificación estándar del Amazonas. Cada ASIN tiene 10 caracteres de longitud y caracteres alfanuméricos.