النطاقات الزمنية

تتيح لك "لغة طلبات البحث في إعلانات Google" تحديد النطاق الزمني بالطرق التالية:

• نطاق زمني مخصص
• نطاق زمني محدّد مسبقًا
• فترة زمنية محدّدة مسبقًا
• الحدود القصوى لفترة البيانات السابقة

نطاق زمني مخصص

يمكنك تحديد التواريخ بتنسيق ISO 8601 الموسّع (YYYY-MM-DD) أو الأساسي (YYYYMMDD). يُنصح باستخدام التنسيق الموسّع (YYYY-MM-DD) لسهولة القراءة. استخدِم BETWEEN أو مشغّلات المقارنة (= أو > أو >= أو < أو <=) مع سلاسل التاريخ المخصّصة:

segments.date BETWEEN '2026-01-01' AND '2026-01-31'

segments.date >= '20260701' AND segments.date <= '20260731'

نطاق زمني محدّد مسبقًا

استخدِم المشغّل DURING مع القيم الحرفية للنطاق الزمني المحدّد مسبقًا. لا يتوافق المشغّل DURING إلا مع النطاقات الزمنية المحدّدة مسبقًا ولا يمكن استخدامه مع سلاسل التاريخ المخصّصة.

في ما يلي قائمة بالنطاقات الزمنية المحدّدة مسبقًا والصالحة:

مثال:

segments.date DURING LAST_30_DAYS

فترة زمنية محدّدة مسبقًا

تشير بعض حقول التاريخ إلى فترة زمنية محدّدة مسبقًا، وهي تحديدًا:

• segments.week
• segments.month
• segments.quarter

عند الفلترة حسب هذه الأقسام باستخدام سلاسل التاريخ المخصّصة (باستخدام = أو BETWEEN أو >= أو <= أو > أو <)، يجب تحديد تاريخ يمثّل اليوم الأول من الـ فترة الزمنية:

• segments.week: يوم الاثنين من الأسبوع (مثلاً، '2026-05-04').
• segments.month: اليوم الأول من الشهر (YYYY-MM-01، مثلاً، '2026-05-01').
• segments.quarter: اليوم الأول من ربع السنة التقويمي (YYYY-01-01 أو YYYY-04-01 أو YYYY-07-01 أو YYYY-10-01).

إذا حدّدت تاريخًا لا يمثّل اليوم الأول من الفترة، سيظهر الخطأ QueryError.MISALIGNED_DATE_FOR_FILTER. يمكنك أيضًا فلترة هذه الأقسام باستخدام المشغّل DURING مع نطاق زمني محدّد مسبقًا.

على سبيل المثال، لتحديد شهر مايو من عام 2026، استخدِم الشرط التالي، مع تحديد اليوم الأول من هذا الشهر:

segments.month = '2026-05-01'

الحدود القصوى لفترة البيانات السابقة

يعتمد توفُّر بيانات التقارير السابقة على مستوى دقة أقسام التاريخ المحدّدة أو التي تم تطبيق الفلتر عليها:

• مستوى الدقة اليومي والأسبوعي والساعي (segments.date وsegments.week وsegments.hour): يتيح فترة معاينة الإعلان تصل إلى 37 شهرًا. ستفشل طلبات البحث التي تقسم البيانات حسب segments.date أو segments.week أو segments.hour (أو التي تطبّق الفلتر على نطاق زمني أقل من شهر) للتواريخ التي تتجاوز نافذة الـ 37 شهرًا ، وسيظهر الخطأ DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED في الإصدار 24 والإصدارات الأحدث (أو DateRangeError.UNKNOWN في الإصدار 23).
• مستوى الدقة الشهري أو ربع السنوي أو السنوي أو مستوى الدقة غير المقسّم (segments.month أو segments.quarter أو segments.year أو بدون قسم تاريخ): يتيح بيانات سابقة تصل إلى 11 عامًا. لطلب بيانات سابقة تتجاوز نافذة الـ 37 شهرًا، قسِّم البيانات حسب segments.month أو segments.quarter أو segments.year أو أزِل أقسام التاريخ في SELECT، وتأكَّد من أنّ النطاق الزمني في WHERE يبدأ في اليوم الأول من الشهر وينتهي في اليوم الأخير من الشهر (أو طبِّق الفلتر على segments.month أو segments.quarter أو segments.year).