MarketingNew Release12 min readPublished August 19, 2026

A minor API release · 2 new Campaign fields · the AI Max migration timestamp, now queryable

Query the Date Google Migrates You to AI Max

Google Ads API v25.1 shipped on August 19, 2026 as a minor, fully backward-compatible release — no breaking changes, no forced API migration. But buried in its release-notes table are two new Campaign fields that carry, per campaign, a timestamp for the auto-migration to AI Max that Google scheduled for September 2026. Google’s own documentation does not settle whether that timestamp appears before the migration runs or only after it — and Google’s announcement post doesn’t mention the fields once.

DA
Digital Applied Team
Senior strategists · Published Aug 19, 2026
PublishedAug 19, 2026
Read time12 min
SourcesGoogle primary docs
Breaking changes in v25.1
0
minor version, per Google
New migration-date fields
2
on the Campaign resource
Mentions in Google's own highlights
0
of 5 'New Features' bullets
ACA + broad match auto-upgrade
Sept'26
announced window
DSA: Feb 2027

Google Ads API v25.1, released Wednesday, August 19, 2026, is about as unglamorous as API releases get — a minor version, fully backward compatible with v25, that Google’s own team calls a drop-in upgrade. Yet its release-notes table quietly adds the only two fields in the release with real deadline consequences attached: Campaign.aca_migration_date_time and Campaign.broad_match_migration_date_time.

Here is why those two fields matter. Back in April 2026, Google announced that campaigns using Automatically Created Assets (ACA) and the campaign-level broad match setting will be auto-upgraded to AI Max “starting in September 2026” — a month-level window, with upgrades expected to conclude by the end of September. Until now, an advertiser managing dozens or hundreds of affected campaigns had no way to see anything more precise than “sometime in September.” v25.1 is the first API surface where a per-campaign migration timestamp can be queried at all.

This guide covers what v25.1 actually is (and is not), exactly what the two migration-date fields document — including a genuine ambiguity in Google’s own descriptions that you should not paper over — a runnable GAQL query, the September migration clock for ACA and broad match versus the delayed Dynamic Search Ads timeline, and a triage of everything else in the release.

Key takeaways
  1. 01
    v25.1 is a minor, backward-compatible release.Released August 19, 2026. Google states minor versions like v25.1 don't contain breaking changes — this is not an API migration. You only need to upgrade client libraries to use the new capabilities.
  2. 02
    Two new Campaign fields carry your AI Max migration timestamp.aca_migration_date_time and broad_match_migration_date_time are output-only string timestamps in the customer's timezone, queryable from v25.1 onward — the first API surface where a per-campaign timestamp for this forced migration can be queried.
  3. 03
    Google's own announcement buried them.The Ads Developer Blog post lists five 'New Features' highlights — lift measurement, benchmarks, sentiment, loyalty, conversion value — and omits both migration-date fields entirely. They appear only in the full release-notes delta table.
  4. 04
    The fields' timing semantics are genuinely ambiguous.The release notes frame them as forward-looking ('Track the upcoming auto-migration'); the RPC reference describes them in the past tense ('the timestamp when the campaign was migrated'). No primary source resolves whether they pre-populate. Check your own account.
  5. 05
    The deadline is real — and it is not the DSA deadline.ACA and campaign-level broad match auto-upgrade starting September 2026, expected to conclude by end of month. Dynamic Search Ads' separate migration was delayed to February 2027. Conflating the two clocks is the common error.

01The ReleaseWhat v25.1 actually is — and is not.

First, the framing that matters for anyone triaging their sprint backlog: v25.1 is not a migration event for your API integration. Google’s release notes state it plainly: “The following new features and updates were added in Google Ads API v25.1. Minor versions like v25.1 don’t contain breaking changes.” Existing v25 integrations keep working untouched. The release landed exactly four weeks after v25 itself, which shipped July 22, 2026.

The one operational requirement, per the announcement post: “To use the new capabilities, you must upgrade your client libraries and client code.” The two migration-date fields do not exist in v25 or any earlier version — they appear only in the v25.1 delta. If your integration is pinned to an older version, the fields are invisible to you until you bump it.

That version discipline is a running theme — we made the same point about the v23.1 API release and the April 2026 core update: the API surface moves on a fixed cadence, and teams that lag versions quietly lose access to fields that matter. This time, what lagging costs you is visibility into a deadline.

"Google Ads API v25.1 is a drop-in upgrade for v25."— Anash P. Oommen, Google Ads API Team, Ads Developer Blog

02The Buried LeadTwo fields Google’s own announcement never mentions.

The announcement post’s “New Features” section lists five highlights: Brand Lift and Conversion Lift measurement, BenchmarksService upgrades, Brand Sentiment Insights, loyalty-tier segmentation, and original conversion value. Not one of the five mentions aca_migration_date_time or broad_match_migration_date_time. The two fields appear only in the full release-notes delta table, with a one-line description: “Track the upcoming auto-migration to AI Max.”

That asymmetry is the reason this post exists. The five headline features are either allowlist-gated or additive reporting dimensions. The two unheadlined fields are open to every account on v25.1 and are attached to a dated, involuntary change to how your Search campaigns match and write ads. Anyone triaging the release from Google’s announcement post rather than the full delta table will read v25.1 as a routine minor bump and never learn that a per-campaign migration timestamp now exists.

ACA campaigns
ACA migration timestamp
Campaign.aca_migration_date_time

Output only. A string timestamp for the campaign's migration to AI Max, in the customer's timezone, formatted yyyy-MM-dd HH:mm:ss. Applies to campaigns using Automatically Created Assets.

Campaign resource · min. v25.1
Broad match campaigns
Broad match migration timestamp
Campaign.broad_match_migration_date_time

Output only. The same string-timestamp shape, for campaigns using the campaign-level broad match setting. Same timezone and format rules as the ACA field.

Campaign resource · min. v25.1
Why the burial matters
Google led its highlights with a measurement build-out that needs an allowlist, followed by four additive reporting and planning upgrades with no clock on them — and left out the two fields attached to a deadline. The release-notes delta table — not the announcement blog — is where the operationally urgent change lives. If your team triages Google Ads API releases by reading the blog post, this release is the argument for reading the full table instead.

03Field SemanticsWhat the fields say — and what they don’t.

The documented spec is thin but concrete. Per the Campaign RPC reference, both fields are type string and output only — you cannot set them via mutate operations; they only report what Google’s systems have determined for that campaign. The timestamp renders in the customer’s account timezone in yyyy-MM-dd HH:mm:ss format.

The tense problem Google left open

Here is where honesty beats a clean narrative. Google’s two primary descriptions of these fields do not agree on when the value appears. The release-notes summary is forward-looking: “Track the upcoming auto-migration to AI Max.” The RPC reference’s own per-field description is past tense: the field holds “the timestamp when the ACA campaign was migrated to AI Max.” One reading says the field pre-populates with a scheduled date you can plan against; the other says it fills in only after migration has executed, making it a historical record rather than an early-warning system.

No primary source we could find resolves this. Google also documents nothing about what the field returns for a campaign with no migration scheduled — do not assume null, empty string, or any specific sentinel. The practical move: query the fields against your own accounts and see what comes back today. If values are present ahead of September, you have a planning date. If they are empty, re-query on a schedule — the field is still the surface where the date will land, whichever reading turns out to be right.

Verification caveat
One more reason to test rather than assume: when we checked it, Google’s generated field-metadata page for the campaign resource did not list either new field — so the usual metadata flags (filterable, sortable) are unconfirmed. The release notes and RPC reference are the authoritative sources for these two fields right now.

04The QueryThe GAQL query to run this week.

Selecting the fields is standard GAQL — a plain SELECT ... FROM campaign against GoogleAdsService.Search or SearchStream, on API version v25.1 or later:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  campaign.aca_migration_date_time,
  campaign.broad_match_migration_date_time
FROM campaign
WHERE campaign.status = 'ENABLED'

Two deliberate limits in that query. First, it filters only on campaign.statusnot on either migration field. Because the generated field metadata for the two new fields had not appeared when we checked, whether they are filterable in a WHERE clause is unconfirmed; select them and filter client-side rather than gambling a scheduled job on an undocumented capability. Second, it selects across all enabled campaigns rather than trying to pre-guess which ones use ACA or broad match — let the field values (or their absence) tell you which campaigns Google considers in scope.

If you already run scheduled reporting against the API, this is a one-query addition. If you don’t, this release is a good reason to start — automating Google Ads API queries like this one is exactly the kind of low-effort, high-information monitoring that pays for itself the first time a platform deadline moves. Pull the fields daily into a sheet or warehouse, diff against yesterday, and alert on any change. Whichever way the population semantics resolve, a daily diff catches it.

05The DeadlineThe September clock — and the delayed one it gets confused with.

The migration these fields report on was announced well before v25.1. Google’s April 15, 2026 blog post on the AI Max transition — updated June 11, 2026 — set the schedule: campaigns using Automatically Created Assets and the campaign-level broad match setting auto-upgrade to AI Max starting in September 2026, with Google expecting “all upgrades for eligible campaigns to conclude by the end of September.” Trade press has glossed the start as September 1 — Search Engine Land reported it that way on August 6 — but Google’s own post commits only to the month, not a day. Which is precisely the gap the new fields close: a per-campaign timestamp inside a month-wide window.

"Please note that campaigns using Automatically Created Assets (ACA) and campaign-level broad match setting will continue to be auto-upgraded starting in September 2026."— Brandon Ervin, Director of Product Management, Google Ads

The same June update that reconfirmed the September window also did something that has confused a lot of coverage since: it delayed a different legacy feature. Dynamic Search Ads’ sunset and auto-upgrade — originally on the same September timeline — was pushed to February 2027. A reader who saw DSA headlines and concluded “the AI Max migration got delayed” would be exactly wrong about their ACA and broad-match campaigns. We covered the DSA delay to February 2027 separately; this table is the reconciled view of all three clocks.

Legacy-feature migration clock comparing Dynamic Search Ads, Automatically Created Assets, and campaign-level broad match: auto-upgrade window, status as of August 2026, and the default AI Max settings Google says apply on migration.
Legacy featureAuto-upgrade windowStatus as of Aug 2026Defaults applied on migration
On the September 2026 clock — trackable via v25.1 fields
Automatically Created Assets (ACA)Starting September 2026; Google expects upgrades to conclude by end of SeptemberOn schedule — reconfirmed in the June 11 updateAI Max with search term matching and text customization enabled by default; other settings configured to mirror the legacy setup
Campaign-level broad matchSame September 2026 window, same expected end-of-month conclusionOn schedule — reconfirmed in the June 11 updateAI Max with search term matching enabled by default — text customization is not switched on by default on this path, unlike ACA
On a different clock — do not conflate
Dynamic Search Ads (DSA)Delayed to February 2027 (was originally also September 2026)Delayed — the June 11 update extended this timeline onlyGoogle frames all these upgrades as mirroring legacy settings; DSA-specific defaults are covered in our DSA playbook, not here

Two more things the primary sources establish about what lands in September. Google frames the change as an in-place upgrade — “AI Max will be enabled with settings configured to mirror your legacy setup once the auto-upgrades are complete” — not a campaign rebuild. And no primary Google source documents an opt-out from the migration itself: the April post describes a voluntary-upgrade phase followed by automatic upgrades for remaining eligible campaigns, with advance in-account notifications. The new fields reveal the date; they do not give you a lever to avoid it. Worth noting for expectation-setting: Google’s own April post carries a footnoted claim that the full AI Max feature suite drove roughly 7% more conversions or conversion value at similar CPA/ROAS versus search term matching alone — that is a vendor-stated figure whose methodology the post does not disclose, so treat it as Google’s claim rather than an audited benchmark. For what actually changes in your ads once a campaign lands there, see AI Max’s text and brand-safety guidelines.

06Full Release TriageEverything else in v25.1, triaged by whether you can act on it.

The rest of the release is genuinely substantial — it just carries no deadline. The most useful lens for a busy PPC lead is not “what shipped” but “what can I use today without asking Google for anything.” By that lens the release splits cleanly into four tiers: the two open-to-everyone migration fields, an allowlist-gated measurement build-out, additive planning and reporting surfaces, and housekeeping.

Migration fields
New Campaign fields
2

aca_migration_date_time and broad_match_migration_date_time — open to every account on v25.1, tied to the September 2026 window. The only items in the release attached to a date.

Open to all
Brand Lift
Read-only dimensional resources
5

LiftMeasurementAgeRange, LiftMeasurementCampaign, LiftMeasurementDevice, LiftMeasurementGender, LiftMeasurementVideo — Brand Lift results sliced by dimension.

Allowlist-gated
Conversion Lift
New statistical metrics
24

Winner-score metrics for statistical analysis, alongside the new LiftMeasurementConfig resource representing a lift study and LiftMeasurementFlight for flight start and end dates.

Allowlist-gated
Triage of every Google Ads API v25.1 feature by type, access level, and whether an advertiser can act on it today, grouped into open-to-all fields, allowlist-gated measurement, additive planning and reporting, and enum or criterion housekeeping.
FeatureWhat it isAccessCan you act on it today?
Queryable by anyone on v25.1 — and attached to a deadline
aca_migration_date_time + broad_match_migration_date_timeOutput-only string timestamps on the Campaign resourceOpen to all accountsYes — select them this week; tied to the September 2026 auto-upgrade window
Allowlist-gated measurement build-out
Brand Lift dimensional resources (5)Read-only results by age range, campaign, device, gender, videoAllowlisted accounts only — via your Google account representativeOnly if allowlisted; otherwise a request to raise with your Google rep
LiftMeasurementConfig + 24 Conversion Lift metrics + LiftMeasurementFlightA read-only resource representing a lift study, winner-score statistical metrics, and flight start/end datesAllowlisted accounts onlySame — allowlist first
Additive planning and reporting — no urgency, real utility
BenchmarksService upgradescategory_filter on GenerateBenchmarksMetrics (categories discoverable via ListBenchmarksSources), plus new AggregateMetrics (cost, views) and ShareMetrics with share_of_voiceOpenYes — benchmark against Product & Service Categories and pull share of voice
ReachPlanService parental_statusesParental-status targeting on Targeting and PlannableTargeting for reach forecastsOpenYes, if you use reach planning
BrandSentimentInsightSentiment data on creators and brands via ContentCreatorInsightsService, with distribution and summary messages and a Sentiment enumOpenYes, for creator-led planning
Metrics.original_conversion_valueThe unadjusted conversion value from biddable conversions, before value rules or lifecycle goal adjustmentsOpenYes — useful for auditing how much value rules move your numbers
Segments.loyalty_membershipSegments report metrics by the converting user's loyalty-program tier; companion LOYALTY_MEMBERSHIP dimension for conversion value rulesOpenYes, if you run loyalty programs
Enum and criterion housekeeping
TEXT_DISCLAIMER enums · vertical_ads_item_bid · campaign_specific_app_goal_recommendationFirst-class enum support for text disclaimer assets; a new Vertical Ads criterion type; a recommendation suggesting campaign-specific app conversion goals via a new EffectiveAutomaticGoal resourceOpenInformational for most teams — relevant only if you touch those surfaces

Note the pattern: everything Google chose to headline sits in the middle two tiers — gated, or additive with no clock attached. The top tier, open to everyone and deadline-bound, went unheadlined. Per the announcement itself, both lift-measurement features “are available only to allowlisted Google Ads accounts” — which makes the editorial choice stranger, not less: the item given top billing is one most advertisers cannot touch without asking Google first, and the fields every advertiser can query today were left out entirely.

07Action PlanWhat to do before September.

The window between this release and the start of the announced migration is short. Here is how we are sequencing it for managed accounts — the same sequencing our paid media team applies whenever a platform sets an involuntary change against a date.

This week
Pull both fields across every account

Upgrade one reporting client to v25.1 and run the SELECT above against all enabled campaigns. You are establishing a baseline: which campaigns return values, which return nothing, and what the timestamps say if present.

Query first
Ongoing
Diff daily, alert on change

Because Google has not documented whether the fields pre-populate, a one-off query is not enough. Schedule the pull, diff against the prior day, and alert on any new or changed value. That converts an ambiguous field into a reliable tripwire.

Automate the watch
Before migration
Prep ACA and broad match campaigns for AI Max

Migrated ACA campaigns land with search term matching and text customization on by default; broad-match campaigns get search term matching only. Review brand-safety controls, text guidelines, and negative strategies now, while the change is still ahead of you.

Prep the landing zone
Scope control
Keep the DSA clock separate

Dynamic Search Ads migrate in February 2027, not September 2026. Do not let the DSA delay lull you on ACA and broad match, and do not burn September prep time on DSA campaigns that have five extra months.

Two clocks, two plans

Looking forward, the more interesting signal is the mechanism itself. Google had communicated this particular forced upgrade as a blog sentence and an in-account notification; v25.1 puts the same schedule behind a queryable, per-campaign API field. We have not audited every earlier release for a comparable field, so we are not claiming a first — only that it is a notably different delivery mechanism for a deadline. If the pattern holds — and the broader AI Max transition playbook suggests several more legacy surfaces will eventually take the same road — then “watch the Campaign resource for new migration fields” becomes a standing item in API release triage. Teams that build the monitoring muscle now, on two fields, will already have the pipeline when the next forced migration ships its own timestamp. That is speculative on our part, clearly labeled — but it is the direction the tooling points.

08ConclusionA minor release with two genuinely consequential fields.

The bottom line

The deadline was already set. Now there is a field for it.

Google Ads API v25.1 changes nothing about your integration and everything about your visibility. The release itself is a drop-in minor version — no breaking changes, no forced API work. The two fields it adds, aca_migration_date_time and broad_match_migration_date_time, are the first API surface where a per-campaign timestamp can be queried for the auto-migration Google scheduled months ago for September 2026.

Be precise about what is and is not known. Known: the fields exist from v25.1, they are output-only timestamps in your account timezone, and the ACA and broad-match migration window is September 2026 while DSA’s is February 2027. Not known: whether the fields populate ahead of migration or only after it executes, what they return when nothing is scheduled, and whether they can be filtered in GAQL. Query your own accounts, diff daily, and let the data resolve the ambiguity for your book of campaigns specifically.

The quiet lesson is about where platform truth lives. Google headlined five features — one of them allowlist-gated, the other four additive reporting and planning upgrades with no date attached — and left out the two fields every account can query against a real deadline. The release-notes delta table — not the announcement post — was the document that mattered. Read the table.

Get ahead of forced platform migrations

September is already on the clock. Your response plan should be already written.

Our team runs Google Ads API monitoring, migration prep, and AI Max transition planning for advertisers and agencies — built on primary-source release tracking, not recycled changelogs.

Free consultationExpert guidanceTailored solutions
What we work on

Paid media engagements

  • Google Ads API reporting and migration monitoring
  • AI Max transition prep — brand safety and text controls
  • Broad match and ACA campaign audits before September
  • Cross-platform paid media strategy and measurement
  • Deadline-driven platform-change response plans
FAQ · Google Ads API v25.1

The questions advertisers are actually asking.

No. v25.1, released August 19, 2026, is a minor version, and Google's release notes state that minor versions like v25.1 don't contain breaking changes — existing v25 integrations continue to work unchanged. The Google Ads API team describes it as a drop-in upgrade for v25. The only requirement is conditional: to use any of the new capabilities, including the two migration-date fields, you must upgrade your client libraries and client code to v25.1, because the new fields and resources do not exist in v25 or any earlier version. If you do nothing, nothing breaks — but you also cannot see the migration-date fields until you upgrade.
Related dispatches

Continue exploring paid media shifts.