أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google
searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
النطاقات الزمنية
تتيح لك لغة طلبات البحث في "إعلانات شبكة البحث 360" تحديد النطاق الزمني بطريقتَين:
نطاق زمني مخصّص
نطاق زمني محدّد مسبقًا
نطاق زمني مخصص
يمكنك تحديد التواريخ بتنسيق ISO 8601(YYYY-MM-DD):
segments.date BETWEEN '2019-01-01' AND '2019-01-31'
segments.date >= '2019-01-01' AND segments.date <= '2019-01-31'
الفترات الزمنية
تشير بعض حقول التاريخ إلى فترة زمنية محدّدة مسبقًا، وتحديدًا:
segments.weeksegments.monthsegments.quarter
عند الفلترة حسب هذه الشرائح، يمكنك استخدام عامل التشغيل = مع التاريخ
الذي يمثّل اليوم الأول من الفترة الزمنية. اعتبارًا من الإصدار 9، إذا حدّدت تاريخًا
ليس هو اليوم الأول من فترة، يتم عرض خطأ MISALIGNED_DATE_FOR_FILTER.
على سبيل المثال، لتحديد شهر أيار (مايو) في العام 2021، يمكنك استخدام العبارة التالية التي تحدّد اليوم الأول من ذلك الشهر:
segments.month = '2021-05-01'
نطاق زمني محدّد مسبقًا
في ما يلي قائمة النطاقات الزمنية المحدّدة مسبقًا والصالحة:
| النطاق الزمني |
يتم إنشاء التقارير لما يلي: |
TODAY |
اليوم فقط. |
YESTERDAY |
أمس فقط. |
LAST_7_DAYS |
آخر 7 أيام، ولا يشمل ذلك اليوم. |
LAST_BUSINESS_WEEK |
أسبوع العمل الذي يضم 5 أيام، من الاثنين إلى الجمعة، من الأسبوع السابق. |
THIS_MONTH |
جميع الأيام في الشهر الحالي |
LAST_MONTH |
كل أيام الشهر السابق |
LAST_14_DAYS |
آخر 14 يومًا، باستثناء اليوم |
LAST_30_DAYS |
آخر 30 يومًا، باستثناء اليوم |
THIS_WEEK_SUN_TODAY |
الفترة بين الأحد السابق واليوم الحالي |
THIS_WEEK_MON_TODAY |
الفترة بين الاثنين السابق واليوم الحالي |
LAST_WEEK_SUN_SAT |
الفترة التي تبلغ 7 أيام بدءًا من يوم الأحد السابق. |
LAST_WEEK_MON_SUN |
الفترة التي تبلغ 7 أيام بدءًا من يوم الاثنين السابق |
مثال:
segments.date DURING LAST_30_DAYS
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-03 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-03 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The Search Ads 360 Query Language allows specifying date ranges using either custom dates or predefined date ranges."],["Custom date ranges can be defined using ISO 8601 format and operators like `BETWEEN`, `\u003e=`, and `\u003c=`."],["Time period segments such as week, month, and quarter require filtering with the first day of the period using the `=` operator."],["Predefined date ranges offer shortcuts for common periods like `TODAY`, `LAST_7_DAYS`, `LAST_MONTH`, and others, simplifying query construction."],["Specifying a date that is not the first day of a period for segments like `segments.month` will result in a `MISALIGNED_DATE_FOR_FILTER` error."]]],["The Search Ads 360 Query Language uses custom or predefined date ranges. Custom ranges utilize ISO 8601 format (YYYY-MM-DD) for specific dates (e.g., `segments.date BETWEEN '2019-01-01' AND '2019-01-31'`). For segments like `week`, `month`, or `quarter`, filters must use the first day of the period. Predefined ranges, such as `TODAY`, `LAST_7_DAYS`, or `LAST_MONTH`, offer shortcuts (e.g., `segments.date DURING LAST_30_DAYS`).\n"]]
