rocket
隆重推出
Merchant API
- Content API for Shopping 的官方後繼產品。
update
掌握最新資訊
瞭解 Merchant API 的新功能、錯誤修正和更新。
add_alert
注意：Content API for Shopping 將於 2026 年 8 月 18 日停用。
識別熱門品牌
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
你可以使用暢銷商品報表，查看 Google 購物和購物廣告中最暢銷的品牌。您可以根據這份報表的資訊，瞭解哪些品牌在 Google 上的成效良好，以及您目前是否販售這些品牌。
詳情請參閱「暢銷商品報表簡介」。
你的帳戶必須符合基本資格規定，而且你必須確定，你或任何第三方以符合《Merchant Center 條款及細則》的方式，使用從你 Merchant Center 帳戶匯出的「市場洞察」資料。
查詢 BestSellersBrandView 即可查看 Google 上的暢銷品牌。
以下是查看暢銷品牌的範例。如要提出要求，請將下列 Merchant Center 查詢語言陳述式傳遞至 reports.search 方法：
SELECT
best_sellers.report_date, best_sellers.report_granularity,
best_sellers.country_code, best_sellers.category_id,
best_sellers.rank, best_sellers.previous_rank,
best_sellers.relative_demand, best_sellers.previous_relative_demand,
best_sellers.relative_demand_change, brand.name
FROM BestSellersBrandView
WHERE best_sellers.report_date = '2022-10-10'
AND best_sellers.report_granularity = 'WEEKLY'
AND best_sellers.country_code = 'US'
AND best_sellers.category_id = 166
ORDER BY best_sellers.rank
您可以變更 WHERE 子句中的值，自訂其他日期、細微程度、國家/地區和類別的報表。
執行
按一下「執行」，在 API Explorer 中試用範例。按一下「執行」後，請在要求網址中，將商家 ID 預留位置更新為自己的商家 ID。您可以修改查詢。如要使用 API 探索工具，完整查詢必須保留在一行。
以下是上述查詢的範例回應：
{
"results": [
{
"bestSellers": {
"reportDate": "2022-10-10",
"reportGranularity": "WEEKLY",
"countryCode": "US",
"categoryId": "166"
"rank": "1",
"previousRank": "1",
"relativeDemand": "VERY_HIGH",
"previousRelativeDemand": "VERY_HIGH",
"relativeDemandChange": "FLAT"
}
"brand": {
"name": "Nike",
}
},
{
"bestSellers": {
"reportDate": "2022-10-10",
"reportGranularity": "WEEKLY",
"countryCode": "US",
"categoryId": "166"
"rank": "2",
"previousRank": "2",
"relativeDemand": "HIGH",
"previousRelativeDemand": "HIGH",
"relativeDemandChange": "FLAT"
}
"brand": {
"name": "SHEIN"
}
},
{
"bestSellers": {
"reportDate": "2022-10-10",
"reportGranularity": "WEEKLY",
"countryCode": "US",
"categoryId": "166"
"rank": "3",
"previousRank": "4",
"relativeDemand": "HIGH",
"previousRelativeDemand": "HIGH",
"relativeDemandChange": "FLAT"
}
"brand": {
"name": "adidas"
}
}
]
}
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-08-13 (世界標準時間)。
[null,null,["上次更新時間：2025-08-13 (世界標準時間)。"],[[["\u003cp\u003eThe Merchant API is now in beta and is the future of the Content API for Shopping.\u003c/p\u003e\n"],["\u003cp\u003eDiscover the top-performing brands on Google Shopping using the best sellers report, helping you understand current market trends and potentially expand your product offerings.\u003c/p\u003e\n"],["\u003cp\u003eAccess best-selling brand data via the \u003ccode\u003eBestSellersBrandView\u003c/code\u003e query, customizable for specific dates, locations, and product categories.\u003c/p\u003e\n"],["\u003cp\u003eEnsure compliance with Merchant Center terms and conditions when utilizing Market Insights data extracted from your account.\u003c/p\u003e\n"]]],["The Merchant API beta, a new version of the Content API for Shopping, is introduced. The best sellers report identifies top-performing brands on Google Shopping and ads. To access this data, use the `BestSellersBrandView` query with the `reports.search` method, customize the query using dates, granularities, countries, and categories, and ensure Merchant Center terms are met. Sample code and response examples are provided to facilitate querying and understanding best-selling brand performance data.\n"],null,["# Identify top brands\n\nYou can use the [best sellers](//support.google.com/merchants/answer/9488679) report to view the best-selling brands on Google Shopping and in Shopping ads. You can use the information from this report to understand which brands are\nperforming well on Google, and whether you currently carry them.\n\nSee [About the best seller report](//support.google.com/merchants/answer/9488679) for more information.\n\n\nYour account must meet minimum eligibility requirements, and you must ensure that your use, or any third party's use, of Market Insights data exported from your Merchant Center account complies with the [Merchant Center terms and conditions](//support.google.com/merchants/answer/160173).\n\nQuery [`BestSellersBrandView`](/shopping-content/guides/reports/fields#bestsellersbrandview) to view the best-selling brands on Google.\n\nHere's a sample you can use to view best-selling brands. To make the request, pass the following Merchant Center Query Language statement to the [`reports.search`](/shopping-content/reference/rest/v2.1/reports/search) method: \n\n```scdoc\nSELECT\n best_sellers.report_date, best_sellers.report_granularity,\n best_sellers.country_code, best_sellers.category_id,\n best_sellers.rank, best_sellers.previous_rank,\n best_sellers.relative_demand, best_sellers.previous_relative_demand,\n best_sellers.relative_demand_change, brand.name\nFROM BestSellersBrandView\nWHERE best_sellers.report_date = '2022-10-10'\n AND best_sellers.report_granularity = 'WEEKLY'\n AND best_sellers.country_code = 'US'\n AND best_sellers.category_id = 166\nORDER BY best_sellers.rank\n```\n\nYou can change the values in the `WHERE` clause to customize the report for\nother dates, granularities, countries, and [categories](//support.google.com/merchants/answer/6324436).\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%20best_sellers.report_date%2C%20best_sellers.report_granularity%2C%20%20best_sellers.country_code%2C%20best_sellers.category_id%2C%20%20best_sellers.rank%2C%20best_sellers.previous_rank%2C%20%20best_sellers.relative_demand%2C%20best_sellers.previous_relative_demand%2C%20%20best_sellers.relative_demand_change%2C%20brand.name%20FROM%20BestSellersBrandView%20WHERE%20best_sellers.report_date%20%3D%20%272022-10-10%27%20%20AND%20best_sellers.report_granularity%20%3D%20%27WEEKLY%27%20%20AND%20best_sellers.country_code%20%3D%20%27US%27%20%20AND%20best_sellers.category_id%20%3D%20166%20ORDER%20BY%20best_sellers.rank%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\nHere's a sample response from the preceding query: \n\n {\n \"results\": [\n {\n \"bestSellers\": {\n \"reportDate\": \"2022-10-10\",\n \"reportGranularity\": \"WEEKLY\",\n \"countryCode\": \"US\",\n \"categoryId\": \"166\"\n \"rank\": \"1\",\n \"previousRank\": \"1\",\n \"relativeDemand\": \"VERY_HIGH\",\n \"previousRelativeDemand\": \"VERY_HIGH\",\n \"relativeDemandChange\": \"FLAT\"\n }\n \"brand\": {\n \"name\": \"Nike\",\n }\n },\n {\n \"bestSellers\": {\n \"reportDate\": \"2022-10-10\",\n \"reportGranularity\": \"WEEKLY\",\n \"countryCode\": \"US\",\n \"categoryId\": \"166\"\n \"rank\": \"2\",\n \"previousRank\": \"2\",\n \"relativeDemand\": \"HIGH\",\n \"previousRelativeDemand\": \"HIGH\",\n \"relativeDemandChange\": \"FLAT\"\n }\n \"brand\": {\n \"name\": \"SHEIN\"\n }\n },\n {\n \"bestSellers\": {\n \"reportDate\": \"2022-10-10\",\n \"reportGranularity\": \"WEEKLY\",\n \"countryCode\": \"US\",\n \"categoryId\": \"166\"\n \"rank\": \"3\",\n \"previousRank\": \"4\",\n \"relativeDemand\": \"HIGH\",\n \"previousRelativeDemand\": \"HIGH\",\n \"relativeDemandChange\": \"FLAT\"\n }\n \"brand\": {\n \"name\": \"adidas\"\n }\n }\n ]\n }"]]
