Spécifications Atom 0.3

Vous trouverez dans ce document des consignes pour créer un flux de données XML de vos produits au format Atom 0.3. Nous avons associé les attributs standards aux sections correspondantes dans les spécifications Atom 0.3 officielles pour vous aider à trouver des informations supplémentaires à propos des composants présentés dans nos exemples. Bien que nous proposions des exemples de fichiers Atom 0.3, nous donnons peu de détails sur ce form.

Section 1 : Atom 0.3

Le format Atom 0.3 comprend quatre éléments prédéfinis au niveau de l'entrée : "title" [titre], "link" [lien], "id" [id] et "modified" [modifié]. Bien que ces éléments soient facultatifs dans la norme Atom 0.3, ils sont obligatoires dans votre flux de données.

Celui-ci nécessite également des éléments supplémentaires, comme : "price" [prix] et "condition" [état]. Afin d'intégrer ces éléments et des informations plus détaillées concernant un produit, nous avons étendu Atom 0.3 en ajoutant l'espace de noms Google Merchant Center. En définissant l'espace de noms Google Merchant Center, vous avez la possibilité d'utiliser davantage d'éléments ("attributs") et d'accroître la quantité d'informations que vous pouvez fournir à propos de chaque produit au sein d'un flux.

Voici un exemple de document Atom 0.3 de base contenant un seul produit :

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

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

<title>Nom de votre flux de données</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>Pull en laine rouge</title> <link href="http://www.example.com/item1-info-page.html" /> <summary>Confortable et doux, ce pull vous permettra de passer les longues soirées d'hiver au chaud.</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/image1.jpg</g:image_link> <g:price>25</g:price> <g:condition>neuf</g:condition>

</entry> </feed>

Dans cet exemple, les deux ajouts principaux sont la déclaration de l'espace de noms (à la troisième ligne) et trois attributs (lien image [image_link], prix [price] et état [condition].

Déclaration de l'espace de nom Google Merchant Center

La déclaration d'espace de noms ci-après est obligatoire pour que les attributs définis uniquement dans l'espace de noms Google Merchant Center puissent être utilisés.

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

Outre la déclaration de l'espace de noms Google Merchant Center, vous devez ajouter un préfixe dans chaque balise d'attribut. Nous ajoutons ce préfixe aux attributs afin de distinguer les attributs définis dans notre espace de noms des éléments définis dans Atom 0.3. Dans l'exemple de déclaration d'espace de noms ci-dessous, le préfixe utilisé est "g" :

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

Les attributs de l'espace de noms Google Merchant Center doivent inclure ce préfixe, sans quoi les attributs et les valeurs qu'ils contiennent sont ignorés.

Attributs

Vous pouvez utiliser tous les attributs pertinents spécifiques à vos produits. L'ajout d'informations complémentaires concernant vos produits à l'aide de ces attributs augmentera considérablement les chances de voir vos produits apparaître dans les résultats. En outre, un grand nombre d'attributs définis dans l'espace de noms Google Merchant Center peuvent servir plusieurs fois pour un seul produit. Ceci vous permet d'ajouter davantage d'informations concernant les produits de votre flux.

Section 2 : Points importants à vérifier

Avant d'envoyer votre flux, nous vous conseillons vivement de contrôler les points suivants pour vérifier que son format est correct :

1. Le nom de fichier doit porter l'extension .xml.
2. Le nom du flux enregistré dans votre compte Google Merchant Center et le nom de votre fichier doivent être identiques.
3. N'oubliez pas d'inclure les déclarations d'espace de noms. Ces valeurs doivent impérativement respecter le format suivant :
   1. Espace de noms Google Merchant Center : xmlns:g="http://base.google.com/ns/1.0"
   2. Espace de noms avec un attribut personnalisé : xmlns:[prefix]="http://base.google.com/cns/1.0", où "prefix" [préfixe] est remplacé par le préfixe que vous avez utilisé dans votre fichier
4. Vérifiez que le préfixe des balises d'attributs Google Merchant Center et Google Merchant Center personnalisés correspond au préfixe défini dans la déclaration d'espace de noms.
5. Supprimez les attributs qui ne contiennent pas de valeur.

Section 3 : Note finale

L'exemple proposé dans ce document a été simplifié afin de mettre clairement en évidence les bases de la création d'un flux de données XML Google Merchant Center. Bien que nous acceptions les flux contenant d'autres éléments définis dans la norme Atom 0.3 ou avec votre propre espace de noms, toute information contenue dans ces éléments sera ignorée lors du traitement et n'apparaitra pas dans vos fiches. À l'heure actuelle, nous traitons uniquement les données des éléments Atom 3.0 par défaut ainsi que celles des attributs d'espaces de noms Google Merchant Center et Google Merchant Center personnalisés.