rocket
Content API for Shopping の正式な後継である
Merchant API をご紹介します。
update
Merchant API の新機能、バグの修正、更新に関する
最新情報を入手してください。
add_alert
注: Content API for Shopping は 2026 年 8 月 18 日に廃止されます。
パフォーマンスの測定
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Reports
サービスを使用して、パフォーマンス
統計情報をご覧ください。
詳細については、metrics
のドキュメントをご覧ください。
利用可能な指標の完全なリストです。
要件
レポート マネージャーが必要
ロールが必要です。
アカウントにレポート マネージャーのロールを付与するには、次のコマンドを使用します。
accounts.update
~
reportingManager
フィールドを true
に設定します。レポートマネージャーの役割は
これは、Merchant Center における「パフォーマンスと分析情報」のロールと同等です。
accounts.update
は Account
リソース全体を置き換えます。accounts.get
を使用して以下を行います。
完全な Account
リソースを取得してから、
accounts.update
リクエストをスキップして、情報を失うことがないようにします。
クエリの例
次のクエリは、すべてのテーブルで impressions
、clicks
、ctr
を取得します。
過去 30 日間の一定期間における
商品の数も確認できますこのリクエストを行うには、
次の Merchant Center クエリ言語ステートメントを
reports.search
メソッド:
SELECT
metrics.impressions,
metrics.clicks,
metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'
実行
[実行] をクリックして、API Explorer でサンプルを試します。[
[Run] に移動し、
リクエスト URL を入力します。クエリを変更できます。クエリ全体を 1 行で入力し、
API Explorer を使用します。
セグメントも
よりきめ細かなパフォーマンスレポートを作成できます
詳しくは、サービスガイドをご覧ください。
Reports
サービスで商品を取得してフィルタします。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eThe \u003ccode\u003eReports\u003c/code\u003e service allows you to retrieve performance metrics, such as impressions, clicks, and click-through rate (CTR), for your account.\u003c/p\u003e\n"],["\u003cp\u003eTo access this service, you must have the Reporting manager role (equivalent to the Performance and insights role in Merchant Center), which can be assigned using the \u003ccode\u003eaccounts.update\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eA comprehensive list of available metrics can be found in the \u003ccode\u003emetrics\u003c/code\u003e documentation, and you can use Merchant Center Query Language to create customized reports.\u003c/p\u003e\n"],["\u003cp\u003eFor more detailed analysis, you can segment your metrics and further explore report functionalities through the provided guides on segmentation and products.\u003c/p\u003e\n"]]],["The `Reports` service retrieves performance metrics, requiring the Reporting manager role. This role is enabled by setting `reportingManager` to `true` using `accounts.update`. To retain data, use `accounts.get` beforehand. `reports.search` uses Merchant Center Query Language, as demonstrated in a sample query that fetches `impressions`, `clicks`, and `ctr` for a given date range, and allows to run it in the API Explorer. Additionally, metrics can be segmented for detailed reports.\n"],null,["# Measure performance\n\nYou can use the `Reports` service to retrieve [performance\nmetrics](//support.google.com/merchants/answer/10265167) for your account.\n\nSee the [`metrics` documentation](/shopping-content/reference/rest/v2.1/reports/search#Metrics) for the\ncomplete list of available metrics.\n\nRequirements\n------------\n\nYou need the [Reporting manager\nrole](//support.google.com/merchants/answer/11935402) to retrieve this report.\n\nTo give an account the Reporting manager role, use\n[`accounts.update`](/shopping-content/reference/rest/v2.1/accounts/update) to\nset the `reportingManager` field to `true`. The Reporting manager role is\nequivalent to the Performance and insights role in Merchant Center.\n\n`accounts.update` replaces the entire `Account` resource. Use [`accounts.get`](/shopping-content/reference/rest/v2.1/accounts/get) to\nget the full `Account` resource, then provide all fields in your\n`accounts.update` request so you don't lose information.\n\nSample query\n------------\n\nThe following query retrieves the `impressions`, `clicks`, and `ctr` for all\nproducts in your account during a specific 30-day period. To make the request,\npass the following Merchant Center Query Language statement to the\n[`reports.search`](/shopping-content/reference/rest/v2.1/reports/search) method: \n\n SELECT\n metrics.impressions,\n metrics.clicks,\n metrics.ctr\n FROM MerchantPerformanceView\n WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'\n\n[Run](https://developers.google.com/shopping-content/reference/rest/v2.1/reports/search?apix=true&apix_params=%7B%22merchantId%22%3A0%2C%22resource%22%3A%7B%22query%22%3A%22SELECT%20%20metrics.impressions%2C%20%20metrics.clicks%2C%20%20metrics.ctr%20FROM%20MerchantPerformanceView%20WHERE%20segments.date%20BETWEEN%20%272020-12-01%27%20AND%20%272020-12-30%27%22%7D%7D)\n\nClick **Run** to try the sample in the **API Explorer** . After you click\n**Run** , update the merchant ID placeholder to your own merchant ID in the\nrequest URL. You can modify the query. The full query must remain on one line to\nwork with the **API explorer**.\n\nYou can also [segment](/shopping-content/guides/reports/segmentation) the\nmetrics in the query for more granular performance reports.\n\nSee the [Products guide](/shopping-content/guides/reports/products) to learn how\nto retrieve and filter products with the `Reports` service."]]