MerchantPerformanceView に対するサンプルクエリを次に示します。このクエリは、過去 30 日間のアカウントのパフォーマンスを programoffer_id で分割して返します。Reports サービスを理解するには、次の簡単な例を試してください。

このレポートを取得するには、レポート マネージャーのロールが必要です。

リクエストを実行するには、次の Merchant Center Query Language ステートメントを 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'"
}