rocket
تعرَّف على
Merchant API
الذي يحلّ رسميًا محلّ Content API for Shopping.
add_alert
ملاحظة: سيتم إيقاف Content API for Shopping نهائيًا في 18 أغسطس 2026.
النطاقات الزمنية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك "لغة طلبات البحث في Merchant Center" تحديد نطاق زمني باستخدام نطاق زمني مخصّص أو نسبي. يجب أن تتضمّن جميع طلبات المقاييس شرطًا
segments.date في عبارةWHERE للإشارة إلى الفترة الزمنية التي تريد استرداد بيانات الأداء منها.
نطاق زمني مخصص
يمكنك تحديد التواريخ بتنسيق ISO 8601 (YYYY-MM-DD):
segments.date BETWEEN '2021-01-01' AND '2021-01-31'
أو:
segments.date >= '2021-01-01' AND segments.date <= '2021-01-31'
يمكنك تحديد سلاسل التاريخ باستخدام علامات اقتباس مفردة (') أو علامات اقتباس مزدوجة (")، ولكن يجب أن تكون متسقًا، مثلاً: "2021-01-01' ليست سلسلة تاريخ صالحة.
النطاق الزمني النسبي
بالإضافة إلى النطاقات الزمنية المخصّصة، يمكنك تحديد نطاق زمني نسبي مثل LAST_30_DAYS أو THIS_MONTH باستخدام DURING بدلاً من BETWEEN وAND:
WHERE segments.date DURING LAST_30_DAYS
يمكنك الاطّلاع على
قواعد لغة طلب البحث في Merchant Center
للحصول على قائمة بنطاقات التواريخ النسبية المتاحة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)"],[],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. All requests for performance metrics require a `segments.date` condition in the `WHERE` clause. Dates can be specified in ISO 8601 format within a custom range using `BETWEEN` or `\u003e=` and `\u003c=`. Alternatively, relative date ranges like `LAST_30_DAYS` can be specified with `DURING`. For a list of available date ranges, the grammar documentation should be consulted.\n"],null,[]]
