Le recensioni dei prodotti sono un aspetto 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 positive possono generare i clienti alle pagine dei prodotti di un venditore. Le fonti includono venditori, recensione aggregatori, 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 di valutazioni dei prodotti. Se non sai se hai già effettuato la registrazione, controlla Merchant Center. Se non registrato, scopri di più sulla registrazione per le valutazioni dei prodotti .
- Per recensire 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 un'istanza esistente
feed delle recensioni prodotto disponibile, utilizza accounts.dataSources.get per recuperare il
accounts.dataSources.name. Il modulo della richiesta è il 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"
}
Creare una recensione del prodotto
Puoi usare il metodo accounts.productreviews.insert per creare o aggiornare un
la recensione di un prodotto. Il metodo accounts.productreviews.insert richiede un
productreview risorsa e un nome origine dati come input. Restituisce il codice
aggiornato productreview, se riuscito. Per creare una recensione prodotto, devi:
avere un
datasource.name
La forma della richiesta:
POST https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/{accountId}/}productReviews:insert
La seguente richiesta di esempio illustra come creare una recensione prodotto.
POST https://merchantapi.googleapis.com/reviews/v1beta/accounts/{accountId}/productReviews:insert?dataSource=accounts/{accountId}/dataSources/{dataSourceId}
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 aver creato una recensione prodotto, potrebbero essere necessari alcuni minuti propagarsi.
Visualizza le recensioni prodotto
Per visualizzare una recensione prodotto, utilizza accounts.productreviews.get. Questa funzionalità è 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 recensione prodotto corrispondente.
GET https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/{accountId}/productReviews/*}
Elenca recensioni prodotto
Puoi utilizzare il metodo productreviews.list per visualizzare tutti i prodotti creati
le recensioni.
GET https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/{accountId}}/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/{accountId}/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.