Official Google Ads API release notes from Google. It lists changes by numbered API version, helping developers track what’s new and what was updated in each release.
Project status
- Actively maintained, with steady cadence. The most recent updates are close to today (v25.1 on 2026-08-19, v25 on 2026-07-22, then several more in late June and May 2026), suggesting ongoing development rather than a dormant state.
- Updates arrive roughly monthly, sometimes with multiple drops in a month. The timeline shows v25.1 (Aug), v25 (Jul), then several v24.x and v23.x updates in June 2026, consistent with a regular release of numbered API updates.
AI summary generated
Recent updates
v25.1
Google Ads API v25.1 expands functionality across Assets, Campaigns, Conversions (Brand Lift and Conversion Lift), Planning, and Reporting. It adds multiple new resources, metrics, segments, and enum/field support, plus new targeting and planning capabilities. Release notes state v25.1 is a minor release with no breaking changes.
Featuresv25
Google Ads API v25 introduces a major update centered on a revamped unified goals schema, with multiple fields changing shape, names, and requiredness. Several request fields become required or are removed, and reporting field types change, which can break existing integrations until the new API contract is adopted.
BreakingFeaturesv23.3
Google Ads API v23.3 primarily adds new data fields and supporting resources for future integration work, including AI-generated content attestations and a beta multi-party approvals workflow. Release notes state that minor versions like v23.3 do not contain breaking changes, and no immediate incompatibilities are mentioned. The main developer action is to start testing the advertiser attestation mutation interface early so you are ready for full write support in v25.
Featuresv22.2
Google Ads API v22.2 adds new fields for Asset.synthetic_content_info to carry attestations for synthetic and AI-generated content, and introduces an early interface for upcoming mutability changes planned for v25. It also expands support for multi-party approvals (MPA) in beta by adding new review resources and status tracking for customer user access.
Featuresv24.2
Google Ads API v24.2 adds new fields and enum values focused on Local Services Ads support (including Performance Max), Demand Gen enhancements, and creator insights search capabilities. It also introduces the early interface work for synthetic/AI content attestations, where some advertiser attestation fields remain immutable until v25. No breaking changes are expected in this minor version, but there is an observable behavioral change in IncentiveService error handling.
BreakingFeaturesv24.1
Google Ads API v24.1 introduces multiple additive changes, including new ad asset fields, expanded experiment support and experiment metrics, and new reporting segments and filters. The release notes state that v24.1 minor versions do not contain breaking changes, so existing code should continue to work without required modifications.
Featuresv24
Google Ads API v24 introduces major behavioral changes for responsive video ads and removes several previously available fields, segments, and enum/category values that existing integrations may reference. It also adds new capabilities and reports (including additional conversion action enums and new reporting resources/metrics), but several changes require client updates to resource namespaces, request payloads, and error handling.
BreakingFeaturesv23.2
Google Ads API v23.2 introduces several new resources and fields, including video enhancement support via a new Assets resource and additional scheduling and Demand Gen controls. The release also includes a behavioral change that now throws an error when using a sunsetted user list customer type category, plus planning/reporting additions for reach and creator insights.
BreakingFeaturesv23.1
Google Ads API v23.1 adds multiple new fields and enum values across account management, campaigns, conversions, planning, and reporting. The release notes indicate v23.1 is a minor version and does not include breaking changes. Notable additions include campaign text_guidelines support and a new YouTubeVideoUpload service for uploading and managing YouTube videos (REST and Python client only).
Featuresv22.1
v22.1 adds Google Ads API fields related to EU political advertising declarations at both the account and campaign levels. The release notes indicate these are additive fields and that minor versions like v22.1 do not contain breaking changes.
Featuresv23
Google Ads API v23 is a major release with several breaking API changes, most notably removal of call ads support and removal/renaming of multiple fields. It also introduces new capabilities across Ads, Reporting, Planning, Incentives, Benchmarks, and Vertical Ads, along with additional enum values and reporting metrics. Upgrade carefully, especially around campaign date fields, demand gen lead form configuration, and reporting label metric availability.
BreakingFeaturesv22
Google Ads API v22 introduces a major set of updates across Demand Gen, Performance Max, Planning, and reporting. It also includes multiple backward-incompatible changes, including field and metric renames, removals of Performance Max asset performance labels and a Campaign URL expansion opt-out field, plus behavioral changes to batch operations and batch result pagination limits.
BreakingFeatures