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