rocket
隆重推出
Merchant API
- Content API for Shopping 的官方後繼產品。
update
掌握最新資訊
瞭解 Merchant API 的新功能、錯誤修正和更新。
add_alert
注意:Content API for Shopping 將於 2026 年 8 月 18 日停用。
篩選產品
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
你可以使用 ProductView
服務的 Reports
表格,顯示產品資料的篩選檢視畫面,包括產品狀態。
舉例來說,您可以查詢 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
服務擷取產品的成效資料。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-13 (世界標準時間)。
[null,null,["上次更新時間: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."]]