add_alert
重要提示:Content API for Shopping 将于 2026 年 8 月 18 日停用。
update
获取最新资讯
了解新的 Merchant API 功能、问题修复和更新。
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
衡量性能
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
您可以使用 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"]]