En este documento se proporcionan directrices para crear un feed de datos de producto XML en formato Atom 1.0. Para ayudarle a encontrar información adicional relacionada con los elementos de los ejemplos, hemos enlazado los atributos estándar a las secciones correspondientes de la especificación Atom 1.0 oficial. Aunque proporcionamos ejemplos de archivos Atom 1.0, apenas incluimos información detallada sobre el propio formato Atom 1.0.
Si quiere obtener más información sobre este estándar, puede consultar la especificación en el formato de distribución Atom.
Para descargar un archivo Atom 1.0 de ejemplo, haga clic aquí.
Sección 1: Atom 1.0
De acuerdo con la especificación Atom 1.0, hay cinco elementos predefinidos en el nivel de entrada: título, id, enlace, resumen y actualizado. Aunque estos elementos son opcionales en el estándar Atom 1.0, son obligatorios para las fuentes de datos de producto.
Sus fuentes de datos de producto también requieren elementos adicionales como el precio y el estado. Para incluir más detalles sobre un artículo, hemos añadido el espacio de nombres de Google Merchant Center para ampliar el estándar Atom 1.0. La definición del espacio de nombres de Google Merchant Center permite utilizar otros elementos, denominados "atributos", y proporcionar una mayor cantidad de información sobre los productos de una fuente de datos de producto.
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 fuente de datos de producto</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>Jersey de lana rojo</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Cómodo y suave, este suéter te mantendrá abrigado esas frías noches de 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 han añadido han sido la declaración de espacio de nombres y tres atributos: enlace 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 nombre de Google Merchant Center, se debe utilizar la declaración de espacio de nombre 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. Este prefijo sirve para diferenciar los atributos definidos en nuestro espacio de nombres de los elementos definidos en el formato 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 y los valores que contengan se ignorarán.
Atributos
Puede utilizar todos los atributos relevantes que se correspondan con sus productos. Si incluye más información sobre sus productos mediante estos atributos, las posibilidades de que aparezcan en los resultados aumentarán considerablemente. Además, muchos de los atributos definidos en el espacio de nombres de Google Merchant Center se pueden utilizar más de una vez en un mismo producto. Esto le permite añadir más información disponible sobre un producto en su fuente de datos de producto.
Sección 2: Comprobaciones importantes
Antes de enviar una fuente de datos de producto, recomendamos seguir la lista de comprobación siguiente para garantizar que el archivo tenga el formato correcto:
El nombre de archivo debe terminar con la extensión .xml.
El nombre del archivo de la fuente de datos de producto registrado en su cuenta de Google Merchant Center debe coincidir con el nombre que asigne al archivo.
No olvide incluir las declaraciones de espacio de nombres. Estos valores deben coincidir exactamente con los que se indican a continuación:
- Espacio de nombres de Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0". - Espacio de nombres de atributos personalizados:
xmlns:[prefix]="http://base.google.com/cns/1.0". Aquí, [prefix] se debe sustituir por el prefijo que quiera incluir en su archivo.
Compruebe que el prefijo incluido en las etiquetas de atributo de Google Merchant Center y de Google Merchant Center personalizado coincidan con el prefijo definido en la declaración de espacio de nombre.
Quite los atributos que no contengan ningún valor.
Sección 3: Nota final
Hemos simplificado el ejemplo incluido en este documento para centrarnos en los aspectos básicos de la creación de una fuente de datos de producto XML para Google Merchant Center. Aunque aceptamos fuentes de datos de producto que contengan otros elementos definidos en el estándar Atom 1.0 o en su propio espacio de nombres, cualquier dato incluido en esos elementos se ignorará durante el procesamiento y no aparecerá en sus anuncios ni en sus fichas de producto gratuitas. En este momento, solo procesamos los 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.