add_alert
重要提示:Content API for Shopping 将于 2026 年 8 月 18 日停用。
update
获取最新资讯
了解新的 Merchant API 功能、问题修复和更新。
Google 会使用 AI 技术将内容翻译成您偏好的语言。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 Explorer 搭配使用。
您还可以对查询中的指标进行细分,以获取更精细的效果报告。
如需了解如何使用 Reports 服务检索和过滤产品,请参阅产品指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2026-07-06。
[null,null,["最后更新时间 (UTC):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"]]