Este documento contiene los lineamientos para crear una fuente 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]. Si bien estos elementos son opcionales en el estándar Atom 0.3, son obligatorios para las fuentes de datos de productos.
Tu fuente de datos de productos 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 una fuente de datos de productos.
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 tu fuente de datos de productos</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 de lana rojo</title> <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> <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 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 ejemplo 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 0.3 o en tu propio espacio de nombres, cualquier información que contengan estos elementos se ignorará durante el procesamiento y no aparecerá en tus fichas. 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.