add_alert
重要事項:Content API for Shopping 將於 2026 年 8 月 18 日終止服務。
rocket
隆重推出
Merchant API
- Content API for Shopping 的官方後繼產品。
update
掌握最新資訊
瞭解 Merchant API 的新功能、錯誤修正和更新。
Google 會運用 AI 技術將內容翻譯成你偏好的語言,但可能會出錯。
評估效能
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
您可以使用 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'
執行
按一下「執行」,即可在 API Explorer 中試用範例。按一下「執行」後,請在要求網址中,將商家 ID 預留位置更新為自己的商家 ID。您可以修改查詢。如要使用 API 探索工具,完整查詢必須保留在一行。
您也可以區隔查詢中的指標,取得更精細的成效報表。
請參閱產品指南,瞭解如何使用 Reports 服務擷取及篩選產品。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2026-07-06 (世界標準時間)。
[null,null,["上次更新時間:2026-07-06 (世界標準時間)。"],[],["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"]]