REST Resource: accounts.productReviews

Ressource: ProductReview

Avis sur un produit. Pour en savoir plus, consultez Présentation des flux d'avis sur les produits.

Représentation JSON 
{
  "name": string,
  "productReviewId": string,
  "attributes": {
    object (ProductReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "productReviewStatus": {
    object (ProductReviewStatus)
  }
}
Champs
name

string

Identifiant. Nom de l'avis sur le produit. Format : "{productreview.name=accounts/{account}/productReviews/{productReview}}"
productReviewId

string

Obligatoire. Identifiant unique et permanent de l'avis sur le produit dans le système de l'éditeur.
attributes

object (ProductReviewAttributes)

Facultatif. Liste des attributs des avis sur les produits.
customAttributes[]

object (CustomAttribute)

Facultatif. Liste d'attributs personnalisés (fournis par le marchand).
dataSource

string

Uniquement en sortie. Source de données principale de l'avis sur le produit.
productReviewStatus

object (ProductReviewStatus)

Uniquement en sortie. État d'un avis sur un produit, problèmes de validation des données, c'est-à-dire informations sur un avis sur un produit calculées de manière asynchrone.

ProductReviewAttributes

Attributs.

Représentation JSON 
{
  "reviewTime": string,
  "pros": [
    string
  ],
  "cons": [
    string
  ],
  "reviewLink": {
    object (ReviewLink)
  },
  "reviewerImageLinks": [
    string
  ],
  "productNames": [
    string
  ],
  "productLinks": [
    string
  ],
  "asins": [
    string
  ],
  "gtins": [
    string
  ],
  "mpns": [
    string
  ],
  "skus": [
    string
  ],
  "brands": [
    string
  ],
  "collectionMethod": enum (CollectionMethod),
  "transactionId": string,
  "aggregatorName": string,
  "subclientName": string,
  "publisherName": string,
  "publisherFavicon": string,
  "reviewerId": string,
  "reviewerIsAnonymous": boolean,
  "reviewerUsername": string,
  "reviewLanguage": string,
  "reviewCountry": string,
  "title": string,
  "content": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "isSpam": boolean
}
Champs
reviewTime

string (Timestamp format)

Obligatoire. Code temporel indiquant la date de rédaction de l'avis.
pros[]

string

Facultatif. Inclut les avantages compte tenu de l'avis de l'auteur de l'avis. N'utilisez pas le texte récurrent tel que "pro:", sauf s'il a été rédigé par l'examinateur.
cons[]

string

Facultatif. Indique les inconvénients selon l'avis de l'auteur de l'avis. Supprimez les textes récurrents tels que "Inconvénient:", sauf s'ils ont été rédigés par l'auteur de l'avis.
productNames[]

string

Facultatif. Nom descriptif d'un produit.
asins[]

string

Facultatif. Contient des numéros ASIN (Amazon Standard Identification Number) associés à un produit.
gtins[]

string

Facultatif. Indique les codes GTIN (code article international) associés à un produit. Les sous-types de codes GTIN (par exemple, UPC, EAN, ISBN ou JAN) sont acceptés.
mpns[]

string

Facultatif. Indique les références fabricant associées à un produit.
skus[]

string

Facultatif. Contient les codes SKU (unités de gestion des stocks) associés à un produit. Il s'agit souvent de l'ID de l'offre produit dans le flux de produits.
brands[]

string

Facultatif. Contient des noms de marque associés à un produit.
collectionMethod

enum (CollectionMethod)

Facultatif. Méthode utilisée pour recueillir l'avis.
transactionId

string

Facultatif. 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.
aggregatorName

string

Facultatif. Nom de l'agrégateur des avis sur les produits.

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.
subclientName

string

Facultatif. Nom du sous-client des avis sur les produits.

Le sous-client est un identifiant de la source des avis sur les produits. Il doit être équivalent au répertoire indiqué dans le chemin d'accès de la source de données de fichier.
publisherName

string

Facultatif. Nom de l'éditeur des avis sur les produits.

Informations sur l'éditeur, qui peut être un revendeur, un fabricant, une société de services d'avis sur les produits ou toute entité qui publie des avis sur les produits.
publisherFavicon

string

Facultatif. Lien vers la favicon de l'entreprise de l'éditeur. Les dimensions de l'image doivent correspondre à celles d'une favicon: 16 x 16 pixels. L'image doit être au format GIF, JPG ou PNG.
reviewerId

string

Facultatif. Auteur de l'avis sur le produit.

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

boolean

Facultatif. Définissez cette valeur sur "true" si l'auteur de l'avis doit rester anonyme.
reviewerUsername

string

Facultatif. Nom de l'auteur de l'avis sur le produit.
reviewLanguage

string

Facultatif. Langue de l'avis définie par le code de langue BCP-47.
reviewCountry

string

Facultatif. Pays de l'avis, défini par le code pays ISO 3166-1 alpha-2.
title

string

Facultatif. Titre de l'avis.
content

string

Obligatoire. Contenu de l'avis.
minRating

string (int64 format)

Facultatif. Inclut les notes associées à l'avis. Nombre minimal possible pour la note. Il doit s'agir de la note la plus basse possible et ne pas correspondre à une valeur indiquant l'absence de note.
maxRating

string (int64 format)

Facultatif. Nombre maximal possible pour la note. La valeur de l'attribut "maxRating" doit être supérieure à celle de l'attribut "minRating".
rating

number

Facultatif. Note globale attribuée par l'auteur de l'avis au produit.
isSpam

boolean

Facultatif. Indique si l'avis est marqué comme spam dans le système de l'éditeur.

Type

Type de l'URI de l'avis.

Enums
TYPE_UNSPECIFIED Type non spécifié
SINGLETON La page des avis ne contient qu'un seul avis.
GROUP La page des avis contient un groupe d'avis, dont celui-ci.

CollectionMethod

Méthode utilisée pour collecter l'avis.

Enums
COLLECTION_METHOD_UNSPECIFIED Méthode de collecte non spécifiée.
UNSOLICITED L'utilisateur ne répondait pas à une sollicitation spécifique lorsqu'il a envoyé l'avis.
POST_FULFILLMENT L'utilisateur a envoyé l'avis en réponse à une sollicitation après la livraison de sa commande.

ProductReviewStatus

État de l'évaluation du produit.

Représentation JSON 
{
  "destinationStatuses": [
    {
      object (ProductReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ProductReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
Champs
destinationStatuses[]

object (ProductReviewDestinationStatus)

Uniquement en sortie. Destinations prévues pour l'avis sur le produit
itemLevelIssues[]

object (ProductReviewItemLevelIssue)

Uniquement en sortie. Liste de tous les problèmes associés à l'avis sur le produit.
createTime

string (Timestamp format)

Uniquement en sortie. Date de création de l'article, au format ISO 8601.
lastUpdateTime

string (Timestamp format)

Uniquement en sortie. Date de la dernière mise à jour de l'article, au format ISO 8601.

ProductReviewDestinationStatus

État de destination de l'état de l'avis sur le produit.

Représentation JSON 
{
  "reportingContext": enum (ReportingContextEnum)
}
Champs
reportingContext

enum (ReportingContextEnum)

Uniquement en sortie. Nom du contexte de création de rapports.

ProductReviewItemLevelIssue

ItemLevelIssue de l'état de l'examen du produit.

Représentation JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string
}
Champs
code

string

Uniquement en sortie. Code d'erreur du problème
severity

enum (Severity)

Uniquement en sortie. Indique comment ce problème affecte la diffusion de l'avis sur le produit
resolution

string

Uniquement en sortie. Indique si le problème peut être résolu par le marchand
attribute

string

Uniquement en sortie. Si le problème est causé par un attribut unique, nom de cet attribut
reportingContext

enum (ReportingContextEnum)

Uniquement en sortie. Contexte des rapports auquel le problème s'applique.
description

string

Uniquement en sortie. Une brève description du problème en anglais.
detail

string

Uniquement en sortie. Description détaillée du problème en anglais
documentation

string

Uniquement en sortie. URL d'une page Web d'aide pour résoudre ce problème

Gravité

Indique comment le problème affecte la diffusion de l'avis sur le produit

Enums
SEVERITY_UNSPECIFIED Non spécifié.
NOT_IMPACTED Il s'agit d'un avertissement qui n'a pas d'incidence directe sur l'avis sur le produit.
DISAPPROVED Le problème entraîne le refus de l'avis sur le produit.

Méthodes

delete

 Supprime un avis sur un produit.

get

 Permet d'obtenir un avis sur un produit.

insert

 Insère un avis sur un produit.

list

 Répertorie les avis sur les produits.