rocket
تعرَّف على
Merchant API
الذي يحلّ رسميًا محلّ Content API for Shopping.
add_alert
ملاحظة: سيتم إيقاف Content API for Shopping نهائيًا في 18 أغسطس 2026.
تحديد أهم العلامات التجارية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك استخدام تقرير الأكثر مبيعًا للاطّلاع على العلامات التجارية الأكثر مبيعًا على Google Shopping وفي "إعلانات Shopping". يمكنك استخدام المعلومات الواردة في هذا التقرير لمعرفة العلامات التجارية التي تحقّق أداءً جيدًا على Google، وما إذا كنت تبيعها حاليًا.
لمزيد من المعلومات، يُرجى الاطّلاع على لمحة عن تقرير السلع الأكثر مبيعًا.
يجب أن يستوفي حسابك الحدّ الأدنى من متطلبات الأهلية، ويجب التأكّد من أنّ استخدامك لبيانات برنامج "إحصاءات السوق" التي يتم تصديرها من حسابك على Merchant Center يتوافق مع أحكام وشروط Merchant Center، تمامًا مثل استخدام أي جهة خارجية لها.
استخدِم طلب البحث BestSellersBrandView
للاطّلاع على العلامات التجارية الأكثر مبيعًا على Google.
في ما يلي نموذج يمكنك استخدامه لعرض العلامات التجارية الأكثر مبيعًا. لتقديم الطلب، مرِّر عبارة 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
لتخصيص التقرير حسب تواريخ أخرى ومستويات تفصيلية وبلدان وفئات.
تشغيل
انقر على تنفيذ لتجربة العيّنة في مستكشف واجهات برمجة التطبيقات. بعد النقر على تنفيذ، عدِّل عنصر نائب معرّف التاجر إلى معرّف التاجر الخاص بك في عنوان URL للطلب. يمكنك تعديل طلب البحث. يجب أن يبقى الاستعلام الكامل على سطر واحد لكي يعمل مع مستكشف واجهة برمجة التطبيقات.
في ما يلي نموذج استجابة من طلب البحث السابق:
{
"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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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 }"]]