Package google.shopping.merchant.reviews.v1beta

Indice

MerchantReviewsService

Servizio per gestire le recensioni dei commercianti.

DeleteMerchantReview

rpc DeleteMerchantReview(DeleteMerchantReviewRequest) returns (Empty)

Consente di eliminare la recensione del commerciante.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
GetMerchantReview

rpc GetMerchantReview(GetMerchantReviewRequest) returns (MerchantReview)

Riceve una recensione del commerciante.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
InsertMerchantReview

rpc InsertMerchantReview(InsertMerchantReviewRequest) returns (MerchantReview)

Inserisce una recensione per il tuo account Merchant Center. Se la recensione esiste già, viene sostituita dalla nuova istanza.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
ListMerchantReviews

rpc ListMerchantReviews(ListMerchantReviewsRequest) returns (ListMerchantReviewsResponse)

Elenca le recensioni del commerciante.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

ProductReviewsService

Servizio per gestire le recensioni prodotto.

DeleteProductReview

rpc DeleteProductReview(DeleteProductReviewRequest) returns (Empty)

Consente di eliminare una recensione prodotto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
GetProductReview

rpc GetProductReview(GetProductReviewRequest) returns (ProductReview)

Riceve una recensione del prodotto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
InsertProductReview

rpc InsertProductReview(InsertProductReviewRequest) returns (ProductReview)

Inserisce una recensione prodotto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
ListProductReviews

rpc ListProductReviews(ListProductReviewsRequest) returns (ListProductReviewsResponse)

Elenca le recensioni prodotto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

DeleteMerchantReviewRequest

Messaggio di richiesta per il metodo DeleteMerchantReview.

Campi
name

string

Obbligatorio. L'ID della recensione del commerciante. Formato: accounts/{account}/merchantReviews/{merchantReview}

DeleteProductReviewRequest

Messaggio di richiesta per il metodo DeleteProductReview.

Campi
name

string

Obbligatorio. L'ID della recensione del prodotto. Formato: accounts/{account}/productReviews/{productReview}

GetMerchantReviewRequest

Messaggio di richiesta per il metodo GetMerchantReview.

Campi
name

string

Obbligatorio. L'ID della recensione del commerciante. Formato: accounts/{account}/merchantReviews/{merchantReview}

GetProductReviewRequest

Messaggio di richiesta per il metodo GetProductReview.

Campi
name

string

Obbligatorio. L'ID della recensione del commerciante. Formato: accounts/{account}/productReviews/{productReview}

InsertMerchantReviewRequest

Messaggio di richiesta per il metodo InsertMerchantReview.

Campi
parent

string

Obbligatorio. L'account in cui verrà inserita la recensione del commerciante. Formato: accounts/{account}
merchant_review

MerchantReview

Obbligatorio. La recensione del commerciante da inserire.
data_source

string

Obbligatorio. L'origine dati del formato merchantreview: accounts/{account}/dataSources/{datasource}.

InsertProductReviewRequest

Messaggio di richiesta per il metodo InsertProductReview.

Campi
parent

string

Obbligatorio. L'account in cui verrà inserita la recensione del prodotto. Formato: accounts/{account}
product_review

ProductReview

Obbligatorio. La recensione prodotto da inserire.
data_source

string

Obbligatorio. Formato: accounts/{account}/dataSources/{datasource}.

ListMerchantReviewsRequest

Messaggio di richiesta per il metodo ListMerchantsReview.

Campi
parent

string

Obbligatorio. L'account per cui elencare le recensioni del commerciante. Formato: accounts/{account}
page_size

int32

(Facoltativo) Il numero massimo di recensioni del commerciante da restituire. Il servizio può restituire meno di questo valore. Il valore massimo è 1000; i valori superiori a 1000 vengono forzati a 1000. Se non specificato, viene restituito il numero massimo di recensioni.
page_token

string

(Facoltativo) Un token di pagina ricevuto da una chiamata ListMerchantReviews precedente. Fornisci questo valore per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListMerchantReviews devono corrispondere alla chiamata che ha fornito il token pagina.

ListMerchantReviewsResponse

Messaggio di risposta per il metodo ListMerchantsReview.

Campi
merchant_reviews[]

MerchantReview

La recensione del commerciante.
next_page_token

string

Il token per recuperare la pagina di risultati successiva.

ListProductReviewsRequest

Messaggio di richiesta per il metodo ListProductReviews.

Campi
parent

string

Obbligatorio. L'account per cui elencare le recensioni prodotto. Formato: accounts/{account}
page_size

int32

(Facoltativo) Il numero massimo di prodotti da restituire. Il servizio potrebbe restituire meno di questo valore.
page_token

string

(Facoltativo) Un token di pagina ricevuto da una chiamata ListProductReviews precedente. Fornisci questo valore per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListProductReviews devono corrispondere alla chiamata che ha fornito il token pagina.

ListProductReviewsResponse

messaggio di risposta per il metodo ListProductReviews.

Campi
product_reviews[]

ProductReview

La recensione del prodotto.
next_page_token

string

Un token che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

MerchantReview

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

Campi
name

string

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

string

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

MerchantReviewAttributes

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

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

string

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

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.

Campi
merchant_id

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

string

(Facoltativo) Nome visualizzato leggibile del commerciante.
min_rating

int64

(Facoltativo) Il numero minimo possibile per la valutazione. Deve essere la valutazione peggiore possibile e non deve essere un valore per nessuna valutazione.
max_rating

int64

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

double

(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.
reviewer_id

string

(Facoltativo) Un identificatore univoco permanente dell'autore della recensione nel sistema del publisher.
reviewer_username

string

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

bool

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

CollectionMethod

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

Timestamp

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

string

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

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.

Campi
destination_statuses[]

MerchantReviewDestinationStatus

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

MerchantReviewItemLevelIssue

Solo output. Un elenco di tutti i problemi associati alla recensione del commerciante.
create_time

Timestamp

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

Timestamp

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

MerchantReviewDestinationStatus

Lo stato di destinazione dello stato della revisione del commerciante.

Campi
reporting_context

ReportingContextEnum

Solo output. Il nome del contesto report.

MerchantReviewItemLevelIssue

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

Campi
code

string

Solo output. Il codice di errore del problema.
severity

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

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 recensione del commerciante.

ProductReview

Una recensione di un prodotto. Per saperne di più, consulta la sezione Introduzione ai feed delle recensioni prodotto

Campi
name

string

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

string

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

ProductReviewAttributes

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

CustomAttribute

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

string

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

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.

Campi
review_time

Timestamp

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.
product_names[]

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 i sottotipi di GTIN (ad es. UPC, EAN, ISBN, JAN).
mpns[]

string

(Facoltativo) Contiene i codici 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.
collection_method

CollectionMethod

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

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

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

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 file.
publisher_name

string

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

Le informazioni sull'editore, che può essere un rivenditore, un produttore, una società di servizi di recensioni o qualsiasi entità che pubblichi recensioni di prodotti.
publisher_favicon

string

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

string

(Facoltativo) L'autore della recensione prodotto.

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

bool

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

string

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

string

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

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

int64

(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.
max_rating

int64

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

double

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

bool

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

CollectionMethod

Il metodo utilizzato per raccogliere la recensione.

Enum
COLLECTION_METHOD_UNSPECIFIED Metodo di raccolta non specificato.
UNSOLICITED L'utente non stava rispondendo 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.

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.

ProductReviewStatus

Stato della revisione del prodotto.

Campi
destination_statuses[]

ProductReviewDestinationStatus

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

ProductReviewItemLevelIssue

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

Timestamp

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

Timestamp

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

ProductReviewDestinationStatus

Lo stato di destinazione dello stato della revisione del prodotto.

Campi
reporting_context

ReportingContextEnum

Solo output. Il nome del contesto report.

ProductReviewItemLevelIssue

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

Campi
code

string

Solo output. Il codice di errore del problema.
severity

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

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