Schéma XML

Cette section décrit le schéma XML utilisé pour le flux de données sur les avis des marchands.

Élément de niveau supérieur: <feed>

Description

Élément de conteneur de niveau supérieur qui contient tous les autres éléments du flux.

Attributs

Nom Format Occurrences Description
xmlns xs:string Obligatoire (1) Veuillez coder en dur la valeur suivante:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:string Obligatoire (1) Veuillez coder en dur la valeur suivante :
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:string Obligatoire (1) Veuillez coder en dur la valeur suivante, en laissant un seul espace vide entre les URL :
http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd

Exemple

<feed xmlns="http://schemas.google.com/merchant_reviews/5.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://schemas.google.com/merchant_reviews/5.0 https://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd">

Contient

Nom Format Occurrences Description
merchants -- Facultatif (0-1) Élément de conteneur pour les éléments <merchant>.
deleted_merchants -- Facultatif (0-1) Élément de conteneur pour les éléments <deleted_merchant>.
reviews -- Facultatif (0-1) Élément de conteneur pour les éléments <review>.
deleted_reviews -- Facultatif (0-1) Élément de conteneur pour les éléments <deleted_review>.

<merchants>

Description

Conteneur pour les éléments <merchant>.

Contient

Nom Format Occurrences Description
merchant -- Obligatoire (1-n) Élément répété pour chaque marchand.

<merchant>

Description

Chaque élément <merchant> contient des informations et des avis concernant un marchand.

Attributs

Nom Format Occurrences Description
id Identifiant Obligatoire (1) Doit être unique et stable dans tous les flux. En d'autres termes, si un flux aujourd'hui et un flux datant de 90 jours font référence au même marchand, ils doivent avoir le même ID.

Exemple

<merchant id="2739">

Contient

Veuillez inclure les éléments suivants dans l'élément du marchand.

Nom Format Occurrences Description
name NonEmptyString (Chaîne vide) Obligatoire (1) Nom lisible du marchand.
merchant_url xs:anyURI Obligatoire (1) URL du site Web principal du marchand.
N'utilisez pas d'URL de redirection pour cette valeur. En d'autres termes, la valeur doit pointer directement vers le site du marchand.

Exemple : 

<merchant_url>
  http://store.google.com
</merchant_url>
rating_url xs:anyURI Obligatoire (1) URL de la page de destination qui héberge les avis sur ce marchand.
N'utilisez pas d'URL de redirection.

Exemple : 

<rating_url>
  http://merchant_url.com/reviews/
</rating_url>
create_timestamp DateTimeWithTimeZone (Date et heure avec le fuseau horaire) Obligatoire (1) Date et heure de création du marchand. Cela ne devrait jamais changer.
last_update_timestamp DateTimeWithTimeZone (Date et heure avec le fuseau horaire) Obligatoire (1) Date et heure de la dernière mise à jour du marchand. Si l'un des champs de l'élément <merchant> est mis à jour pour une référence marchand donnée, cette valeur doit également changer.

<deleted_merchants>

Description

Conteneur pour les marchands supprimés.

Contient

Nom Format Occurrences Description
deleted_merchant -- Obligatoire (1-n) Contient un ou plusieurs éléments liés à un seul marchand supprimé.

<deleted_merchant>

Description

Marchand supprimé.

Attributs

Nom Format Occurrences Description
id Identifiant Obligatoire (1) Indique l'ID d'un marchand à supprimer du flux. L'ID doit correspondre à l'attribut id d'un élément <merchant> dans n'importe quel fichier de flux précédent.

Contient

Nom Format Occurrences Description
last_update_timestamp DateTimeWithTimeZone (Date et heure avec le fuseau horaire) Obligatoire (1) Date et heure auxquelles un marchand a été retiré du système.

Exemple : 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>

Exemple

<deleted_merchant id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z</last_update_timestamp>
</deleted_merchant>

<reviews>

Description

Conteneur pour les éléments <review>.

Contient

Nom Format Occurrences Description
review -- Obligatoire (1-n) Élément répété pour chaque avis.

<review>

Description

Conteneur pour les détails liés à un avis.

Attributs

Nom Format Occurrences Description
id Identifiant Obligatoire (1) Identifiant de l'avis dans votre système. Doit être unique et stable dans tous les flux.

Exemple : 

<review id=132739 mid=1234>
mid Identifiant Obligatoire (1) Identifiant du marchand auquel cet avis est destiné.

Contient

Veuillez inclure les éléments suivants dans l'élément de l'avis.

Nom Format Occurrences Description
reviewer_name NonEmptyString (Chaîne vide) Facultatif (0-1) Nom à afficher de l'auteur de l'avis, à condition qu'il soit associé à un nom d'auteur Les avis anonymes ne doivent pas inclure ce champ.

Exemple : 

<reviewer_name>
  Joel
</reviewer_name>
create_timestamp DateTimeWithTimeZone (Date et heure avec le fuseau horaire) Obligatoire (1) Date et heure de l'envoi de l'avis par l'utilisateur. Cela ne devrait jamais changer.

Exemple : 

<create_timestamp>
  2016-04-03T18:37:32Z
</create_timestamp>
last_update_timestamp DateTimeWithTimeZone (Date et heure avec le fuseau horaire) Obligatoire (1) Date et heure de la dernière modification des informations de l'élément <review>. Si l'un des champs de l'élément <review> est mis à jour pour un ID d'avis donné, cette valeur doit également changer.

Exemple : 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>
country_code CountryCode Obligatoire (1) Pays du contributeur. S'il est disponible, il s'agit du pays dans lequel le produit a été livré ou du service où il a été fourni. Sinon, utilisez le pays dans lequel se trouve l'auteur de l'avis lors de sa création. Le code pays doit être au format ISO 3166-1 alpha-2.

Exemple : 

  <country_code>
    US
  </country_code>
title xs:string Facultatif (0-1) Titre de l'avis. Le titre doit être constitué de texte brut et ne contenant aucune balise HTML.

Exemple : 

  <title>
    Great prices
  </title>
content xs:string Obligatoire (1) Contenu de l'avis. Il doit s'agir de n'importe quel texte libre fourni par l'utilisateur et ne doit pas être tronqué. Le contenu doit être en texte brut et ne comporter aucune balise HTML. Par exemple, un saut de ligne doit être représenté par un caractère de saut de ligne et non par une balise <br>. Si plusieurs réponses à différentes questions sont fournies, toutes les réponses doivent être incluses, avec le contexte minimal nécessaire pour que les réponses soient pertinentes. Ne fournissez pas de contexte si vous n'avez pas répondu aux questions.

Exemple : 

  <content>
    I like this store!
    My order arrived on time and I got
    a great price.
  </content>

Exemple : 

  <content>
    Positives: Great prices.
    Suggestions: Selection could be better.
  </content>
ratings -- Obligatoire (1) Élément de conteneur pour les avis du marchand à l'origine de l'avis. Si aucune note n'est disponible pour l'élément <overall>, l'intégralité de l'avis associé doit être exclue du flux, car l'élément <overall> est obligatoire. Sans cet avis, l'avis ne sera pas accepté.
collection_method CollectionMethodType Obligatoire (1) Méthode utilisée pour recueillir l'avis. La valeur doit correspondre à l'une des suivantes :
  • non sollicité: l'utilisateur ne répondait pas à une demande spécifique au moment d'envoyer l'avis.
  • point_of_sale: l'utilisateur a envoyé l'avis en réponse à une sollicitation lorsqu'il a passé une commande.
  • after_fulfillment: l'utilisateur a envoyé l'avis en réponse à une sollicitation après le traitement de sa commande.

Exemple : 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

Description

Contient les notes du marchand par le contributeur. Si aucune note n'est disponible pour l'élément <overall>, l'avis associé complet doit être exclu du flux. En effet, l'élément <overall> est obligatoire, et l'examen ne sera pas accepté sans cet élément.

Contient

Veuillez inclure les éléments suivants dans l'élément de note.

Nom Format Occurrences Description
overall RangeRange Obligatoire (1) Note globale de l'auteur d'un avis sur un marchand.

Exemple : 

  <overall min="1" max="10">9</overall>
customer_service RangeRange Facultatif (0-1) Note de l'examinateur sur la qualité du service client de ce marchand.

Exemple : 

  <customer_service min="1" max="5">3</customer_service>

<deleted_reviews>

Description

Conteneur pour les avis supprimés.

Contient

Nom Format Occurrences Description
deleted_review -- Obligatoire (1-n) Contient un ou plusieurs éléments liés à un seul avis supprimé.

<deleted_review>

Description

Examinez les éléments qui ont été supprimés.

Attributs

Nom Format Occurrences Description
id Identifiant Obligatoire (1) Indique l'ID d'un avis à supprimer du flux. L'ID doit correspondre à l'attribut"id"d'un élément <review> dans un fichier de flux.

Contient

Nom Format Occurrences Description
last_update_timestamp DateTimeWithTimeZone (Date et heure avec le fuseau horaire) Obligatoire (1) Heure à laquelle un avis a été supprimé du système.

Exemple : 

  <last_update_timestamp>
    2016-04-03T18:37:32Z
  </last_update_timestamp>

Exemple

<deleted_review id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z<last_update_timestamp>
</deleted_review>