期間
検索広告 360 クエリ言語では、2 つの方法で期間を指定できます。
期間を指定
日付は 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
これらのセグメントでフィルタリングする場合は、期間の最初の日付を指定して =
演算子を使用できます。v9 以降では、期間の最初の日付以外の日付を指定すると、MISALIGNED_DATE_FOR_FILTER
エラーが返されます。
たとえば、2021 年の 5 月を指定するには、その月の 1 日を指定します。
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
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-03-03 UTC。
[null,null,["最終更新日 2025-03-03 UTC。"],[[["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"]]