API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google
searchads-api-announcements بپیوندید تا در مورد پیشرفت‌ها و نسخه‌های آینده به‌روز باشید.
محدوده تاریخ
Search Ads 360 Query Language به شما امکان می دهد محدوده تاریخ را به دو روش مشخص کنید:
محدوده تاریخ سفارشی
می توانید تاریخ ها را در قالب 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.week -
segments.month -
segments.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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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"]]
