Documentation de référence sur les schémas XML

Le schéma XML pour les flux d'avis sur les produits Google définit la structure acceptable de votre flux XML. Les schémas XML utilisent l'extension de fichier .xsd. Comme les fichiers DTD, un schéma XML définit les éléments et les attributs qui peuvent figurer dans un document XML.

Pour en savoir plus sur les schémas XML, consultez XML Schema Primer.

Le schéma XML pour les flux d'avis sur les produits est publié ici : http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

Vous trouverez ci-dessous une description de la structure du flux définie par ce schéma. Dans cette description, les noms de types avec le préfixe xs: font référence aux types de schéma XML intégrés qui se trouvent dans l'espace de noms XML http://www.w3.org/2001/XMLSchema.

Notre système s'attend toujours à recevoir un flux complet. Tous les avis précédemment envoyés, mais qui ne figurent pas dans votre prochain flux complet, seront supprimés. Par conséquent, vous devez toujours envoyer tous vos avis lorsque vous envoyez votre flux.

Élément <feed> de premier niveau

L'élément <feed> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<version> Obligatoire (1) xs:string Indique la version du schéma du flux d'avis sur les produits utilisée. Pour le moment, seul <version>2.4</version> est pris en charge.
<aggregator> Facultatif (1) aggregatorType Un éditeur peut utiliser un agrégateur d'avis pour gérer les avis et fournir les flux. Cet élément indique l'utilisation d'un agrégateur et contient des informations sur l'agrégateur.
<publisher> Obligatoire (1) publisherType Informations sur l'éditeur, qui peut être un marchand, un fabricant, une entreprise de services d'avis ou toute entité qui publie des avis sur des produits.
<reviews> Facultatif (1) xs:sequence Contient les avis sur les produits.

<feed> définit les contraintes d'unicité sur les éléments utilisés dans le flux.

Éléments enfants

<aggregator>

Un éditeur peut utiliser un agrégateur d'avis pour gérer les avis et fournir les flux. Cet élément indique l'utilisation d'un agrégateur et contient des informations à son sujet. L'élément <aggregator> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<name> Obligatoire (1) nonEmptyStringType Nom de l'agrégateur des avis sur les produits.

<publisher>

Informations sur l'éditeur, qui peut être un marchand, un fabricant, une entreprise de services d'avis ou toute entité qui publie des avis sur des produits.L'élément <publisher> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<name> Obligatoire (1) nonEmptyStringType Nom de l'éditeur des avis sur les produits.
<favicon> Facultatif (1) httpUrlType Lien vers la favicon de l'entreprise de l'éditeur. Les dimensions de l'image doivent être celles d'une favicon : 16 x 16 pixels. L'image doit être au format GIF, JPG ou PNG.

<reviews>

Contient les avis sur le produit. L'élément <reviews> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<review> Obligatoire (1 à illimité) reviewType Avis unique sur un produit. Si un avis concerne plusieurs produits de l'inventaire de l'éditeur, spécifiez-le une seule fois et incluez plusieurs éléments <product> dans l'élément <products>.

<review>

Avis unique sur un produit. Si un avis concerne plusieurs produits de l'inventaire de l'éditeur, spécifiez-le une seule fois et incluez plusieurs éléments <product> dans l'élément <products>.L'élément <review> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<review_id> Obligatoire (1) nonEmptyStringType Identifiant unique et permanent de l'avis sur le produit dans le système de l'éditeur.
<reviewer> Obligatoire (1) reviewerType Auteur de l'avis sur le produit.
<is_verified_purchase> Facultatif (1) xs:boolean Indique si l'auteur de l'avis a acheté le produit.
<is_incentivized_review> Facultatif (1) xs:boolean Indique si l'auteur de l'avis a été incité ou non à donner son avis sur le produit.
<review_timestamp> Obligatoire (1) xs:dateTime

Horodatage indiquant la date de rédaction de l'avis.

Exemples :

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> Facultatif (1) nonEmptyStringType Titre de l'avis.
<content> Obligatoire (1) nonEmptyStringType Contenu de l'avis.
<review_language> Facultatif (1) xs:string Langue de l'avis (BCP 47).
<review_country> Facultatif (1) xs:string Code pays (ISO 3166-1) du réviseur.
<pros> Facultatif (1) xs:sequence Contient les avantages selon l'avis du contributeur. Omettez le texte récurrent tel que "avantages :" sauf s'il a été écrit par l'auteur de l'avis.
<cons> Facultatif (1) xs:sequence Contient les inconvénients selon l'avis de l'évaluateur. Omettez le texte standard tel que "inconvénient", sauf s'il a été écrit par le lecteur.
<reviewer_images> Facultatif (1) xs:sequence Contient des liens vers les images du produit fournies par l'auteur de l'avis.
<review_url> Obligatoire (1) reviewUrlType URL de la page de destination de l'avis.
<ratings> Obligatoire (1) xs:sequence Contient les notes associées à l'avis.
<products> Obligatoire (1) xs:sequence Contient les produits associés à l'avis.
<is_spam> Facultatif (1) xs:boolean Indique si l'avis a été signalé comme spam dans le système de l'éditeur.
<collection_method> Facultatif (1) collectionMethodType

Méthode utilisée pour collecter l'avis. La valeur doit correspondre à l'un des éléments suivants :

unsolicited
L'avis envoyé par l'utilisateur ne correspondait pas à une sollicitation spécifique.
post_fulfillment
L'utilisateur a envoyé l'avis en réponse à une sollicitation après l'exécution de sa commande.
<transaction_id> Facultatif (1) nonEmptyStringType Identifiant unique et permanent de la transaction associée à l'avis dans le système de l'éditeur. Cet ID peut être utilisé pour indiquer que plusieurs avis sont associés à la même transaction.

<reviewer>

Auteur de l'avis sur le produit. L'élément <reviewer> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<name> Obligatoire (1) reviewerNameType

Nom de l'auteur de l'avis.

Exemple :

<name>Jane</name>
<reviewer_id> Facultatif (1) nonEmptyStringType

Identifiant unique et permanent de l'auteur de l'avis dans le système de l'éditeur.

Exemple :

<reviewer_id>14295</reviewer_id>

<name>

Nom de l'auteur de l'avis. L'élément <name> est une extension de nonEmptyStringType et contient le nom ou l'alias de l'auteur de l'avis. L'élément <name> contient les attributs suivants.

Attribut Occurrence Type Description
is_anonymous Facultatif xs:boolean

Indique si l'auteur de l'avis est anonyme.

Exemple :

<name is_anonymous="true">Anonymous</name>

<pros>

Contient les avantages selon l'avis du contributeur. L'élément <pros> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<pro> Obligatoire (1 à illimité) nonEmptyStringType

Un avantage individuel basé sur l'opinion de l'examinateur. Les avantages doivent être listés dans le même ordre que celui dans lequel ils sont affichés. Omettez le texte récurrent tel que "Avantages :", sauf s'il a été rédigé par l'auteur de l'avis.

Exemple :

<pros>
  <pro>Sleek design</pro>
</pros>

<cons>

Contient les inconvénients selon l'avis de l'évaluateur. L'élément <cons> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<con> Obligatoire (1 à illimité) nonEmptyStringType

Un inconvénient individuel basé sur l'opinion du réviseur. Les inconvénients doivent être listés dans le même ordre que celui dans lequel ils sont affichés. Omettez le texte récurrent tel que "inconvénient", sauf s'il a été rédigé par l'auteur de l'avis.

Exemple :

<cons>
  <con>Pricey</con>
</cons>

<review_url>

URL de la page de destination de l'avis. L'élément <review_url> est une extension de httpUrlType et contient le lien vers la page de destination de l'avis. L'élément <review_url> contient les attributs suivants.

Attribut Occurrence Type Description
type Obligatoire xs:string

Le type doit être l'un des suivants :

singleton
La page d'avis ne contient que cet avis.
group
La page d'avis contient un groupe d'avis, y compris celui-ci.

Exemple :

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

Contient des images du produit fournies par l'auteur de l'avis. La balise <reviewer_images> contient de nombreux éléments <reviewer_image>.

Élément Occurrence Type Description
<reviewer_image> Obligatoire (1 à illimité) reviewImageType

Image du produit examiné créée par l'auteur de l'avis.

<reviewer_image>

Élément d'image d'un seul avis.

Élément Occurrence Type Description
<url> Obligatoire (1) httpUrlType

URL d'une image du produit examiné créée par l'auteur de l'avis. L'URL ne doit pas nécessairement se terminer par une extension de fichier image.

Exemple :

<reviewer_images>
  <reviewer_image>
    <url>https://example.com/test.jpg</url>
  </reviewer_image>
  <reviewer_image>
    <url>https://example.com/test.gif</url>
  </reviewer_image>
</reviewer_images>

<ratings>

Contient les notes associées à l'avis. L'élément <ratings> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<overall> Obligatoire (1) ratingType Note globale attribuée au produit par le lecteur.

<overall>

Note globale attribuée au produit par le lecteur. L'élément <overall> étend un xs:decimal simpleType et capture la note attribuée par l'auteur de l'avis. La valeur doit être comprise dans la plage inclusive définie par les attributs min et max. L'élément <overall> contient les attributs suivants.

Attribut Occurrence Type Description
min Obligatoire xs:integer Nombre minimal possible pour la note. Il doit s'agir de la pire note possible et non d'une valeur indiquant l'absence de note.
max Obligatoire xs:integer Nombre maximal possible pour la note. La valeur de l'attribut max doit être supérieure à celle de l'attribut min.

<products>

Contient les produits associés à l'avis. L'élément <products> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<product> Obligatoire (1 à illimité) productType Produit associé à l'avis.

<product>

Produit associé à l'avis. L'élément <product> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<product_ids> Facultatif (1) productIdsType Identifiants associés à un produit.
<product_name> Facultatif (1) nonEmptyStringType Nom descriptif d'un produit.
<product_url> Obligatoire (1) httpUrlType URL du produit. Cette URL peut avoir la même valeur que l'élément <review_url> si l'URL de l'avis et celle du produit sont les mêmes.

<product_ids>

Identifiants associés à un produit. L'élément <product_ids> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<gtins> Obligatoire (pour tous les avis associés à des produits dont le code GTIN est connu)

Facultatif pour tous les autres avis(1)		 gtinsType Contient les codes GTIN (code article international) associés à un produit. Les sous-types de GTIN (par exemple, UPC, EAN, ISBN, JAN) sont acceptés.
<mpns> Obligatoire (pour tous les avis associés à des produits dont la référence fabricant est connue)

Facultatif pour tous les autres avis(1)		 mpnsType Contient les références fabricant associées à un produit.
<skus> Obligatoire (pour tous les avis associés à des produits dont le code SKU est connu)

Facultatif pour tous les autres avis(1)		 skusType Contient les SKU (unités de gestion des stocks) associés à un produit. Il correspond souvent à l'ID de l'offre du produit dans le flux de produits.
<brands> Obligatoire (pour tous les avis associés à des produits dont la marque est connue)

Facultatif pour tous les autres avis (1)		 brandsType Contient les noms de marques associés à un produit.
<asins> Facultatif (1) asinsType Contient les ASIN (Amazon Standard Identification Numbers) associés à un produit.

<gtins>

Contient les codes GTIN (code article international) associés à un produit. L'élément <gtins> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<gtin> Obligatoire (1 à illimité) nonEmptyStringType Code article international du produit. Les sous-types de GTIN (par exemple, UPC, EAN, ISBN, JAN) sont acceptés.

<mpns>

Contient les références fabricant associées à un produit. L'élément <mpns> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<mpn> Obligatoire (1 à illimité) nonEmptyStringType Référence fabricant du produit.

<skus>

Contient les SKU (unités de gestion des stocks) associés à un produit. L'élément <skus> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<sku> Obligatoire (1 à illimité) nonEmptyStringType Unité de gestion des stocks du produit dans l'inventaire de l'éditeur.

<brands>

Contient les noms de marques associés à un produit. L'élément <brands> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<brand> Obligatoire (1 à illimité) nonEmptyStringType Nom de la marque du produit.

<asins>

Contient les ASIN (Amazon Standard Identification Numbers) associés à un produit. L'élément <asins> contient ces éléments dans l'ordre indiqué.

Élément Occurrence Type Description
<asin> Obligatoire (1 à illimité) nonEmptyStringType Numéro d'identification Amazon Standard du produit. Chaque ASIN est composé de 10 caractères alphanumériques.