Se usó la API de Cloud Translation para traducir esta página.

Esquema XML

En esta sección, se deriva el esquema XML utilizado para el feed de datos de la opinión del comerciante.

Elemento de nivel superior: `<feed>`

Descripción

Elemento superior del contenedor que contiene todos los demás elementos del feed.

Atributos

Nombre	Formato	Occurrences	Descripción
`xmlns`	xs:string	Obligatorio (1)	Codifica el siguiente valor: `http://schemas.google.com/merchant_reviews/5.0`
`xmlns:xsi`	xs:string	Obligatorio (1)	Codifica el siguiente valor: `http://www.w3.org/2001/XMLSchema-instance`
`xsi:schemaLocation`	xs:string	Obligatorio (1)	Codifique el siguiente valor y deje un solo espacio en blanco entre URL: `http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd`

Ejemplo

<feed xmlns="http://schemas.google.com/merchant_reviews/5.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://schemas.google.com/merchant_reviews/5.0 https://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd">

Contiene

Nombre	Formato	Occurrences	Descripción
`merchants`	--	Opcional (0‐1)	Elemento de contenedor para `<merchant>` elementos.
`deleted_merchants`	--	Opcional (0‐1)	Elemento de contenedor para `<deleted_merchant>` elementos.
`reviews`	--	Opcional (0‐1)	Elemento de contenedor para `<review>` elementos.
`deleted_reviews`	--	Opcional (0‐1)	Elemento de contenedor para `<deleted_review>` elementos.

`<merchants>`

Descripción

Contenedor para elementos <merchant>

Contiene

Nombre	Formato	Occurrences	Descripción
`merchant`	--	Obligatorio (1-n)	Elemento repetido para cada comercio.

`<merchant>`

Descripción

Cada elemento <merchant> contiene información y opiniones sobre un comercio.

Atributos

Nombre	Formato	Occurrences	Descripción
`id`	ID	Obligatorio (1)	Debe ser único y estable en todos los feeds. En otras palabras, si un feed de hoy y otro de hace 90 días hacen referencia al mismo comercio, deben tener el mismo ID.

Ejemplo

<merchant id="2739">

Contiene

Incluye los siguientes elementos en el elemento del comercio.

Nombre	Formato	Occurrences	Descripción
`name`	NonEmptyString.	Obligatorio (1)	Es el nombre visible del comercio.
`merchant_url`	xs:cualquierURI	Obligatorio (1)	URL del sitio web principal del comerciante No uses una URL de redireccionamiento para este valor. En otras palabras, el valor debe apuntar directamente al sitio del comerciante. Ejemplo: <merchant_url> http://store.google.com </merchant_url>
`rating_url`	xs:cualquierURI	Obligatorio (1)	URL a la página de destino que aloja las opiniones de este comerciante. No uses una URL de redireccionamiento. Ejemplo: <rating_url> http://merchant_url.com/reviews/ </rating_url>
`create_timestamp`	Fecha y hora	Obligatorio (1)	Es la fecha y hora en que se creó el comercio. Esto nunca debería cambiar.
`last_update_timestamp`	Fecha y hora	Obligatorio (1)	Es la fecha y hora en que se actualizó el comercio por última vez. Si alguno de los campos del elemento `<merchant>` se actualiza para un ID de comercio determinado, este valor también debe cambiar.

`<deleted_merchants>`

Descripción

Contenedor para comerciantes que se borró.

Contiene

Nombre	Formato	Occurrences	Descripción
`deleted_merchant`	--	Obligatorio (1-n)	Contiene elementos relacionados con un solo comercio borrado.

`<deleted_merchant>`

Descripción

Comerciante que se eliminó.

Atributos

Nombre	Formato	Occurrences	Descripción
`id`	ID	Obligatorio (1)	Especifica el ID de un comerciante que se debe eliminar del feed. El ID debe coincidir con el atributo `id` de un elemento `<merchant>` en cualquier archivo de feed anterior.

Contiene

Nombre Formato Occurrences Descripción

Nombre	Formato	Occurrences	Descripción
`last_update_timestamp`	Fecha y hora	Obligatorio (1)	Es la fecha y hora en la que se quitó a un comercio del sistema. Ejemplo: <last_update_timestamp> 2016-04-03T18:37:32Z </last_update_timestamp>

last_update_timestamp

Fecha y hora

Obligatorio (1)

Es la fecha y hora en la que se quitó a un comercio del sistema.

Ejemplo:

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>

Ejemplo

<deleted_merchant id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z</last_update_timestamp>
</deleted_merchant>

`<reviews>`

Descripción

Contenedor para elementos <review>

Contiene

Nombre	Formato	Occurrences	Descripción
`review`	--	Obligatorio (1-n)	Elemento repetido para cada opinión.

`<review>`

Descripción

Contenedor para los detalles relacionados con una opinión.

Atributos

Nombre Formato Occurrences Descripción

Nombre	Formato	Occurrences	Descripción
`id`	ID	Obligatorio (1)	Es el identificador de una opinión en tu sistema. Debe ser único y estable en todos los feeds. Ejemplo: <review id=132739 mid=1234>
`mid`	ID	Obligatorio (1)	Es el identificador del comerciante al que se orienta esta opinión.

id

Obligatorio (1)

Es el identificador de una opinión en tu sistema. Debe ser único y estable en todos los feeds.

Ejemplo:

<review id=132739 mid=1234>

mid ID Obligatorio (1) Es el identificador del comerciante al que se orienta esta opinión.

Contiene

Incluye los siguientes elementos en el elemento de revisión.

Nombre	Formato	Occurrences	Descripción
`reviewer_name`	NonEmptyString.	Opcional (0‐1)	Nombre visible del autor de la opinión, siempre que esta tenga un autor con nombre. Las opiniones anónimas no deben incluir este campo. Ejemplo: <reviewer_name> Joel </reviewer_name>
`create_timestamp`	Fecha y hora	Obligatorio (1)	Es la fecha y hora en que el usuario envió la opinión. Esto nunca debería cambiar. Ejemplo: <create_timestamp> 2016-04-03T18:37:32Z </create_timestamp>
`last_update_timestamp`	Fecha y hora	Obligatorio (1)	Fecha y hora en que se modificó por última vez la información del elemento `<review>` Si alguno de los campos del elemento `<review>` se actualiza para un ID de revisión determinado, este valor también debe cambiar. Ejemplo: <last_update_timestamp> 2016-04-03T18:37:32Z </last_update_timestamp>
`country_code`	CountryCode	Obligatorio (1)	País del revisor. Si está disponible, indica el país al que se envió el producto o el lugar donde se procesó el servicio. De lo contrario, usa el país en el que se encuentra el usuario que dejó la opinión al momento de crearla. El código de país debe estar en formato ISO 3166-1 alpha-2. Ejemplo: <country_code> US </country_code>
`title`	xs:string	Opcional (0‐1)	Es el título de la opinión. El título debe ser texto sin formato, sin ninguna etiqueta HTML. Ejemplo: <title> Great prices </title>
`content`	xs:string	Obligatorio (1)	El contenido de la opinión. Debe ser cualquier texto de formato libre proporcionado por el usuario y no debe truncarse. El contenido debe ser texto sin formato, sin ninguna etiqueta HTML. Por ejemplo, un salto de línea debe estar representado por un carácter de salto de línea y no por una etiqueta <br>. 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 las preguntas no se responden. Ejemplo: <content> I like this store! My order arrived on time and I got a great price. </content> Ejemplo: <content> Positives: Great prices. Suggestions: Selection could be better. </content>
`ratings`	--	Obligatorio (1)	Elemento contenedor de las calificaciones del revisor del comerciante. Si no hay ninguna calificación disponible para el elemento `<overall>`, toda la opinión asociada debe excluirse del feed porque el elemento `<overall>` es obligatorio y la opinión no se aceptará sin él.
`collection_method`	CollectionMethodType	Obligatorio (1)	Es el método que se usó para recopilar la opinión. El valor debe ser uno de los siguientes: no solicitado: El usuario no respondió 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 completa el pedido del usuario. Ejemplo: <collection_method> after_fulfillment </collection_method>

`<ratings>`

Descripción

Contiene las calificaciones del revisor del comerciante. Si no hay ninguna calificación disponible para el elemento <overall>, se debe excluir por completo el comentario asociado, ya que el elemento <overall> es obligatorio y la opinión no se aceptará sin él.

Contiene

Incluye los siguientes elementos en el elemento de calificaciones.

Nombre Formato Occurrences Descripción

Nombre	Formato	Occurrences	Descripción
`overall`	Rango de calificación	Obligatorio (1)	Indica la calificación general del usuario que dejó la opinión de un comercio. Ejemplo: <overall min="1" max="10">9</overall>
`customer_service`	Rango de calificación	Opcional (0‐1)	Calificación del revisor sobre la calidad de la atención al cliente de este comerciante. Ejemplo: <customer_service min="1" max="5">3</customer_service>

overall

Rango de calificación

Obligatorio (1)

Indica la calificación general del usuario que dejó la opinión de un comercio.

Ejemplo:

  <overall min="1" max="10">9</overall>

customer_service

Rango de calificación

Opcional (0‐1)

Calificación del revisor sobre la calidad de la atención al cliente de este comerciante.

Ejemplo:

  <customer_service min="1" max="5">3</customer_service>

`<deleted_reviews>`

Descripción

Contenedor para las opiniones que se borraron.

Contiene

Nombre	Formato	Occurrences	Descripción
`deleted_review`	--	Obligatorio (1-n)	Contiene elementos relacionados con una sola opinión borrada.

`<deleted_review>`

Descripción

La opinión que se borró.

Atributos

Nombre	Formato	Occurrences	Descripción
`id`	ID	Obligatorio (1)	Especifica el ID de una opinión que se debe eliminar del feed. El ID debe coincidir con el atributo id de un elemento `<review>` en cualquier archivo de feed.

Contiene

Nombre Formato Occurrences Descripción

Nombre	Formato	Occurrences	Descripción
`last_update_timestamp`	Fecha y hora	Obligatorio (1)	Hora a la que se quitó una opinión del sistema. Ejemplo: <last_update_timestamp> 2016-04-03T18:37:32Z </last_update_timestamp>

last_update_timestamp

Fecha y hora

Obligatorio (1)

Hora a la que se quitó una opinión del sistema.

Ejemplo:

  <last_update_timestamp>
    2016-04-03T18:37:32Z
  </last_update_timestamp>

Ejemplo

<deleted_review id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z<last_update_timestamp>
</deleted_review>

Esquema XML

Elemento de nivel superior: <feed>

Descripción

Atributos

Ejemplo

Contiene

<merchants>

Descripción

Contiene

<merchant>

Descripción

Atributos

Ejemplo

Contiene

<deleted_merchants>

Descripción

Contiene

<deleted_merchant>

Descripción

Atributos

Contiene

Ejemplo

<reviews>

Descripción

Contiene

<review>

Descripción

Atributos

Contiene

<ratings>

Descripción

Contiene

<deleted_reviews>

Descripción

Contiene

<deleted_review>

Descripción

Atributos

Contiene

Ejemplo

Elemento de nivel superior: `<feed>`

`<merchants>`

`<merchant>`

`<deleted_merchants>`

`<deleted_merchant>`

`<reviews>`

`<review>`

`<ratings>`

`<deleted_reviews>`

`<deleted_review>`