Die neue Search Ads 360 Reporting API ist jetzt verfügbar. Treten Sie der Google-Gruppe
searchads-api-announcements bei, um über kommende Verbesserungen und Releases auf dem Laufenden zu bleiben.
Zeiträume
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
In der Search Ads 360-Abfragesprache können Sie den Zeitraum auf zwei Arten angeben:
Benutzerdefinierter Zeitraum
Sie können Datumsangaben im ISO 8601-Format(YYYY-MM-DD) angeben:
segments.date BETWEEN '2019-01-01' AND '2019-01-31'
segments.date >= '2019-01-01' AND segments.date <= '2019-01-31'
Zeiträume
Einige Datumsfelder beziehen sich auf einen vordefinierten Zeitraum, nämlich:
segments.weeksegments.monthsegments.quarter
Wenn Sie nach diesen Segmenten filtern, können Sie den Operator = mit dem Datum verwenden, das dem ersten Tag des Zeitraums entspricht. Ab Version 9 wird der Fehler MISALIGNED_DATE_FOR_FILTER zurückgegeben, wenn Sie ein Datum angeben, das nicht der erste Tag eines Zeitraums ist.
Wenn Sie beispielsweise den Monat Mai im Jahr 2021 angeben möchten, verwenden Sie die folgende Bedingung mit dem ersten Tag des Monats:
segments.month = '2021-05-01'
Vordefinierter Zeitraum
Die Liste der gültigen vordefinierten Zeiträume sieht so aus:
| Zeitraum |
Berichte werden generiert für… |
TODAY |
nur heute |
YESTERDAY |
nur gestern |
LAST_7_DAYS |
die letzten sieben Tage ausschließlich heute |
LAST_BUSINESS_WEEK |
eine fünftägige Arbeitswoche, also für Montag bis Freitag der vorangegangenen Arbeitswoche |
THIS_MONTH |
alle Tage im aktuellen Monat |
LAST_MONTH |
alle Tage im vorherigen Monat |
LAST_14_DAYS |
die letzten 14 Tage ausschließlich heute |
LAST_30_DAYS |
die letzten 30 Tage ausschließlich heute |
THIS_WEEK_SUN_TODAY |
den Zeitraum zwischen dem letzten Sonntag und dem heutigen Tag |
THIS_WEEK_MON_TODAY |
den Zeitraum zwischen dem letzten Montag und dem heutigen Tag |
LAST_WEEK_SUN_SAT |
Der 7‑Tage-Zeitraum, der am vorherigen Sonntag beginnt. |
LAST_WEEK_MON_SUN |
Der 7‑Tage-Zeitraum ab dem vorherigen Montag. |
Beispiel:
segments.date DURING LAST_30_DAYS
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-29 (UTC).
[null,null,["Zuletzt aktualisiert: 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"]]
