Períodos

A linguagem de consulta do Google Ads permite especificar o período destas maneiras:

• Período personalizado
• Período predefinido
• Período predefinido
• Limites de retrospectiva histórica

Observação: todos os períodos são avaliados em relação ao fuso horário da conta de veiculação (customer.time_zone), e não ao UTC ou ao fuso horário local do cliente da API.

Período personalizado

É possível especificar datas no formato ISO 8601 estendido (YYYY-MM-DD) ou básico (YYYYMMDD). O formato estendido (YYYY-MM-DD) é recomendado para facilitar a leitura. Use BETWEEN ou operadores de comparação (=, >, >=, <, <=) com strings de data personalizadas:

segments.date BETWEEN '2026-01-01' AND '2026-01-31'

segments.date >= '20260701' AND segments.date <= '20260731'

Período predefinido

Use o operador DURING com literais de período predefinido. O operador DURING aceita apenas períodos predefinidos e não pode ser usado com strings de data personalizadas.

A lista de períodos predefinidos válidos é a seguinte:

Período	Os relatórios são gerados para...
TODAY	Somente hoje.
YESTERDAY	Somente ontem.
LAST_7_DAYS	Os últimos 7 dias não incluindo hoje.
LAST_BUSINESS_WEEK	A semana útil de cinco dias, de segunda a sexta-feira, da semana útil anterior.
THIS_MONTH	Todos os dias do mês atual.
LAST_MONTH	Todos os dias do último mês.
LAST_14_DAYS	Os últimos 14 dias não incluindo hoje.
LAST_30_DAYS	Os últimos 30 dias não incluindo hoje.
THIS_WEEK_SUN_TODAY	O período entre o domingo anterior e o dia atual.
THIS_WEEK_MON_TODAY	O período entre a segunda-feira anterior e o dia atual.
LAST_WEEK_SUN_SAT	O período de sete dias que começa no domingo anterior.
LAST_WEEK_MON_SUN	O período de 7 dias que começa na segunda-feira anterior.

Exemplo:

segments.date DURING LAST_30_DAYS

Período predefinido

Alguns campos de data se referem a um período predefinido, especificamente:

• segments.week
• segments.month
• segments.quarter

Ao filtrar esses segmentos com strings de data personalizadas (usando =, BETWEEN, >=, <=, >, ou <), é necessário especificar uma data que seja o primeiro dia do período:

• segments.week: segunda-feira da semana (por exemplo, '2026-05-04').
• segments.month: primeiro dia do mês (YYYY-MM-01, por exemplo, '2026-05-01').
• segments.quarter: primeiro dia do trimestre civil (YYYY-01-01, YYYY-04-01, YYYY-07-01 ou YYYY-10-01).

Se você especificar uma data que não seja o primeiro dia do período, um QueryError.MISALIGNED_DATE_FOR_FILTER erro será retornado. Também é possível filtrar esses segmentos usando o operador DURING com um período predefinido.

Por exemplo, para especificar o mês de maio do ano de 2026, use a condição a seguir, especificando o primeiro dia desse mês:

segments.month = '2026-05-01'

Observação: segments.year é filtrado usando um número inteiro de ano de 4 dígitos (por exemplo, segments.year = 2026), e não uma string de data YYYY-MM-DD.

Limites de retrospectiva histórica

A disponibilidade de dados de relatórios históricos depende da granularidade dos segmentos de data selecionados ou filtrados:

• Granularidade diária, semanal e por hora (segments.date, segments.week e segments.hour) : aceita uma janela de lookback de até 37 meses. As consultas que segmentam por segments.date, segments.week ou segments.hour (ou filtram um período inferior a um mês) para datas além da janela de 37 meses falham com DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED na v24 e versões mais recentes (ou DateRangeError.UNKNOWN na v23).
• Granularidade mensal, trimestral, anual ou não segmentada (segments.month, segments.quarter, segments.year ou nenhum segmento de data) : aceita até 11 anos de dados históricos. Para consultar dados históricos além da janela de 37 meses, segmente por segments.month, segments.quarter, segments.year ou omita segmentos de data em SELECT e verifique se o período WHERE começa no primeiro dia de um mês e termina no último dia de um mês (ou filtros em segments.month, segments.quarter ou segments.year).