以下は、MerchantPerformanceView
に対するクエリの例です。このクエリは、過去 30 日間のアカウントのパフォーマンスを program
と offer_id
別に分類したものです。以下の簡単な例を使って、Reports
サービスの使い方を理解できます。
このレポートを取得するには、レポート マネージャーのロールが必要です。
リクエストを行うには、次の Merchant Center クエリ言語ステートメントを 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'
[実行] をクリックして、API Explorer でサンプルを試します。[実行] をクリックしたら、リクエスト URL 内の販売者 ID プレースホルダを販売者 ID に更新します。クエリを変更できます。API Explorer で作業するには、クエリ全体を 1 行のままにする必要があります。
HTTP リクエストの URL
リクエストは、次の URL の Content API for Shopping サーバーへの HTTP POST で構成されます。
https://shoppingcontent.googleapis.com/content/v2.1/merchantId/reports/search
完全な HTTP リクエストのサンプル
以下に、HTTP POST リクエスト内に含まれている上記のレポート定義の例を示します。
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'" }