REST Resource: accounts.merchantReviews

Risorsa: MerchantReview

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

Rappresentazione JSON 
{
  "name": string,
  "merchantReviewId": string,
  "attributes": {
    object (MerchantReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "merchantReviewStatus": {
    object (MerchantReviewStatus)
  }
}
Campi
name

string

Identificatore. Il nome della recensione del commerciante. Formato: "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"
merchantReviewId

string

Obbligatorio. L'utente ha fornito l'ID recensione del commerciante per identificare in modo univoco la recensione del commerciante.
attributes

object (MerchantReviewAttributes)

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

object (CustomAttribute)

Obbligatorio. Un elenco di attributi personalizzati (forniti dal commerciante). Può essere utilizzato anche per inviare qualsiasi attributo della specifica dei dati nella sua forma generica (ad es. { "name": "size type", "value": "regular" }). Questo è utile per inviare attributi non esposti esplicitamente dall'API, come gli attributi sperimentali. Il numero massimo di caratteri consentito per ogni attributo personalizzato è 10240 (rappresenta la somma dei caratteri per il nome e il valore). È possibile impostare un massimo di 2500 attributi personalizzati per prodotto, con dimensioni totali di 102,4 kB. I trattini bassi nei nomi degli attributi personalizzati vengono sostituiti da spazi al momento dell'inserimento.
dataSource

string

Solo output. L'origine dati principale della recensione del commerciante.
merchantReviewStatus

object (MerchantReviewStatus)

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

MerchantReviewAttributes

Attributi.

Rappresentazione JSON 
{
  "merchantId": string,
  "merchantDisplayName": string,
  "merchantLink": string,
  "merchantRatingLink": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "title": string,
  "content": string,
  "reviewerId": string,
  "reviewerUsername": string,
  "isAnonymous": boolean,
  "collectionMethod": enum (CollectionMethod),
  "reviewTime": string,
  "reviewLanguage": string,
  "reviewCountry": string
}
Campi
merchantId

string

Obbligatorio. Deve essere univoco e stabile in tutte le richieste. In altre parole, se una richiesta di oggi e un'altra di 90 giorni fa fanno riferimento allo stesso commerciante, devono avere lo stesso ID.
merchantDisplayName

string

(Facoltativo) Nome visualizzato leggibile per il commerciante.
minRating

string (int64 format)

(Facoltativo) Il numero minimo possibile per la classificazione. Deve essere la valutazione peggiore possibile e non deve essere un valore se non è disponibile una valutazione.
maxRating

string (int64 format)

(Facoltativo) Il numero massimo possibile per la valutazione. Il valore della valutazione massima deve essere maggiore del valore della valutazione minima.
rating

number

(Facoltativo) La valutazione complessiva del commerciante da parte del recensore.
title

string

(Facoltativo) Il titolo della recensione.
content

string

Obbligatorio. Deve essere un testo libero fornito dall'utente e non deve essere troncato. Se vengono fornite più risposte a domande diverse, devono essere incluse tutte le risposte, con il contesto minimo necessario per dare un senso alle risposte. Non è necessario fornire il contesto se le domande sono rimaste senza risposta.
reviewerId

string

(Facoltativo) Un identificatore univoco permanente dell'autore della recensione nel sistema dell'editore.
reviewerUsername

string

(Facoltativo) Nome visualizzato dell'autore della recensione.
isAnonymous

boolean

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

enum (CollectionMethod)

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

string (Timestamp format)

Obbligatorio. Il timestamp che indica quando è stata scritta la recensione.
reviewLanguage

string

Obbligatorio. La lingua della recensione definita dal codice lingua BCP-47.
reviewCountry

string

(Facoltativo) Il paese in cui l'autore della recensione ha effettuato l'ordine, definito dal codice paese ISO 3166-1 alpha-2.

CollectionMethod

Il metodo utilizzato per raccogliere la recensione.

Enum
COLLECTION_METHOD_UNSPECIFIED Metodo di raccolta non specificato.
MERCHANT_UNSOLICITED L'utente non stava rispondendo a una richiesta specifica quando ha inviato la recensione.
POINT_OF_SALE L'utente ha inviato la recensione in risposta a una richiesta quando ha effettuato un ordine.
AFTER_FULFILLMENT L'utente ha inviato la recensione in risposta a una richiesta dopo l'evasione dell'ordine.

MerchantReviewStatus

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

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

object (MerchantReviewDestinationStatus)

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

object (MerchantReviewItemLevelIssue)

Solo output. Un elenco di tutti i problemi associati alla recensione del commerciante.
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.

MerchantReviewDestinationStatus

Lo stato di destinazione dello stato della revisione del commerciante.

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

enum (ReportingContextEnum)

Solo output. Il nome del contesto report.

MerchantReviewItemLevelIssue

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

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 commerciante.
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à

In che modo il problema influisce sulla pubblicazione della recensione del commerciante.

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

Metodi

delete

 Consente di eliminare la recensione del commerciante.

get

 Riceve una recensione del commerciante.

insert

 Inserisce una recensione per il tuo account Merchant Center.

list

 Elenca le recensioni del commerciante.