Google has released version 24.1 of the Google Ads API, this is a minor release with dozens of updates. This update includes features like mobile device platform segment, classic images in DemandGen, support for passkeys, revamped support of experiments, and support for the new data retention policy.
Google wrote, "Today, we’re announcing the v24.1 release of the Google Ads API."
Before this release was version 24 in April, then 23.2 in March, then v23.1 in February and then 23 at the end of January, then version 22 on October 15, 2025, then version 21 on August 6, 2025 , then 20 on June 5, 2025, 19.1 in April 2025, then 19 in February 2025, then version 18 in October 2024. Before that was 17.1 in August 2024 and then before that was version 17.0 in June 2024 and then before that was version 16.1 and then Version 16 in February 2024. Before that was version 15 back in October 2023. Then before that was version 14.1 which was released in August. Version 13.1 preceded this new version, which was released in April 2023. Version 12.0 was released in October 2022, Version 11.0 of the Google Ads API was released in June, and version 11.1 was in August. Also Version 10.1 was released on April 27, 2022 and version 10.0 was released on February 9, 2022. And Google has sunset the AdWords API on April 27th which will completely stop working at the end of July.
Here are the release notes:
Ads:
- Added the field classic_display_images to DemandGenMultiAssetAd. These are custom uploaded images that are served without requiring additional assets and not as part of responsive ad formats.
General:
- Added CustomerUserAccess.passkey_enabled to the CustomerUserAccess resource. This read-only field indicates whether the user has a passkey enabled.
Experiments:
- Added support for the following new ExperimentTypeEnum types: ADOPT_AI_MAX, ADOPT_BROAD_MATCH_KEYWORDS, OPTIMIZE_ASSETS and PMAX_REPLACEMENT_SHOPPING.
- Added configuration support for existing YOUTUBE_CUSTOM experiments consisting of Video campaigns, using the new video_experiment field in Experiment.
- Added the following fields to ExperimentArm to support asset testing, asset groups, and Performance Max experiment settings
Reports:
- Add support for the mobile_device_platform segment, allowing for reporting segmented by the device's platform (such as iOS or Android).
- Publish REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED. The requested time granularity is not supported for the date range in the query. Metrics with daily, hourly, or weekly segmentation are only available for the last 37 months.
- Added the following segments to be used for vertical ads: vertical_ads_listing_user_rating and vertical_ads_listing_venue
- Added support for experiment metrics across seven core metric families: Clicks, Impressions, Cost Conversions, Cost per conversion, Conversion value, Conversion value per cost
- For each of the core metric families, the following fields are available:
- Added support for Metrics.conversions_absolute_change_point_estimate, Metrics.conversions_absolute_change_margin_of_error, and Metrics.conversions_absolute_change_p_value.
Targeting:
- Added CANNOT_EXCLUDE_ALL_TARGETS to CriterionErrorEnum. This error is returned when attempting to exclude all demographics targets, which is not allowed.
Videos:
- Publish ZEFR as a third party viewability integration partner.
- Added channel_id to the youtube_video field in the DataLink resource to expose the YouTube channel ID associated with the data link.
Forum discussion at X.
