La nouvelle API Search Ads 360 Reporting est désormais disponible. Rejoignez le groupe Google
searchads-api-announcements pour vous tenir informé des améliorations et versions à venir.
Périodes
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Le langage de requête Search Ads 360 vous permet de spécifier la plage de dates de deux manières :
Période personnalisée
Vous pouvez indiquer les dates au format ISO 8601(YYYY-MM-DD) :
segments.date BETWEEN '2019-01-01' AND '2019-01-31'
segments.date >= '2019-01-01' AND segments.date <= '2019-01-31'
Périodes
Certains champs de date font référence à une période prédéfinie, à savoir :
segments.weeksegments.monthsegments.quarter
Lorsque vous filtrez sur ces segments, vous pouvez utiliser l'opérateur = avec la date correspondant au premier jour de la période. À partir de la version 9, si vous spécifiez une date qui n'est pas le premier jour d'une période, une erreur MISALIGNED_DATE_FOR_FILTER est renvoyée.
Par exemple, pour spécifier le mois de mai 2021, vous devez utiliser la condition suivante, en indiquant le premier jour de ce mois :
segments.month = '2021-05-01'
Plage de dates prédéfinie
Voici la liste des périodes 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 exclu. |
LAST_BUSINESS_WEEK |
La semaine ouvrée 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, sans compter aujourd'hui. |
LAST_30_DAYS |
Les 30 derniers jours, sans compter la journée en cours. |
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 sept jours commençant le dimanche précédent. |
LAST_WEEK_MON_SUN |
Période de sept jours commençant le lundi précédent. |
Exemple :
segments.date DURING LAST_30_DAYS
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[[["\u003cp\u003eThe Search Ads 360 Query Language allows specifying date ranges using either custom dates or predefined date ranges.\u003c/p\u003e\n"],["\u003cp\u003eCustom date ranges can be defined using ISO 8601 format and operators like \u003ccode\u003eBETWEEN\u003c/code\u003e, \u003ccode\u003e>=\u003c/code\u003e, and \u003ccode\u003e<=\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTime period segments such as week, month, and quarter require filtering with the first day of the period using the \u003ccode\u003e=\u003c/code\u003e operator.\u003c/p\u003e\n"],["\u003cp\u003ePredefined date ranges offer shortcuts for common periods like \u003ccode\u003eTODAY\u003c/code\u003e, \u003ccode\u003eLAST_7_DAYS\u003c/code\u003e, \u003ccode\u003eLAST_MONTH\u003c/code\u003e, and others, simplifying query construction.\u003c/p\u003e\n"],["\u003cp\u003eSpecifying a date that is not the first day of a period for segments like \u003ccode\u003esegments.month\u003c/code\u003e will result in a \u003ccode\u003eMISALIGNED_DATE_FOR_FILTER\u003c/code\u003e error.\u003c/p\u003e\n"]]],["The Search Ads 360 Query Language uses custom or predefined date ranges. Custom ranges utilize ISO 8601 format (YYYY-MM-DD) for specific dates (e.g., `segments.date BETWEEN '2019-01-01' AND '2019-01-31'`). For segments like `week`, `month`, or `quarter`, filters must use the first day of the period. Predefined ranges, such as `TODAY`, `LAST_7_DAYS`, or `LAST_MONTH`, offer shortcuts (e.g., `segments.date DURING LAST_30_DAYS`).\n"],null,["# Date Ranges\n\nThe Search Ads 360 Query Language lets you specify the date range in two ways:\n\n- custom date range\n\n- predefined date range\n\nCustom date range\n-----------------\n\nYou can specify dates in ISO 8601(`YYYY-MM-DD`) format: \n\n segments.date BETWEEN '2019-01-01' AND '2019-01-31'\n\n segments.date \u003e= '2019-01-01' AND segments.date \u003c= '2019-01-31'\n\n### Time periods\n\nSome date fields refer to a predefined period of time, specifically:\n\n- `segments.week`\n- `segments.month`\n- `segments.quarter`\n\nWhen filtering on these segments, you can use the `=` operator with the date\nthat is the first day of the time period. Starting in v9, if you specify a date\nthat is not the first day of a period, a `MISALIGNED_DATE_FOR_FILTER` error is\nreturned.\n\nFor example, to specify the month of May in the year 2021, you would use the\nfollowing condition, specifying the first day of that month: \n\n segments.month = '2021-05-01'\n\nPredefined date range\n---------------------\n\nThe list of valid predefined date ranges is as follows:\n\n| Date range | Reports are generated for... |\n|-----------------------|--------------------------------------------------------------------------------|\n| `TODAY` | Today only. |\n| `YESTERDAY` | Yesterday only. |\n| `LAST_7_DAYS` | The last 7 days not including today. |\n| `LAST_BUSINESS_WEEK` | The 5 day business week, Monday through Friday, of the previous business week. |\n| `THIS_MONTH` | All days in the current month. |\n| `LAST_MONTH` | All days in the previous month. |\n| `LAST_14_DAYS` | The last 14 days not including today. |\n| `LAST_30_DAYS` | The last 30 days not including today. |\n| `THIS_WEEK_SUN_TODAY` | The period between the previous Sunday and the current day. |\n| `THIS_WEEK_MON_TODAY` | The period between the previous Monday and the current day. |\n| `LAST_WEEK_SUN_SAT` | The 7-day period starting with the previous Sunday. |\n| `LAST_WEEK_MON_SUN` | The 7-day period starting with the previous Monday. |\n\nExample: \n\n segments.date DURING LAST_30_DAYS"]]
