rocket
隆重推出
Merchant API - Content API for Shopping 的正式替代方案。
update
获取最新资讯,了解 Merchant API 的新功能、问题修复和更新。
add_alert
注意:Content API for Shopping 将于 2026 年 8 月 18 日停用。
过滤产品
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
您可以使用 Reports
服务的ProductView
表格来显示经过过滤的商品数据视图,包括商品状态。
例如,您可以查询 ProductView
以执行以下操作:
- 列出存在问题的商品,以便您解决这些问题。
- 获取新商品列表,以便验证投放情况。
如需查看所有商品的完整详情,请使用 products.list
。
您必须在查询的 SELECT
子句中添加 product_view.id
字段。product_view.id
的值与商品的 REST ID 相同。
您可以根据所有可用字段进行过滤,但以下字段除外:
product_view.expiration_date
product_view.item_issues
您可以根据除以下字段之外的所有可用字段对响应进行排序:
product_view.gtin
product_view.item_issues
您可以使用以下字段查看产品的效果潜力:
product_view.click_potential
product_view.click_potential_rank
以下示例会返回状态为 NOT_ELIGIBLE_OR_DISAPPROVED
的商品的所有可用字段。如需发出请求,请将以下 Merchant Center 查询语言语句传递给 reports.search
方法:
SELECT
product_view.id,
product_view.offer_id,
product_view.title,
product_view.brand,
product_view.currency_code,
product_view.price_micros,
product_view.language_code,
product_view.condition,
product_view.channel,
product_view.availability,
product_view.shipping_label,
product_view.gtin,
product_view.item_group_id,
product_view.creation_time,
product_view.expiration_date,
product_view.aggregated_destination_status,
product_view.item_issues
product_view.click_potential
product_view.click_potential_rank
FROM ProductView
WHERE product_view.aggregated_destination_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'
运行
点击运行,即可在 API Explorer 中试用该示例。点击运行后,请将请求网址中的商家 ID 占位符更新为您自己的商家 ID。您可以修改查询。完整查询必须保持在一行中,才能与 API 浏览器搭配使用。
如需详细了解特定字段和行为,请参阅 ProductView
参考文档。
如需了解如何使用 Reports
服务检索产品的效果数据,请参阅效果指标。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-13。
[null,null,["最后更新时间 (UTC):2025-08-13。"],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of product data integration.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eProductView\u003c/code\u003e table within the \u003ccode\u003eReports\u003c/code\u003e service allows you to filter and view your product data, including statuses and performance potential.\u003c/p\u003e\n"],["\u003cp\u003eYou can query \u003ccode\u003eProductView\u003c/code\u003e to identify and resolve product issues, verify new product serving, and gain insights into click potential.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ereports.search\u003c/code\u003e method, coupled with Merchant Center Query Language, enables you to retrieve specific product data based on your chosen criteria.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the provided resources for detailed information on \u003ccode\u003eProductView\u003c/code\u003e fields, performance metrics, and utilizing the \u003ccode\u003eReports\u003c/code\u003e service effectively.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. You can use the `ProductView` table within the `Reports` service to filter and view product data, including statuses, or list products with issues and new products. Queries must include the `product_view.id`. Filtering and sorting can be applied to most fields, excluding `product_view.expiration_date`, `product_view.item_issues`, and `product_view.gtin`. Performance potential can be viewed via `product_view.click_potential`.\n"],null,["# Filter products\n\nYou can use the\n[`ProductView`](/shopping-content/reference/rest/v2.1/reports/search#productview)\ntable of the `Reports` service to show a filtered view of your product data,\nincluding product statuses.\n\nFor example, you can query `ProductView` to do the following:\n\n- List products that have issues, so you can resolve them.\n- Get a list of your new products, so you can verify serving.\n\nTo view full details of all your products, use\n[`products.list`](/shopping-content/reference/rest/v2.1/products/list).\n\nYou must include the `product_view.id` field in the `SELECT` clause of your\nquery. The `product_view.id` has the same value as the product's [REST\nID](/shopping-content/guides/products/product-id).\n\nYou can filter based on all the [available\nfields](/shopping-content/reference/rest/v2.1/reports/search#productview) except the following:\n\n- `product_view.expiration_date`\n- `product_view.item_issues`\n\nYou can sort the response based on all the available fields except the following:\n\n- `product_view.gtin`\n- `product_view.item_issues`\n\nYou can use the following fields to view the performance potential of your\nproducts:\n\n- `product_view.click_potential`\n- `product_view.click_potential_rank`\n\nHere's an example that returns all the available fields for your products with\nthe status `NOT_ELIGIBLE_OR_DISAPPROVED`. To make the request, pass the\nfollowing Merchant Center Query Language statement to the\n[`reports.search`](/shopping-content/reference/rest/v2.1/reports/search)\nmethod: \n\n SELECT\n product_view.id,\n product_view.offer_id,\n product_view.title,\n product_view.brand,\n product_view.currency_code,\n product_view.price_micros,\n product_view.language_code,\n product_view.condition,\n product_view.channel,\n product_view.availability,\n product_view.shipping_label,\n product_view.gtin,\n product_view.item_group_id,\n product_view.creation_time,\n product_view.expiration_date,\n product_view.aggregated_destination_status,\n product_view.item_issues\n product_view.click_potential\n product_view.click_potential_rank\n FROM ProductView\n WHERE product_view.aggregated_destination_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'\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%20product_view.id%2C%20%20product_view.offer_id%2C%20%20product_view.title%2C%20%20product_view.brand%2C%20%20product_view.currency_code%2C%20%20product_view.price_micros%2C%20%20product_view.language_code%2C%20%20product_view.condition%2C%20%20product_view.channel%2C%20%20product_view.availability%2C%20%20product_view.shipping_label%2C%20%20product_view.gtin%2C%20%20product_view.item_group_id%2C%20%20product_view.creation_time%2C%20%20product_view.expiration_date%2C%20%20product_view.aggregated_destination_status%2C%20%20product_view.item_issues%20FROM%20ProductView%20WHERE%20product_view.aggregated_destination_status%20%3D%20%27NOT_ELIGIBLE_OR_DISAPPROVED%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\nSee the [`ProductView`](/shopping-content/reference/rest/v2.1/reports/search#productview) reference for\nmore information on specific fields and behavior.\n\nSee [Performance metrics](/shopping-content/guides/reports/metrics) to learn how\nto retrieve performance data for your products with the `Reports` service."]]