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 l'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 fuseau horaire UTC ou au fuseau horaire local du client API.

Période personnalisée

Vous pouvez spécifier des dates au format étendu (YYYY-MM-DD) ou de base (YYYYMMDD) de la norme ISO 8601. 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'est compatible qu'avec 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 seulement.
YESTERDAY	Hier seulement.
LAST_7_DAYS	Les sept derniers jours, aujourd'hui non inclus.
LAST_BUSINESS_WEEK	La semaine de travail de cinq jours, du lundi au vendredi, de la semaine ouvrée 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 inclus.
LAST_30_DAYS	Les 30 derniers jours, aujourd'hui non inclus.
THIS_WEEK_SUN_TODAY	Période comprise entre le dimanche précédent et le jour actuel.
THIS_WEEK_MON_TODAY	Période comprise entre le lundi précédent et le jour actuel.
LAST_WEEK_SUN_SAT	Période de 7 jours commençant le dimanche précédent.
LAST_WEEK_MON_SUN	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, à savoir :

• 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, une 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 spécifiant le premier jour de ce mois :

segments.month = '2026-05-01'

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

Limites de l'historique des données

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

• Granularité quotidienne, hebdomadaire et horaire (segments.date, segments.week et segments.hour) : accepte une période d'analyse allant jusqu'à 37 mois. Les requêtes qui segmentent par segments.date, segments.week ou segments.hour (ou qui filtrent sur une période inférieure à un mois) pour des dates au-delà de la période de 37 mois échouent avec l'erreur DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED dans la v24 et les versions ultérieures (ou DateRangeError.UNKNOWN dans la v23).
• Précision mensuelle, trimestrielle, annuelle ou non segmentée (segments.month, segments.quarter, segments.year ou aucun segment de date) : 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 ou 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 filtrez sur segments.month, segments.quarter ou segments.year).