Merchant Reports API 版本说明

2026 年 10 月 26 日当周

product_performance_view 中新增了 network 细分,可让您按投放网络(例如搜索网络、搜索网络合作伙伴、展示广告网络、YouTube)细分产品效果。如需了解详情,请参阅 Merchant Center 效果报告更新。

product_performance_view 中的 marketing_method 细分现在支持 AFFILIATE,以便将 YouTube 购物联属营销计划中展示的商品与自然流量分开报告。如需了解详情,请参阅 Merchant Center 效果报告更新。

2026 年 10 月 19 日当周

现在可以在高级账号级别查询 ucp_agentic_performance_view 和 ucp_agentic_product_performance_view。

2026 年 10 月 5 日当周

Reports sub-API(位于 v1alpha 下)中提供了一个新的报告数据视图:

youtube_product_tagged_stats_view 和 youtube_product_sold_stats_view 中新增了 product_type 字段,用于返回商家自己的商品类目中的类别。

2026 年 9 月 28 日当周

Reports sub-API(位于 v1alpha 下)中提供了两个新的报告数据视图:

youtube_creator_performance_view 中新增的 subscriber_count 字段会返回创作者频道的订阅人数。

2026 年 9 月 14 日当周

佣金明细(由平台资助的佣金“platform_commissions”和由子卖家资助的佣金“seller_commissions”)现在可在 youtube_content_performance_view 表中查看。您还可以通过请求 account_id 字段来查看子卖家的效果。

2026 年 6 月 1 日当周

Reports sub-API(位于 v1alpha 下)中提供了两个新的报告数据视图:

2026 年 4 月 13 日当周

product_performance_view 中新增了 store_type 细分,可按线上商店与本地实体店细分商品效果。

2026 年 2 月 23 日当周

product_view 中新增了 status_per_reporting_context 字段,可用于按报告上下文和国家/地区查询详细的商品状态。新的 reporting_context 字段可以限制响应中包含哪些报告上下文,还可以限制用于计算 aggregated_reporting_context_status 并在 item_issues 中返回的报告上下文。

product_view 中提供了一个新的报告上下文 FREE_LISTINGS_UCP_CHECKOUT,可供查询。

search 方法支持的最大 page_size 增加到 100,000。大于 100,000 的值会强制转换为 100,000。默认 page_size 未更改。

2025 年 1 月 6 日当周

返回的错误中的 domain 字段现在填充的是 merchantapi.googleapis.com,而不是 global

2024 年 5 月 27 日当周

Reports sub-API 的 Beta 版发布

2024 年 5 月 20 日当周

在 Reports 子 API 中发布 non_product_performance_view 表。

2023 年 10 月 31 日当周

发布 Reports sub-API 的封闭式 Beta 版