Reports サービスを使用すると、アカウントのパフォーマンス指標を取得できます。
使用可能な指標の一覧については、metrics のドキュメントをご覧ください。
要件
このレポートを取得するには、レポート マネージャーのロールが必要です。
アカウントにレポート マネージャーのロールを付与するには、accounts.update を使用して reportingManager フィールドを true に設定します。レポート マネージャーのロールは、Merchant Center のパフォーマンスと分析情報のロールに相当します。
accounts.update は、Account リソース全体を置き換えます。情報が失われないように、accounts.get を使用して Account リソース全体を取得し、accounts.update リクエスト内のすべてのフィールドを指定します。
クエリの例
次のクエリは、特定の 30 日間のアカウント内のすべての商品の impressions、clicks、ctr を取得します。リクエストを行うには、次の Merchant Center のクエリ言語ステートメントを reports.search メソッドに渡します。
SELECT
metrics.impressions,
metrics.clicks,
metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'
[Run] をクリックして、API Explorer でサンプルを試します。[実行] をクリックしたら、リクエスト URL の販売者 ID プレースホルダをご自身の販売者 ID に更新します。クエリを変更できます。API Explorer を使用するには、クエリ全体を 1 行で入力する必要があります。
クエリの指標をセグメント化して、より詳細なパフォーマンス レポートを作成することもできます。
Reports サービスを使用して商品を取得してフィルタする方法については、プロダクト ガイドをご覧ください。