次の MerchantPerformanceView へのクエリの例では、過去 30 日間のアカウントのパフォーマンスを programoffer_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'"
}