Le recensioni dei prodotti sono una parte importante dell'esperienza di acquisto per i clienti. Queste valutazioni e recensioni sono utili per la ricerca del prodotto e le decisioni di acquisto. Le recensioni dei prodotti positive possono attirare un maggior numero di clienti qualificati sulle pagine dei prodotti di un venditore. tra cui commercianti, aggregatori di recensioni, siti di recensioni e utenti Google.
Questa pagina spiega come gestire le recensioni dei prodotti utilizzando l'API Merchant.
Prerequisiti
Google ha bisogno che tu fornisca informazioni specifiche. Devi disporre di quanto segue:
- Un feed delle recensioni prodotto attivo in Google Merchant Center.
- Il tuo account deve essere registrato al programma per le valutazioni dei prodotti. Se non hai la certezza di aver già effettuato la registrazione, controlla in Merchant Center. Se non hai ancora effettuato la registrazione, scopri di più su come partecipare al programma per le valutazioni dei prodotti.
- Per esaminare i prodotti utilizzando l'API Merchant, invia una richiesta utilizzando questo modulo.
Creare un'origine dati
Utilizza l'API datasource.create
per creare un feed di recensioni prodotto. Se è disponibile un
feed delle recensioni prodotto, utilizza accounts.dataSources.get
per recuperare il
accounts.dataSources.name
. La forma della richiesta è la seguente:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{account}/dataSources/{datasource}
Esempio
L'esempio mostra una richiesta e una risposta tipiche.
Richiedi
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "productReviewDataSource":{} }
Risposta
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api feed",
"productReviewDataSource": {},
"input": "API"
}
Per saperne di più, consulta la Panoramica dell'API Merchant Data Tasks.
Creare una recensione del prodotto
Puoi utilizzare il metodo accounts.productreviews.insert
per creare o aggiornare una recensione del prodotto. Il metodo accounts.productreviews.insert
accetta come input una risorsa productreview
e il nome di un'origine dati. Restituisce il nuovo o aggiornato productreview
, se l'operazione ha esito positivo. Per creare una recensione prodotto, devi avere un
datasource.name
.
La forma della richiesta:
POST https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/{ACCOUNT_ID}/}productReviews:insert
La seguente richiesta di esempio illustra come creare una recensione prodotto.
POST https://merchantapi.googleapis.com/reviews/v1beta/accounts/{ACCOUNT_ID}/productReviews:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
productReviewId = 'my_product_review'
attributes {
aggregatorName = 'aggregator_name'
subclientName = 'subclient_name'
publisherName = 'publisher_name'
publisherFavicon = 'https://www.google.com/favicon.ico'
reviewerId = 'reviewer_id'
reviewerIsAnonymous = false
reviewerUsername = 'reviewer_username'
reviewLanguage = 'en'
reviewCountry = 'US'
reviewTime = '2024-04-01T00:00:00Z'
title = 'Incredible product'
content = 'This is an incredible product.'
pros = ['pro1', 'pro2']
cons = ['con1', 'con2']
reviewLink = {
type = 'SINGLETON'
link = 'https://www.google.com'
}
reviewerImageLink = 'https://www.google.com/reviewer.png'
minRating = 1
maxRating = 10
rating = 8.5
productName = 'product_name'
productLink = 'https://www.google.com/product'
asins = ['asin1', 'asin2']
gtins = ['gtin1', 'gtin2']
mpns = ['mpn1', 'mpn2']
skus = ['sku1', 'sku2']
brands = ['brand1', 'brand2']
isSpam = false
collectionMethod = 'POST_FULFILLMENT'
transactionId = 'transaction_id'
}
Dopo la creazione della recensione del prodotto, possono trascorrere alcuni minuti prima che la recensione venga propagata.
Recuperare una recensione del prodotto
Per visualizzare una recensione prodotto, utilizza accounts.productreviews.get
. Questo campo è di sola lettura.
Richiede il tuo accountId
e l'ID della recensione del prodotto come parte del
campo name. Il metodo GET
restituisce la risorsa di recensione prodotto corrispondente.
GET https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/{ACCOUNT_ID}/productReviews/*}
Elenco delle recensioni prodotto
Puoi utilizzare il metodo productreviews.list
per visualizzare tutte le recensioni prodotto create.
GET https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/{ACCOUNT_ID}}/productReviews
Eliminare le recensioni prodotto
Per eliminare una recensione prodotto, utilizza accounts.productreviews.delete
. Analogamente al metodo GET
, questo metodo richiede il campo del nome della recensione prodotto restituito durante la creazione.
DELETE https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/{ACCOUNT_ID}/productReviews/*}
Stato della revisione del prodotto
La risorsa di revisione del prodotto contiene uno stato simile a quello di altre API, che è parte integrante della risorsa e segue la stessa struttura di problemi e destinazioni.