rocket
تعرَّف على
Merchant API
الذي يحلّ رسميًا محلّ Content API for Shopping.
add_alert
ملاحظة: سيتم إيقاف Content API for Shopping نهائيًا في 18 أغسطس 2026.
إعداد التقارير
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تقدّم خدمة Reports طرق عرض للبيانات يمكنك استخدامها للتعرّف على منتجاتك وأدائها وبيئتها التنافسية على Google.
يمكنك استخدام خدمة Reports لإجراء ما يلي:
لا تتوفّر خدمة إعداد التقارير هذه إلا للحسابات المستقلة. لا يمكنك استرداد تقارير للحسابات المتقدّمة.
راجِع الأدلة في قائمة التنقّل اليمنى للاطّلاع على أمثلة حول كيفية طلب البحث في بعض طرق العرض المتاحة باستخدام خدمة Reports، وقائمة جميع طرق العرض والحقول المتاحة التي يمكنك اختيارها في طلب بحث.
البدء
تستخدم خدمة Reports لغة طلب البحث في Merchant Center.
جرِّب هذا المثال للبدء.
راجِع تقسيم البيانات إلى صفحات لمعرفة تفاصيل حول التقسيم إلى صفحات.
المشاهدات
يمكنك طلب عرض واحد فقط لكل طلب. يمكنك الاطّلاع على الأدلة في قائمة التنقّل اليمنى للحصول على أمثلة تفصيلية حول استخدام خدمة Reports، وقائمة جميع طرق العرض والحقول المتاحة التي يمكنك الاستعلام عنها.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eMerchant API, the new version of Content API for Shopping, is now in beta.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eReports\u003c/code\u003e service provides data views to understand product performance and competition on Google.\u003c/p\u003e\n"],["\u003cp\u003eIt allows measuring product performance, filtering products, improving pricing, and viewing retail data insights.\u003c/p\u003e\n"],["\u003cp\u003eThe reporting service is exclusively for standalone accounts and unavailable for advanced accounts.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eReports\u003c/code\u003e service uses Merchant Center Query Language and supports querying one view per request.\u003c/p\u003e\n"]]],["The content introduces the beta Merchant API, the new version of the Content API for Shopping. It also details the `Reports` service, which allows users to measure product performance, filter products, improve pricing, and view retail data to inform business strategy. Users can query data using Merchant Center Query Language. Actions include querying specific views and fields and utilizing the provided example and paging details. The reporting service is limited to standalone accounts.\n"],null,["# Reporting\n\nThe [`Reports`](/shopping-content/reference/rest/v2.1/reports) service offers data views you can use to\nlearn about your products, their performance, and their competitive environment\non Google.\n\nYou can use the [`Reports`](/shopping-content/reference/rest/v2.1/reports) service to do the following:\n\n- [Measure the performance of your\n products](/shopping-content/guides/reports/metrics).\n- [Filter your products by specific\n fields](/shopping-content/guides/reports/products).\n- [Improve product pricing](/shopping-content/guides/reports/price-insights).\n- [View retail data on Google that can help inform your business\n strategy](/shopping-content/guides/reports/market-insights).\n\nThis reporting service is only available for standalone accounts. You can't\nretrieve reports for advanced accounts.\n\nSee the guides in the left navigation menu for examples of how to query some of\nthe available views with the `Reports` service, and the list of [all available\nviews and fields](/shopping-content/guides/reports/fields) you can select in a\nquery.\n\nGet started\n-----------\n\nThe `Reports` service uses [Merchant Center Query\nLanguage](/shopping-content/guides/reports/query-language/overview).\n\nTry this [example](/shopping-content/guides/reports/example) to get started.\n\nSee [Paging your data](/shopping-content/guides/reports/paging) for details on\npaging.\n\nViews\n-----\n\nYou can only query one view per request. See the guides in the left navigation\nmenu for detailed examples of using the `Reports` service, and the list of [all\nthe available views and fields](/shopping-content/guides/reports/fields) you can\nquery."]]
