リクエストでは Merchant Center のクエリ言語を使用します。これにより、以下を選択できます。
セグメントを使用して指標の妥当性を
決定します
レスポンスのサマリーと、期間を選択するための追加のフィルタ
その他の条件も考慮しますGoogle 広告のレポート機能も
API に関するものでは、これらのコンセプトの多くは類似しています。
一般的なユースケースとしては、アカウントのパフォーマンスを要約することが挙げられます。
過去 30 日間のデータを program と offer_id 別に分割したものです。以下は、
次のクエリを検索します。
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'
このリクエストを発行するには、次の Merchant Center Query Language ステートメントを渡します。
reports.search メソッドに追加します。
リクエストは、次の URL にある Content API for Shopping サーバーへの HTTP POST で構成されます。
次の URL に送信します(merchantId を販売者 ID に置き換えます)。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2026-02-18 UTC。"],[],["Merchants can access free listing performance data, including clicks and impressions, across Google platforms. This data is retrievable via the Reporting API using Merchant Center Query Language. Requests, sent as HTTP POSTs, allow users to filter and segment data (e.g., by program, offer ID, and date range). The `reports.search` method is used to issue queries. Access requires the *reporting manager* role. Results can be cross-checked with the Google Merchant Center platform.\n"]]