Oto przykładowe zapytanie do narzędzia MerchantPerformanceView, które zwróci skuteczność konta w ciągu ostatnich 30 dni. Zapytanie jest podzielone na segmenty według danych program i offer_id. Aby zapoznać się z usługą Reports, wykonaj ten krótki przykład.
Aby pobrać ten raport, musisz mieć rolę menedżera raportującego.
Aby wysłać żądanie, przekaż do metody reports.search tę instrukcję języka zapytań Merchant Center:
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'
Kliknij Uruchom, aby wypróbować przykład w API Explorer. Gdy klikniesz Wykonaj, zaktualizuj obiekt zastępczy identyfikatora sprzedawcy w adres URL żądania, podając swój własny identyfikator. Możesz je zmodyfikować. Aby umożliwić działanie eksploratora interfejsów API, pełne zapytanie musi pozostać w 1 wierszu.
Adres URL żądania HTTP
Żądanie składa się z protokołu HTTP POST wysyłanego do serwera Content API for Shopping pod tym adresem URL:
https://shoppingcontent.googleapis.com/content/v2.1/merchantId/reports/search
Przykładowe pełne żądanie HTTP
Oto pełny przykład z definicją raportu umieszczoną w żądaniu 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'"
}