تحديد نطاق زمني
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
النطاقات الزمنية النسبية
تحتوي طلبات بحث التقارير على حقل date_range لتحديد التواريخ التي سيتم تضمينها
البيانات الواردة في التقرير. يمكن تحديد القيم التالية لـ date_range:
TODAYYESTERDAYMONTH_TO_DATEYEAR_TO_DATELAST_7_DAYSLAST_30_DAYSCUSTOM
تجدر الإشارة إلى أنّ النطاق الزمني التلقائي في حال عدم تحديد أيّ نطاق هو 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
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],["Report queries utilize a `date_range` field to define data inclusion periods. Available options are `TODAY`, `YESTERDAY`, `MONTH_TO_DATE`, `YEAR_TO_DATE`, `LAST_7_DAYS`, `LAST_30_DAYS`, and `CUSTOM`. The default is `CUSTOM`. When `CUSTOM` is used, `start_date` and `end_date` parameters are mandatory, set via `startDate.year`, `startDate.month`, `startDate.day` and `endDate.year`, `endDate.month`, `endDate.day` in the API request query.\n"],null,[]]
