REST Resource: accounts.productReviews

Risorsa: ProductReview

Una recensione di un prodotto. Per ulteriori informazioni, consulta la sezione Introduzione ai feed delle recensioni prodotto.

Rappresentazione JSON 
{
  "name": string,
  "productReviewId": string,
  "attributes": {
    object (ProductReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "productReviewStatus": {
    object (ProductReviewStatus)
  }
}
Campi
name

string

Identificatore. Il nome della recensione del prodotto. Formato: "{productreview.name=accounts/{account}/productReviews/{productReview}}"
productReviewId

string

Obbligatorio. L'identificatore univoco permanente della recensione prodotto nel sistema del publisher.
attributes

object (ProductReviewAttributes)

(Facoltativo) Un elenco di attributi delle recensioni prodotto.
customAttributes[]

object (CustomAttribute)

(Facoltativo) Un elenco di attributi personalizzati (forniti dal commerciante).
dataSource

string

Solo output. L'origine dati principale della recensione prodotto.
productReviewStatus

object (ProductReviewStatus)

Solo output. Lo stato di una recensione prodotto, i problemi di convalida dei dati, ovvero le informazioni su una recensione prodotto calcolate in modo asincrono.

ProductReviewAttributes

Attributi.

Rappresentazione 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
}
Campi
reviewTime

string (Timestamp format)

Obbligatorio. Il timestamp che indica quando è stata scritta la recensione.
pros[]

string

(Facoltativo) Contiene i vantaggi in base all'opinione del recensore. Ometti il testo boilerplate come "pro:", a meno che non sia stato scritto dal recensore.
cons[]

string

(Facoltativo) Contiene gli svantaggi in base all'opinione del recensore. Ometti il testo boilerplate come "contro:", a meno che non sia stato scritto dal recensore.
productNames[]

string

(Facoltativo) Nome descrittivo di un prodotto.
asins[]

string

(Facoltativo) Contiene gli ASIN (Amazon Standard Identification Numbers) associati a un prodotto.
gtins[]

string

(Facoltativo) Contiene i GTIN (Global Trade Item Number) associati a un prodotto. Sono supportati sottotipi di GTIN (ad es. UPC, EAN, ISBN, JAN).
mpns[]

string

(Facoltativo) Contiene gli MPN (Manufacturer Part Number) associati a un prodotto.
skus[]

string

(Facoltativo) Contiene gli SKU (codice identificativo dell'articolo) associati a un prodotto. Spesso corrisponde all'ID offerta del prodotto nel feed dei prodotti.
brands[]

string

(Facoltativo) Contiene i nomi dei brand associati a un prodotto.
collectionMethod

enum (CollectionMethod)

(Facoltativo) Il metodo utilizzato per raccogliere la recensione.
transactionId

string

(Facoltativo) Un identificatore univoco permanente per la transazione associata alla recensione nel sistema del publisher. Questo ID può essere utilizzato per indicare che più recensioni sono associate alla stessa transazione.
aggregatorName

string

(Facoltativo) Il nome dell'aggregatore delle recensioni prodotto.

Un editore può utilizzare un aggregatore di recensioni per gestire le recensioni e fornire i feed. Questo elemento indica l'utilizzo di un aggregatore e contiene informazioni sull'aggregatore.
subclientName

string

(Facoltativo) Il nome del subclient delle recensioni prodotto.

Il subclient è un identificatore dell'origine della recensione prodotto. Deve essere equivalente alla directory fornita nel percorso dell'origine dati del file.
publisherName

string

(Facoltativo) Il nome dell'editore delle recensioni prodotto.

Le informazioni sul publisher, che può essere un rivenditore, un produttore, una società di servizi per le recensioni o qualsiasi persona giuridica che pubblica recensioni prodotto.
publisherFavicon

string

(Facoltativo) Un link alla favicon dell'azienda del publisher. Le dimensioni dell'immagine devono essere le dimensioni della favicon: 16 x 16 pixel. Il formato dell'immagine deve essere GIF, JPG o PNG.
reviewerId

string

(Facoltativo) L'autore della recensione del prodotto.

Un identificatore univoco permanente dell'autore della recensione nel sistema del publisher.
reviewerIsAnonymous

boolean

(Facoltativo) Imposta su true se il recensore deve rimanere anonimo.
reviewerUsername

string

(Facoltativo) Il nome del recensore della recensione del prodotto.
reviewLanguage

string

(Facoltativo) La lingua della recensione definita dal codice lingua BCP-47.
reviewCountry

string

(Facoltativo) Il paese della recensione definito dal codice paese ISO 3166-1 alpha-2.
title

string

(Facoltativo) Il titolo della recensione.
content

string

Obbligatorio. I contenuti della recensione.
minRating

string (int64 format)

(Facoltativo) Contiene le valutazioni associate alla recensione. Il numero minimo possibile per la valutazione. Deve essere la valutazione peggiore possibile e non deve essere un valore per nessuna valutazione.
maxRating

string (int64 format)

(Facoltativo) Il numero massimo possibile per la valutazione. Il valore della valutazione massima deve essere maggiore del valore dell'attributo min.
rating

number

(Facoltativo) La valutazione complessiva del prodotto da parte del recensore.
isSpam

boolean

(Facoltativo) Indica se la recensione è contrassegnata come spam nel sistema del publisher.

Tipo

Tipo di URI della recensione.

Enum
TYPE_UNSPECIFIED Tipo non specificato.
SINGLETON La pagina della recensione contiene solo questa singola recensione.
GROUP La pagina delle recensioni contiene un gruppo di recensioni, inclusa questa.

CollectionMethod

Il metodo utilizzato per raccogliere la recensione.

Enum
COLLECTION_METHOD_UNSPECIFIED Metodo di raccolta non specificato.
UNSOLICITED L'utente non ha risposto a una richiesta specifica quando ha inviato la recensione.
POST_FULFILLMENT L'utente ha inviato la recensione in risposta a una richiesta dopo l'evasione dell'ordine.

ProductReviewStatus

Stato di revisione prodotto.

Rappresentazione JSON 
{
  "destinationStatuses": [
    {
      object (ProductReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ProductReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
Campi
destinationStatuses[]

object (ProductReviewDestinationStatus)

Solo output. Le destinazioni previste per la recensione del prodotto.
itemLevelIssues[]

object (ProductReviewItemLevelIssue)

Solo output. Un elenco di tutti i problemi associati alla recensione del prodotto.
createTime

string (Timestamp format)

Solo output. Data di creazione dell'elemento, nel formato ISO 8601.
lastUpdateTime

string (Timestamp format)

Solo output. Data dell'ultimo aggiornamento dell'elemento, in formato ISO 8601.

ProductReviewDestinationStatus

Lo stato di destinazione dello stato della revisione del prodotto.

Rappresentazione JSON 
{
  "reportingContext": enum (ReportingContextEnum)
}
Campi
reportingContext

enum (ReportingContextEnum)

Solo output. Il nome del contesto report.

ProductReviewItemLevelIssue

Il problema a livello di articolo dello stato della revisione del prodotto.

Rappresentazione JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string
}
Campi
code

string

Solo output. Il codice di errore del problema.
severity

enum (Severity)

Solo output. In che modo questo problema influisce sulla pubblicazione della recensione del prodotto.
resolution

string

Solo output. Indica se il problema può essere risolto dal commerciante.
attribute

string

Solo output. Il nome dell'attributo, se il problema è causato da un singolo attributo.
reportingContext

enum (ReportingContextEnum)

Solo output. Il contesto dei report a cui si applica il problema.
description

string

Solo output. Una breve descrizione del problema in inglese.
detail

string

Solo output. Una descrizione dettagliata del problema in inglese.
documentation

string

Solo output. L'URL di una pagina web che possa aiutarci a risolvere il problema.

Gravità

Il modo in cui il problema influisce sulla pubblicazione della recensione prodotto.

Enum
SEVERITY_UNSPECIFIED Non specificato.
NOT_IMPACTED Questo problema rappresenta un avviso e non ha un impatto diretto sulla recensione del prodotto.
DISAPPROVED Il problema non approva la recensione del prodotto.

Metodi

delete

 Consente di eliminare una recensione prodotto.

get

 Riceve una recensione del prodotto.

insert

 Inserisce una recensione prodotto.

list

 Elenca le recensioni prodotto.