Períodos

El lenguaje de consulta de Google Ads te permite especificar el período de las siguientes maneras:

• Período personalizado
• Período predefinido
• Intervalo de tiempo predefinido
• Límites de períodos históricos

Nota: Todos los períodos y los intervalos de tiempo se evalúan en relación con la zona horaria de la cuenta de publicación (customer.time_zone), en lugar de UTC o la zona horaria local del cliente de API.

Período personalizado

Puedes especificar fechas en ISO 8601 formato extendido (YYYY-MM-DD) o básico (YYYYMMDD). Se recomienda el formato extendido (YYYY-MM-DD) para facilitar la lectura. Usa BETWEEN o los operadores de comparación (=, >, >=, <, <=) con cadenas de fecha personalizadas:

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

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

Período predefinido

Usa el operador DURING con literales de períodos predefinidos. El operador DURING solo admite períodos predefinidos y no se puede usar con cadenas de fecha personalizadas.

La lista de períodos predefinidos válidos es la siguiente:

Período	Los informes se generan para...
TODAY	Solo hoy
YESTERDAY	Solo ayer
LAST_7_DAYS	Los últimos 7 días sin incluir hoy
LAST_BUSINESS_WEEK	La semana laboral de 5 días, de lunes a viernes, de la semana laboral anterior
THIS_MONTH	Todos los días del mes actual
LAST_MONTH	Todos los días del mes anterior
LAST_14_DAYS	Los últimos 14 días sin incluir hoy
LAST_30_DAYS	Los últimos 30 días sin incluir hoy
THIS_WEEK_SUN_TODAY	El período comprendido entre el domingo anterior y el día actual
THIS_WEEK_MON_TODAY	El período comprendido entre el lunes anterior y el día actual
LAST_WEEK_SUN_SAT	El período de 7 días que comienza el domingo anterior
LAST_WEEK_MON_SUN	El período de 7 días que comienza el lunes anterior

Ejemplo:

segments.date DURING LAST_30_DAYS

Intervalo de tiempo predefinido

Algunos campos de fecha hacen referencia a un período predefinido, específicamente:

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

Cuando filtres estos segmentos con cadenas de fecha personalizadas (con =, BETWEEN, >=, <=, >, o <), debes especificar una fecha que sea el primer día del período:

• segments.week: El lunes de la semana (por ejemplo, '2026-05-04').
• segments.month: El primer día del mes (YYYY-MM-01, por ejemplo, '2026-05-01').
• segments.quarter: El primer día del trimestre calendario (YYYY-01-01, YYYY-04-01, YYYY-07-01 o YYYY-10-01).

Si especificas una fecha que no es el primer día del período, se muestra un QueryError.MISALIGNED_DATE_FOR_FILTER error. También puedes filtrar estos segmentos con el operador DURING con un período predefinido.

Por ejemplo, para especificar el mes de mayo del año 2026, usa la siguiente condición y especifica el primer día de ese mes:

segments.month = '2026-05-01'

Nota: segments.year se filtra con un número entero de año de 4 dígitos (por ejemplo, segments.year = 2026) en lugar de una cadena de fecha YYYY-MM-DD.

Límites de períodos históricos

La disponibilidad de los datos de informes históricos depende del nivel de detalle de los segmentos de fecha seleccionados o filtrados:

• Nivel de detalle diario, semanal y por hora (segments.date, segments.week y segments.hour): Admite una ventana de visualización de hasta 37 meses. Las consultas que segmentan por segments.date, segments.week o segments.hour (o que filtran un período inferior a un mes) para fechas posteriores al período de 37 meses fallan con DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED en la v24 y versiones posteriores (o DateRangeError.UNKNOWN en la v23).
• Nivel de detalle mensual, trimestral, anual o sin segmentar (segments.month, segments.quarter, segments.year o sin segmento de fecha): Admite hasta 11 años de datos históricos. Para consultar datos históricos más allá del período de 37 meses, segmenta por segments.month, segments.quarter, segments.year o omite los segmentos de fecha en SELECT y asegúrate de que el período de WHERE comience el primer día de un mes y termine el último día de un mes (o que filtre por segments.month, segments.quarter o segments.year).