Especificación de Atom 0.3

Este documento contiene las directrices para crear un feed de datos de productos XML en formato Atom 0.3. Para ayudarlo a encontrar información adicional relacionada con los elementos de los ejemplos, vinculamos los atributos estándar a las secciones correspondientes de la especificación de Atom 0.3 oficial. Aunque proporcionamos ejemplos de archivos Atom 0.3, incluimos poca información detallada sobre Atom 0.3 en sí.

Sección 1: Atom 0.3

Según la especificación de Atom 0.3, los siguientes son los cuatro elementos predefinidos en el nivel de la entrada: title [título], link [vínculo], id [id] y modified [última modificación]. Aunque estos elementos son opcionales en el estándar de Atom 0.3, son obligatorios para el feed de datos.

Su feed de datos también requiere elementos adicionales, como el precio y el estado. A fin de incluir estos elementos y más detalles sobre un producto, agregamos el espacio de nombres de Google Merchant Center para ampliar Atom 0.3. Definir el espacio de nombres de Google Merchant Center permite usar elementos adicionales, denominados “atributos”, y aumenta la cantidad de información que se puede proporcionar sobre cada producto en un feed.

A continuación, se muestra un ejemplo de un documento Atom 0.3 básico que contiene un único producto:

<?xml version="1.0"?> <feed version="0.3" xmlns="http://purl.org/atom/ns#"

xmlns:g="http://base.google.com/ns/1.0">

<title>El nombre de su feed de datos</title> <link href="http://www.example.com" rel="alternate" type="text/html" /> <modified>2005-10-11T18:30:02Z</modified> <author> <name>Google</name> </author> <id>tag:google.com,2005-10-15:/support/products</id> <entry> <title>Suéter rojo de lana</title> <link href="http://www.example.com/item1-info-page.html" /> <summary>Cómodo y suave, este suéter es ideal para las frías noches de invierno.</summary> <id>tag:google.com,2005-10-15:/support/products</id> <issued>2005-10-13T18:30:02Z</issued> <modified>2005-10-13T18:30:02Z</modified>

<g:image_link>http://www.example.com/imagen1.jpg</g:image_link> <g:price>25</g:price> <g:condition>nuevo</g:condition>

</entry> </feed>

En este ejemplo, los dos elementos principales que se agregaron fueron la declaración del espacio de nombres (en la tercera línea) y tres atributos (vínculo de imagen [image_link], precio [price] y estado [condition]).

Declaración de espacio de nombres de Google Merchant Center

Para utilizar atributos que solo estén definidos en el espacio de nombres de Google Merchant Center, se debe utilizar la declaración de espacio de nombres que se indica a continuación.

xmlns:g="http://base.google.com/ns/1.0"

Además de declarar el espacio de nombres de Google Merchant Center, también se debe incluir un prefijo en cada etiqueta de atributo. Se agrega este prefijo a los atributos para distinguir aquellos que están definidos en nuestro espacio de nombres de los elementos definidos en Atom 0.3. El prefijo seleccionado para esta declaración de espacio de nombres es “g”:

<g:image_link>http://www.example.com/image1.jpg</g:image_link>

Los atributos del espacio de nombres de Google Merchant Center deben incluir este prefijo; de no hacerlo, los atributos o los valores que contengan se ignorarán.

Atributos

Puede utilizar todos los atributos relevantes que sean específicos de sus productos. Si proporciona información adicional sobre sus productos por medio de estos atributos, mejorará notablemente las posibilidades de que aparezcan en los resultados. Además, muchos de los atributos definidos en el espacio de nombres de Google Merchant Center se pueden usar más de una vez dentro de un solo producto. Esto le permite agregar más información disponible sobre los artículos del feed.

Sección 2: Lista de tareas importante

Antes de enviar un feed, recomendamos seguir la lista de comprobación siguiente para garantizar que el archivo tenga el formato correcto:

1. El nombre de archivo debe terminar con la extensión .xml.
2. El nombre de archivo del feed registrado en su cuenta de Google Merchant Center debe coincidir con el nombre que asigne a su archivo.
3. No olvide incluir las declaraciones de espacio de nombres. Estos valores deben coincidir exactamente con la versión que se muestra.
   1. Espacio de nombres de Google Merchant Center: xmlns:g="http://base.google.com/ns/1.0".
   2. Espacio de nombres de atributos personalizados: xmlns:[prefijo]="http://base.google.com/cns/1.0", en el que [prefijo] se reemplaza por el prefijo que incluyó en su archivo.
4. Compruebe que el prefijo incluido en las etiquetas de atributo de Google Merchant Center y de Google Merchant Center personalizado coincida con el prefijo definido en la declaración de espacio de nombres.
5. Elimine los atributos que no contengan ningún valor.

Sección 3: Nota final

La entrada de ejemplo incluida en este documento se simplificó para permitir un enfoque más claro en los conceptos básicos de la creación de un feed de datos XML de Google Merchant Center. Aunque aceptamos feeds que contengan otros elementos definidos en el estándar de Atom 0.3 o en su propio espacio de nombres, cualquier información que contengan estos elementos se ignorará al procesar los feeds y no aparecerá en las entradas de sus productos. En este momento, solo procesamos datos incluidos en los elementos Atom 0.3 predeterminados y en los atributos de los espacios de nombres de Google Merchant Center y de Google Merchant Center personalizado.