Esaminare i prodotti utilizzando l'API Merchant

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.