以下は、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'"
}