다음은 베스트셀러 브랜드를 확인하는 데 사용할 수 있는 샘플입니다. 요청을 실행하려면 다음 판매자 센터 쿼리 언어 문을 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 절의 값을 변경하여 다른 날짜, 세부사항, 국가, 카테고리에 맞게 보고서를 맞춤설정할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-13(UTC)"],[[["\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 }"]]
