rocket Meet
Merchant API - جانشین رسمی Content API برای خرید.
update جدیدترین ویژگیهای Merchant API، رفع اشکالها و بهروزرسانیها
را دریافت کنید .
add_alert توجه: Content API برای خرید در 18 اوت 2026 غروب میکند.
مشاهده گرایش های خرید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
گزارشهای گرایش خرید ، توصیهها و اطلاعاتی درباره محصولات شما بر اساس تقاضای جستجو برای موضوعات مرتبط با موجودی شما ارائه میکنند.
گرایش های موضوع
میتوانید از گزارش گرایشهای موضوع برای درک محبوبیت یک موضوع در جستجوی Google در طول زمان، از جمله ارزش پیشبینیشده آن در 13 هفته آینده، و مقایسه محبوبیت آن با سایر موضوعات مورد علاقه خریداران در جستجوی Google استفاده کنید. این روندها ممکن است به شما در تصمیم گیری در مورد زمان استفاده از ابزارهای Google با پرداخت شده و ارگانیک کمک کند تا احتمال کاربر را که محصولات شما را هنگام جستجوی آن یا یک محصول مشابه به صورت آنلاین می بیند ، افزایش دهد.
برای اطلاعات بیشتر درباره روند خرید رجوع کنید.
برای اطلاعات در مورد محصولات یا مارک های پرفروش، به گزارش های پرفروش مراجعه کنید.
حساب شما باید شرایط واجد شرایط بودن را داشته باشد و باید اطمینان حاصل کنید که استفاده شما یا استفاده شخص ثالث از دادههای روند موضوع خرید با شرایط و ضوابط Merchant Center مطابقت دارد. شما باید حداقل دو محصول در یک دسته خاص داشته باشید تا روند آن دسته را ببینید. پس از آپلود محصولات، ممکن است تا 24 ساعت طول بکشد تا گرایش های آن دسته در دسترس شما باشد.
ببینید کدام جداول و فیلدهای گزارش با Content API برای خرید در دسترس هستند.
در اینجا نمونه ای وجود دارد که می توانید از آن برای مشاهده محبوبیت موضوع و داده های روند استفاده کنید. برای ارسال درخواست، عبارت Merchant Center Query Language زیر را به روش reports.search
ارسال کنید:
SELECT
topic_trends.customer_country_code,
topic_trends.topic,
topic_trends.date,
topic_trends.search_interest,
topic_trends.last7_days_search_interest,
topic_trends.last30_days_search_interest,
topic_trends.last90_days_search_interest,
topic_trends.last120_days_search_interest,
topic_trends.next7_days_search_interest
FROM TopicTrendsView
WHERE topic_trends.customer_country_code = 'US'
AND topic_trends.date BETWEEN '2023-07-01' AND '2023-07-03'
ORDER BY topic_trends.date DESC
در اینجا یک نمونه پاسخ از پرس و جو قبلی آمده است:
"results": [
{
"topicTrends": {
"customerCountryCode": "US",
"topic": "Cell Phone Cases",
"date": {
"year": 2023,
"month": 7,
"day": 3
},
"searchInterest": 50.2,
"last7DaysSearchInterest": 49.5
"last30DaysSearchInterest": 51.1
"last90DaysSearchInterest": 50.7
"last120DaysSearchInterest": 49.3
"next7DaysSearchInterest": 60
}
},
{
"topicTrends": {
"customerCountryCode": "US",
"topic": "Cell Phones",
"date": {
"year": 2023,
"month": 7,
"day": 2
},
"searchInterest": 70.2,
"last7DaysSearchInterest": 69.8
"last30DaysSearchInterest": 71.4
"last90DaysSearchInterest": 70.6
"last120DaysSearchInterest": 69.0
"next7DaysSearchInterest": 70.1
}
},
{
"topicTrends": {
"customerCountryCode": "US",
"topic": "Wireless Speakers",
"date": {
"year": 2023,
"month": 7,
"day": 1
},
"searchInterest": 40.6,
"last7DaysSearchInterest": 41.4
"last30DaysSearchInterest": 40.6
"last90DaysSearchInterest": 40.3
"last120DaysSearchInterest": 39.8
"next7DaysSearchInterest": 41.1
}
}
]
بیشتر بدانید
پرسشهای متداول ما درباره دادههای Google Trends و نمودارهای برتر Trends توضیح داده شده را ببینید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز 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, a new version of the Content API for Shopping, is now in beta.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the Shopping topic trends report to understand the search popularity of specific product topics, including predictions for the next 13 weeks.\u003c/p\u003e\n"],["\u003cp\u003eThis data can help you optimize your product visibility through paid and organic Google tools.\u003c/p\u003e\n"],["\u003cp\u003eYou need at least two products in a category to view its trend data, which may take up to 24 hours to become available.\u003c/p\u003e\n"],["\u003cp\u003eAccess topic popularity and trend data using the \u003ccode\u003ereports.search\u003c/code\u003e method and the provided Merchant Center Query Language statement.\u003c/p\u003e\n"]]],["The Merchant API beta, a new version of the Content API for Shopping, is introduced. Shopping trends reports, based on search demand, offer product recommendations and insights, including topic popularity over time with predictions. Users can query this data using Merchant Center Query Language via the `reports.search` method. Eligibility requirements apply, and at least two products per category are needed for trend visibility, which can take up to 24 hours to appear. The report will include metrics on the topic's search interest.\n"],null,["# View Shopping trends\n\nThe [Shopping trends reports](//support.google.com/merchants/answer/13542370)\nprovide recommendations and insights about your products based on search demand\nfor topics related to your inventory.\n\nTopic trends\n------------\n\nYou can use the topic trends report to understand the popularity of a topic on\nGoogle Search over time, including its predicted value over the next 13 weeks,\nand how its popularity compares to other topics of interest to shoppers on\nGoogle Search. These trends might help you make decisions about when to use paid\nand organic Google tools to increase the likelihood of a user seeing your\nproducts when they are looking for it, or a similar product, online.\n\nSee [About shopping\ntrends](//support.google.com/merchants/answer/13542370) for more\ninformation.\n\nFor information about top selling products or brands, see the [best sellers\nreports](/shopping-content/guides/reports/market-insights#identify_best_sellers).\n\nYour account must meet eligibility requirements and you must ensure that your\nuse, or any third party's use, of Shopping topic trend data complies with\nMerchant Center terms and conditions. You must have at least two products in a\nspecific category to see trends for that category. After uploading products, it\nmight take up to 24 hours for trends in that category to be available to you.\n\nSee which [reporting tables and\nfields](/shopping-content/guides/reports/fields)\nare available with the Content API for Shopping.\n\nHere's a sample you can use to view topic popularity and trend data. To make the\nrequest, pass the following Merchant Center Query Language statement to the\n[`reports.search`](/shopping-content/reference/rest/v2.1/reports/search) method: \n\n SELECT\n topic_trends.customer_country_code,\n topic_trends.topic,\n topic_trends.date,\n topic_trends.search_interest,\n topic_trends.last7_days_search_interest,\n topic_trends.last30_days_search_interest,\n topic_trends.last90_days_search_interest,\n topic_trends.last120_days_search_interest,\n topic_trends.next7_days_search_interest\n FROM TopicTrendsView\n WHERE topic_trends.customer_country_code = 'US'\n AND topic_trends.date BETWEEN '2023-07-01' AND '2023-07-03'\n ORDER BY topic_trends.date DESC\n\nHere's a sample response from the preceding query: \n\n \"results\": [\n {\n \"topicTrends\": {\n \"customerCountryCode\": \"US\",\n \"topic\": \"Cell Phone Cases\",\n \"date\": {\n \"year\": 2023,\n \"month\": 7,\n \"day\": 3\n },\n \"searchInterest\": 50.2,\n \"last7DaysSearchInterest\": 49.5\n \"last30DaysSearchInterest\": 51.1\n \"last90DaysSearchInterest\": 50.7\n \"last120DaysSearchInterest\": 49.3\n \"next7DaysSearchInterest\": 60\n }\n },\n {\n \"topicTrends\": {\n \"customerCountryCode\": \"US\",\n \"topic\": \"Cell Phones\",\n \"date\": {\n \"year\": 2023,\n \"month\": 7,\n \"day\": 2\n },\n \"searchInterest\": 70.2,\n \"last7DaysSearchInterest\": 69.8\n \"last30DaysSearchInterest\": 71.4\n \"last90DaysSearchInterest\": 70.6\n \"last120DaysSearchInterest\": 69.0\n \"next7DaysSearchInterest\": 70.1\n }\n },\n {\n \"topicTrends\": {\n \"customerCountryCode\": \"US\",\n \"topic\": \"Wireless Speakers\",\n \"date\": {\n \"year\": 2023,\n \"month\": 7,\n \"day\": 1\n },\n \"searchInterest\": 40.6,\n \"last7DaysSearchInterest\": 41.4\n \"last30DaysSearchInterest\": 40.6\n \"last90DaysSearchInterest\": 40.3\n \"last120DaysSearchInterest\": 39.8\n \"next7DaysSearchInterest\": 41.1\n }\n }\n ]\n\nLearn more\n----------\n\nSee our [FAQ about Google Trends\ndata](//support.google.com/trends/answer/4365533)\nand [Trends Top Charts\nexplained](//support.google.com/trends/answer/3076011)."]]