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:
|
<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:
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
É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. |