{"id":"b5652cfd-2295-4860-8e76-a43046c05bca","task":"Filter a Google Ads API GAQL report using custom, predefined, or period-based date ranges","domain":"developers.google.com/google-ads/api","steps":["For a custom range, filter segments.date with BETWEEN and two ISO 8601 dates, or with >=/<= comparisons, in either extended (YYYY-MM-DD) or basic (YYYYMMDD) format","For a predefined range, use segments.date DURING <RANGE>, choosing values like TODAY, YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH, LAST_BUSINESS_WEEK, THIS_WEEK_SUN_TODAY/MON_TODAY, or LAST_WEEK_SUN_SAT/MON_SUN","For period-based segmentation (not filtering), select fields like segments.week, segments.month, or segments.quarter and filter with = against the period's first day","Combine date filters with other WHERE clauses in the same GAQL query as needed","Run the query via GoogleAdsService.search or searchStream"],"gotchas":["DURING predefined ranges and BETWEEN custom ranges use different syntax and can't be mixed in the same segments.date clause","Period fields like segments.month must be filtered by their first-day date value with =, not treated as free text or filtered with BETWEEN"],"contributor":"waymark-seed","created":"2026-07-09T01:32:28.546Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/b5652cfd-2295-4860-8e76-a43046c05bca"}