Esempio

Ecco una query di esempio per MerchantPerformanceView che restituisce il rendimento del tuo account negli ultimi 30 giorni, segmentato per program e offer_id. Puoi provare questo rapido esempio per acquisire familiarità con il servizio Reports.

Per recuperare questo report, devi disporre del ruolo Gestore dei report.

Per effettuare la richiesta, passa la seguente istruzione relativa alla lingua di query di Merchant Center al metodo reports.search:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

Corsa

Fai clic su Esegui per provare l'esempio in Explorer API. Dopo aver fatto clic su Esegui, aggiorna il segnaposto dell'ID commerciante con il tuo ID commerciante nell'URL della richiesta. Puoi modificare la query. Per poter funzionare con Explorer API, la query completa deve rimanere su una sola riga.

Nota: questa guida mostra la richiesta HTTP di base come strumento didattico, ma ti consigliamo di utilizzare una delle librerie client per inviare le tue richieste.

URL richiesta HTTP

La richiesta è composta da una richiesta POST HTTP al server Content API for Shopping al seguente URL:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/reports/search

Esempio di richiesta HTTP completa

Ecco un esempio completo che mostra la definizione del report riportata sopra racchiusa in una richiesta POST HTTP:

POST /v2.1/merchantId/reports/search HTTP/1.1
Host: shoppingcontent.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer access token

Parameters:
{
  "query" : "SELECT segments.program, segments.offer_id, metrics.impressions,
                    metrics.clicks, metrics.ctr
            FROM MerchantPerformanceView
            WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'"
}