Plages de dates

Le langage de requête Google Ads vous permet de spécifier la plage de dates de différentes manières :

• Plage de dates personnalisée
• Plage de dates prédéfinie
• Période prédéfinie
• Limites de la période d'analyse historique

Remarque : Toutes les plages de dates et périodes sont évaluées par rapport au fuseau horaire du compte de diffusion (customer.time_zone), plutôt qu'au temps UTC ou au fuseau horaire local du client API.

Plage de dates personnalisée

Vous pouvez spécifier des dates au format ISO 8601 étendu (YYYY-MM-DD) ou de base (YYYYMMDD). Le format étendu (YYYY-MM-DD) est recommandé pour une meilleure lisibilité. Utilisez BETWEEN ou des opérateurs de comparaison (=, >, >=, <, <=) avec des chaînes de date personnalisées :

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

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

Plage de dates prédéfinie

Utilisez l'opérateur DURING avec des littéraux de plage de dates prédéfinis. L'opérateur DURING n'accepte que les plages de dates prédéfinies et ne peut pas être utilisé avec des chaînes de date personnalisées.

Voici la liste des plages de dates prédéfinies valides :

Plage de dates	Les rapports sont générés pour...
TODAY	Aujourd'hui uniquement.
YESTERDAY	Hier uniquement.
LAST_7_DAYS	Les sept derniers jours, aujourd'hui non compris.
LAST_BUSINESS_WEEK	La semaine de travail de 5 jours, du lundi au vendredi, de la semaine précédente.
THIS_MONTH	Tous les jours du mois en cours.
LAST_MONTH	Tous les jours du mois précédent.
LAST_14_DAYS	Les 14 derniers jours, aujourd'hui non compris.
LAST_30_DAYS	Les 30 derniers jours, aujourd'hui non compris.
THIS_WEEK_SUN_TODAY	La période comprise entre le dimanche précédent et le jour actuel.
THIS_WEEK_MON_TODAY	La période comprise entre le lundi précédent et le jour actuel.
LAST_WEEK_SUN_SAT	La période de 7 jours commençant le dimanche précédent.
LAST_WEEK_MON_SUN	La période de 7 jours commençant le lundi précédent.

Exemple :

segments.date DURING LAST_30_DAYS

Période prédéfinie

Certains champs de date font référence à une période prédéfinie, en particulier :

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

Lorsque vous filtrez ces segments avec des chaînes de date personnalisées (à l'aide de =, BETWEEN, >=, <=, >, ou <), vous devez spécifier une date correspondant au premier jour de la période :

• segments.week : lundi de la semaine (par exemple, '2026-05-04').
• segments.month : premier jour du mois (YYYY-MM-01, par exemple, '2026-05-01').
• segments.quarter : premier jour du trimestre civil (YYYY-01-01, YYYY-04-01, YYYY-07-01 ou YYYY-10-01).

Si vous spécifiez une date qui n'est pas le premier jour de la période, l'erreur QueryError.MISALIGNED_DATE_FOR_FILTER est renvoyée. Vous pouvez également filtrer ces segments à l'aide de l'opérateur DURING avec une plage de dates prédéfinie.

Par exemple, pour spécifier le mois de mai de l'année 2026, utilisez la condition suivante en indiquant le premier jour de ce mois :

segments.month = '2026-05-01'

Remarque segments.year est filtré à l'aide d'un entier de l'année à quatre chiffres (par exemple, segments.year = 2026) plutôt qu'une chaîne de date YYYY-MM-DD.

Limites de la période d'analyse historique

La disponibilité des données de reporting historiques dépend de la précision des segments de date sélectionnés ou filtrés :

• Précision quotidienne, hebdomadaire et horaire (segments.date, segments.week et segments.hour) : prend en charge une période d'analyse historique de 37 mois maximum. Les requêtes qui segmentent par segments.date, segments.week, ou segments.hour (ou qui filtrent sur une plage de dates inférieure à un mois) pour des dates dépassant la période de 37 mois échouent avec DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED dans la version 24 et ultérieures (ou DateRangeError.UNKNOWN dans la version 23).
• Précision mensuelle, trimestrielle, annuelle ou non segmentée (segments.month, segments.quarter, segments.year ou aucun segment de date) : prend en charge jusqu'à 11 ans de données historiques. Pour interroger des données historiques au-delà de la période de 37 mois, segmentez par segments.month, segments.quarter, segments.year ou omettez les segments de date dans SELECT, et assurez-vous que la plage de dates WHERE commence le premier jour d'un mois et se termine le dernier jour d'un mois (ou filtre sur segments.month, segments.quarter ou segments.year).