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

Livre: /product-review-feeds/_book.yaml

Titre: Référence de schéma 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. Tout comme les fichiers de données structurées, un schéma XML définit les éléments et les attributs qui peuvent apparaître dans un document XML.

Consultez cette page pour en savoir plus sur les schémas XML.

Le schéma XML pour les flux d'avis sur les produits est disponible à l'adresse suivante : http://www.google.com/shopping/reviews/schema/product/2.3/product_reviews.xsd

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

Notre système attend toujours un flux complet. Tous les avis envoyés précédemment, mais qui ne sont pas inclus 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 de flux d'avis sur les produits utilisée. Pour le moment, seul <version>2.3</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 celui-ci.
<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 les produits.
<reviews> Facultatif (1) xs:sequence Contient les avis sur le produit.

<feed> définit des contraintes d'unicité pour 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 sur celui-ci. 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 d'avis sur les produits.

<publisher>

Informations sur l'éditeur, qui peut être un marchand, un fabricant, un prestataire de services d'avis ou toute entité qui publie des avis sur les 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. L'image doit mesurer 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 individuel sur un produit. Si un avis concerne plusieurs produits de l'inventaire de l'éditeur, spécifiez-le une seule fois, puis incluez plusieurs éléments <product> dans l'élément <products>.

<review>

Avis individuel sur un produit. Si un avis concerne plusieurs produits de l'inventaire de l'éditeur, spécifiez-le une fois, puis 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> Facultatif (1) nonEmptyStringType Identifiant unique et permanent de l'avis sur les produits dans le système de l'éditeur.
<reviewer> Obligatoire (1) reviewerType Auteur de l'avis sur le produit.
<review_timestamp> Obligatoire (1) xs:dateTime

Horodatage indiquant le moment où l'avis a été rédigé.

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.
<pros> Facultatif (1) xs:sequence Contient des fournisseurs en fonction de l'opinion de l'auteur de l'avis. Omettez le texte récurrent tel que "pro:" , sauf s'il a été écrit par le réviseur.
<cons> Facultatif (1) xs:sequence Contient les inconvénients de l'avis de l'auteur de l'avis. Omettez le texte récurrent tel que "con:", sauf s'il a été écrit par le réviseur.
<reviewer_images> Facultatif (1) xs:sequence Contient des liens vers des images du produit fourni par le contributeur.
<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 est marqué comme spam dans le système de l'éditeur.
<collection_method> Facultatif (1) collectionMethodType

Méthode utilisée pour recueillir l'avis. La valeur doit être l'une des suivantes:

unsolicited
L'utilisateur n'a pas répondu à une sollicitation spécifique lors de l'envoi de l'avis.
post_fulfillment
L'utilisateur a envoyé l'avis en réponse à une sollicitation après que sa commande a été traitée.
<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 du contributeur. L'élément <name> contient ces attributs.

Attribut Occurrence Type Description
is_anonymous Facultative xs:boolean

Indique si le contributeur est anonyme.

Exemple :

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

<pros>

Contient des fournisseurs en fonction de l'opinion de l'auteur de l'avis. L'élément <pros> contient ces éléments dans l'ordre indiqué.

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

Professionnel indépendant d'après l'avis du contributeur Les fournisseurs doivent être présentés dans le même ordre que celui indiqué. Omettez le texte récurrent tel que "pro:" , sauf s'il a été écrit par le réviseur.

Exemple :

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

<cons>

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

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

Inconvénients individuels basés sur l'opinion de l'auteur de l'avis. Les inconvénients doivent être répertoriés dans l'ordre dans lequel ils sont affichés. Omettez le texte récurrent tel que "con:", sauf s'il a été écrit par le réviseur.

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 ces attributs.

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 incluant cet avis.

Exemple :

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

<reviewer_images>

Contient des images du produit fourni par le contributeur. Le tag <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éé par son auteur.

<reviewer_image>

Un seul élément image de l'avis.

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

URL d'une image du produit évalué et créée par son auteur. 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 de l'auteur de l'avis.

<overall>

Note globale de l'auteur de l'avis. L'élément <overall> étend une propriété xs:decimal simpleType et capture la note attribuée par le contributeur. La valeur doit se situer dans la plage inclusive définie par les attributs min et max. L'élément <overall> contient ces attributs.

Attribut Occurrence Type Description
min Obligatoire xs:integer Nombre minimal de notes possible. Il doit s'agir de la pire note possible et ne doit pas être une valeur pour les avis sans note.
max Obligatoire xs:integer Nombre maximal de notes possible. 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 identiques.

<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 avec un code GTIN connu afin d'activer la mise en correspondance complète des avis)

Facultatif (fortement recommandé) pour tous les autres avis (1)		 gtinsType Contient les codes GTIN (codes article internationaux) associés au produit.
<mpns> Obligatoire (la référence fabricant doit être incluse pour faciliter la mise en correspondance des avis si aucun code GTIN n'est attribué au produit concerné. Doit être envoyé avec la marque)

Facultatif pour tous les autres avis (1)		 mpnsType Contient les références fabricant associées à un produit.
<skus> Obligatoire (le code SKU doit être inclus pour faciliter la mise en correspondance des avis, si le produit associé à cet avis n'a pas de code GTIN ni de référence fabricant attribués. doit être envoyé avec la marque)

Facultatif pour tous les autres avis (1)		 skusType Contient les codes SKU (unités de gestion des stocks) associés à un produit. Il correspond souvent à l'identifiant de l'offre du produit dans le flux de produits.
<brands> Obligatoire (La marque doit être incluse pour faciliter la mise en correspondance des avis si le produit associé à l'avis n'a pas de code GTIN attribué. Doit être envoyé avec la référence fabricant)

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

<gtins>

Contient les codes GTIN (codes article internationaux) associés au 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.

<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 codes 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 marque 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 Marque du produit.

<asins>

Contient des numéros ASIN (Amazon Standard Identification Number) associés à un produit. L'élément 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 comporte 10 caractères alphanumériques.