النطاقات الزمنية النسبية
تحتوي طلبات بحث التقارير على حقل date_range
لتحديد التواريخ التي سيتم تضمينها
البيانات الواردة في التقرير. يمكن تحديد القيم التالية لـ date_range
:
TODAY
YESTERDAY
MONTH_TO_DATE
YEAR_TO_DATE
LAST_7_DAYS
LAST_30_DAYS
CUSTOM
تجدر الإشارة إلى أنّ النطاق الزمني التلقائي في حال عدم تحديد أيّ نطاق هو CUSTOM
.
نطاقات زمنية مخصّصة
عند ضبط date_range
على CUSTOM
أو عند
غير محدد، يجب ضبط start_date
وend_date
على
تاريخي البدء والانتهاء (الشامل) لنطاق التقرير.
في مَعلمات طلب البحث لطلب واجهة برمجة التطبيقات، ستبدو مَعلمات تاريخ البدء على النحو التالي:
startDate.year=2021&startDate.month=3&startDate.day=1
وبالمثل، ستبدو مَعلمات تاريخ الانتهاء على النحو التالي:
endDate.year=2021&endDate.month=3&endDate.day=3