Especificación de Atom 1.0

Este documento contiene las directrices para crear un feed de datos de productos XML en formato Atom 1.0. 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 1.0 oficial. Aunque proporcionamos ejemplos de archivos Atom 1.0, entregamos poca información detallada sobre este formato. Si desea más detalles sobre este estándar, consulte la especificación en el formato de distribución de Atom.

Para descargar un archivo de ejemplo de Atom 1.0, haga clic aquí.

Sección 1: Atom 1.0

De acuerdo con la especificación de Atom 1.0, hay cinco elementos predefinidos a nivel de la entrada: title, id, link, summary y updated. Aunque estos elementos son opcionales en el estándar de Atom 1.0, son obligatorios para el feed de datos de producto.

Estos feeds también requieren elementos adicionales, como price [precio] y condition [estado]. Para incluir más detalles sobre un artículo, agregamos el espacio de nombres de Google Merchant Center a fin de ampliar Atom 1.0. 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 1.0 básico que contiene un único artículo:

<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom"

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" /> <updated>2006-06-11T18:30:02Z</updated> <author> <name>Google</name> </author>
<id>tag:example.com,2006-06-11:/support/products</id> <entry> 
<title>Suéter de lana rojo</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Este suéter es holgado y suave, ideal para protegerse contra el frío en invierno.</summary> 

<updated>2005-10-13T18:30:02Z</updated>
<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link> <g:price>25</g:price> <g:condition>new</g:condition>
</entry> </feed>

 

En este ejemplo, los dos elementos principales que se agregaron fueron la declaración del espacio de nombres 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 1.0. El prefijo seleccionado para esta declaración de espacio de nombres es “g”:

<g:image_link>http://www.google.com/images/google_sm.gif</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 muestra 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 1.0 o en su propio espacio de nombres, cualquier información que contengan estos elementos se omitirá cuando se procesen los feeds y no aparecerá en sus anuncios o fichas de producto gratuitas. En este momento, solo procesamos datos incluidos en los elementos Atom 1.0 predeterminados y en los atributos de los espacios de nombres de Google Merchant Center y de Google Merchant Center personalizado.