Google 広告クエリ言語では、次のように期間を指定できます。
期間を指定
日付は、ISO 8601 の拡張形式（YYYY-MM-DD）または基本形式（YYYYMMDD）で指定できます。読みやすさの点から、拡張形式（YYYY-MM-DD）をおすすめします。カスタム日付文字列で BETWEEN または比較演算子（=、>、>=、<、<=）を使用します。
segments.date BETWEEN '2026-01-01' AND '2026-01-31'
segments.date >= '20260701' AND segments.date <= '20260731'
既定の期間
DURING 演算子と事前定義された日付範囲リテラルを使用します。DURING 演算子は、事前定義された期間のみをサポートしており、カスタムの日付文字列では使用できません。
有効な既定の期間のリストは以下のとおりです。
| 期間 | レポートの対象期間 |
|---|---|
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
事前定義された期間
一部の日付フィールドは、事前定義された期間を参照します。具体的には次のとおりです。
segments.weeksegments.monthsegments.quarter
カスタム日付文字列（=、BETWEEN、>=、<=、>、< を使用）でこれらのセグメントをフィルタする場合は、期間の最初の日を指定する必要があります。
segments.week: 週の月曜日（例:'2026-05-04'）。segments.month: 月の初日（YYYY-MM-01、例:'2026-05-01'）。segments.quarter: カレンダー四半期の最初の日（YYYY-01-01、YYYY-04-01、YYYY-07-01、YYYY-10-01）。
期間の最初の日ではない日付を指定すると、QueryError.MISALIGNED_DATE_FOR_FILTER エラーが返されます。これらのセグメントは、事前定義された期間で DURING 演算子を使用してフィルタすることもできます。
たとえば、2026 年 5 月を指定するには、次の条件を使用して、その月の初日を指定します。
segments.month = '2026-05-01'
過去のルックバックの上限
過去のレポートデータの利用可能性は、選択またはフィルタされた日付セグメントの粒度によって異なります。
- 日単位、週単位、時間単位の粒度（
segments.date、segments.week、segments.hour）: 最大 37 か月のルックバック ウィンドウをサポートします。37 か月の期間を超える日付について、segments.date、segments.week、segments.hourでセグメント化する（または 1 か月未満の期間でフィルタする）クエリは、v24 以降ではDateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED（v23 ではDateRangeError.UNKNOWN）で失敗します。 - 月単位、四半期単位、年単位、またはセグメント化されていない粒度（
segments.month、segments.quarter、segments.year、または日付セグメントなし）: 最大 11 年の過去のデータがサポートされます。37 か月の期間を超える過去のデータをクエリするには、segments.month、segments.quarter、segments.yearでセグメント化するか、SELECTの日付セグメントを省略します。また、WHEREの期間が月の初日に始まり、月の最終日に終わるようにします（またはsegments.month、segments.quarter、segments.yearでフィルタします）。