Este documento contiene los lineamientos para crear una fuente 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. Si bien estos elementos son opcionales en el estándar Atom 1.0, son obligatorios para las fuentes de datos de productos.
Las fuentes de datos de productos también deben incluir elementos como precio, ID y 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 una fuente de datos de productos.
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 tu fuente de datos de productos</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 cómodo 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 te permite agregar más información disponible sobre un producto en tu fuente de datos de productos.
Sección 2: Lista de tareas importante
Antes de enviar tu fuente de datos de productos, te recomendamos que revises la siguiente lista 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 productos que registres en tu cuenta de Google Merchant Center debe coincidir con el nombre que asignas a tu archivo.
No olvides incluir las declaraciones de espacio de nombres. Estos valores deben coincidir exactamente con la versión que se muestra.
- Espacio de nombres de Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0". - 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.
Comprueba 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.
Quita 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 fuentes de datos de productos XML de Google Merchant Center. Si bien aceptamos fuentes de datos de productos que contengan otros elementos definidos en el estándar Atom 1.0 o en tu propio espacio de nombres, cualquier información que contengan estos elementos se ignorará durante el procesamiento y no aparecerá en tus anuncios ni fichas de productos 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.