期間

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 演算子は、事前定義された期間のみをサポートしており、カスタムの日付文字列では使用できません。

有効な既定の期間のリストは以下のとおりです。

例:

segments.date DURING LAST_30_DAYS

定義済みの期間

一部の日付フィールドは、事前定義された期間を参照します。具体的には次のとおりです。

• segments.week
• segments.month
• segments.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 でフィルタします）。