rocket Meet
Merchant API - جانشین رسمی Content API برای خرید.
update جدیدترین ویژگیهای Merchant API، رفع اشکالها و بهروزرسانیها
را دریافت کنید .
add_alert توجه: Content API برای خرید در 18 اوت 2026 غروب میکند.
برندهای برتر را شناسایی کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
می توانید از گزارش پرفروش ترین ها برای مشاهده برندهای پرفروش در Google Shopping و در تبلیغات خرید استفاده کنید. میتوانید از اطلاعات این گزارش استفاده کنید تا متوجه شوید کدام مارکها در Google عملکرد خوبی دارند و آیا در حال حاضر آنها را دارید یا خیر.
برای اطلاعات بیشتر درباره گزارش بهترین فروش را ببینید.
حساب شما باید حداقل شرایط واجد شرایط بودن را داشته باشد و باید اطمینان حاصل کنید که استفاده شما یا استفاده شخص ثالث از دادههای Market Insights صادر شده از حساب Merchant Center شما با شرایط و ضوابط Merchant Center مطابقت دارد.
برای مشاهده برندهای پرفروش در گوگل، BestSellersBrandView
جستجو کنید.
در اینجا نمونه ای وجود دارد که می توانید از آن برای مشاهده برندهای پرفروش استفاده کنید. برای ارسال درخواست، عبارت Merchant Center Query Language زیر را به روش 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
را تغییر دهید تا گزارش را برای سایر تاریخها، جزئیات، کشورها و دستهها سفارشی کنید.
اجرا کنید
روی Run کلیک کنید تا نمونه را در API Explorer امتحان کنید. بعد از اینکه روی Run کلیک کردید، مکاندار شناسه فروشنده را به شناسه فروشنده خود در URL درخواست بهروزرسانی کنید. می توانید پرس و جو را اصلاح کنید. جستجوی کامل باید در یک خط باقی بماند تا با کاوشگر 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"
}
}
]
}
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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 }"]]