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
- Official Google Ads API updates are actively maintained, with the latest update, v26.1, dated October 28, 2026, just eight days before today.
- Recent updates have arrived roughly every few weeks, with major versions appearing about every three months and minor updates in between.
AI summary generated
Recent updates
v26.1
Google Ads API v26.1 adds campaign budget controls for prioritizing network channels, new Local Services eligibility and redemption-provider capabilities, and promotion redemption tracking. It also expands recommendations, reach reporting, search share reporting, and Performance Max targeting; the release notes state that this minor version contains no breaking changes.
Featuresv26
Google Ads API v26 is a major release with several schema and validation changes that affect Local Services Performance Max campaign creation and travel bid modifier targeting criteria. It also unifies Enhanced Conversions configuration, replacing the prior enhanced_conversions_for_leads_enabled field, and updates criterion field/type names and error reason enums for travel targeting. Most other additions are new fields, enums, and expanded support across assets, campaigns, reports, and YouTube disclosures.
BreakingFeaturesv25.2
Google Ads API v25.2 adds several new capabilities across asset URL handling, Performance Max automation, conversions, planning/benchmarks, insights search, and bid recommendations. This release notes guidance explicitly states that minor version v25.2 does not include breaking changes, but it does introduce new request/response fields and validation errors that may affect integrations that rely on strict schemas or error handling.
Featuresv25.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.
BreakingFeaturesv22.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.
Featuresv23.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.
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