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 روزه، از دوشنبه تا جمعه، هفته کاری قبلی.
تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Search Ads 360 Query Language allows specifying date ranges using either custom dates or predefined date ranges.\u003c/p\u003e\n"],["\u003cp\u003eCustom date ranges can be defined using ISO 8601 format and operators like \u003ccode\u003eBETWEEN\u003c/code\u003e, \u003ccode\u003e>=\u003c/code\u003e, and \u003ccode\u003e<=\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTime period segments such as week, month, and quarter require filtering with the first day of the period using the \u003ccode\u003e=\u003c/code\u003e operator.\u003c/p\u003e\n"],["\u003cp\u003ePredefined date ranges offer shortcuts for common periods like \u003ccode\u003eTODAY\u003c/code\u003e, \u003ccode\u003eLAST_7_DAYS\u003c/code\u003e, \u003ccode\u003eLAST_MONTH\u003c/code\u003e, and others, simplifying query construction.\u003c/p\u003e\n"],["\u003cp\u003eSpecifying a date that is not the first day of a period for segments like \u003ccode\u003esegments.month\u003c/code\u003e will result in a \u003ccode\u003eMISALIGNED_DATE_FOR_FILTER\u003c/code\u003e error.\u003c/p\u003e\n"]]],["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"],null,[]]