Spécifications Atom 1.0

Vous trouverez dans ce document des consignes pour créer un flux de données XML de vos produits au format Atom 1.0. Nous avons associé les attributs standard aux sections correspondantes dans les spécifications Atom 1.0 officielles afin de vous permettre de trouver des informations supplémentaires à propos des composants présentés dans nos exemples. Bien que nous proposions des exemples de fichiers Atom 1.0, nous donnons peu de détails concernant Atom 1.0. Pour en savoir plus sur cette norme, nous vous suggérons de lire la présentation de l'Atom Syndication Format.

Pour télécharger un fichier d'exemple au format Atom 1.0, cliquez ici.

Section 1 : Atom 1.0

Le format Atom 1.0 comprend cinq éléments prédéfinis au niveau de l'entrée : "title", "id", "link", "summary" et "updated". Bien que ces éléments soient facultatifs dans la norme Atom 1.0, ils sont obligatoires dans votre flux de données.

Des éléments supplémentaires, comme "price" et "condition", doivent également figurer dans votre flux de données. Afin d'intégrer des informations plus détaillées concernant un article, nous avons étendu Atom 1.0 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 1.0 de base contenant un seul article :

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

xmlns:g="http://base.google.com/ns/1.0">
<title>The name of your data feed</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>Red wool sweater</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Comfortable and soft, this sweater will keep you warm on those cold winter nights.</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>

 

Dans cet exemple, les deux ajouts principaux sont la déclaration de l'espace de noms 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 1.0. Dans l'exemple de déclaration d'espace de noms ci-dessous, le préfixe utilisé est "g" :

<g:image_link>http://www.google.com/images/google_sm.gif</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 de la norme Atom 1.0 ou de votre espace de noms, toute information contenue dans ces éléments sera ignorée lors du traitement et n'apparaîtra pas dans vos annonces ou fiches produit gratuites. Pour le moment, nous ne traitons que les données contenues dans des éléments Atom 1.0 par défaut et dans des attributs au sein des espaces de noms Google Merchant Center et Google Merchant Center personnalisés.