Примечания к выпускам

Актуальный список текущих и планируемых устаревающих функций см. в разделе «Устаревшие функции» .

v24 основные и дополнительные версии

В версию 24 Google Ads API включены следующие новые функции, обновления и изменения, нарушающие обратную совместимость.

v24.2 (2026-06-24)

В версии Google Ads API v24.2 были добавлены следующие новые функции и обновления. Незначительные версии, такие как v24.2, не содержат критических изменений.

Функции и обновления	Тип	Описание
Реклама
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	Новое значение перечисления	Генерирует текстовую информацию с целевой страницы для отображения в панели взаимодействия для экземпляров DemandGenVideoResponsiveAd (которые по умолчанию включены начиная с этой версии API).
Ресурсы
AssetGroup.google_local_services_info	Новое поле	Добавлено для поддержки информации в объявлениях о местных услугах (идентификатор категории и выноски) в кампаниях Performance Max.
AssetGroupSignal.local_services_id	Новое поле	Добавлено для поддержки сигналов идентификатора сервиса Local Services Ads в кампаниях Performance Max.
AssetGroupSignal.vertical_ads_item_group_rule_list	Новое поле	Добавлена ​​поддержка правил группировки элементов вертикальных объявлений для выбора элементов из прикрепленных вертикальных фидов в кампаниях Performance Max. Эта функция доступна только для учетных записей, включенных в список разрешенных.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN	Новое значение перечисления / ошибка	Возвращается при попытке удалить все группы активов из кампании.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS	Новое значение перечисления / ошибка	Возвращается при попытке удалить все сигналы из группы активов.
Кампании
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled	Новые поля	Оказание поддержки в определении кампаний, обеспечивающих максимальную эффективность локальных сервисов.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	Новое поле	Включает Google Maps в список каналов, доступных для выбора в группах объявлений для генерации спроса.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	Новое значение перечисления / ошибка	Возвращается при попытке удалить все местоположения из кампании Performance Max для локальных служб.
SmartCampaignErrorEnum.CREATION_FAILED	Новое значение перечисления / ошибка	Ошибка возникает при попытке создания новых интеллектуальных кампаний.
Конверсии
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	Новые значения перечисления	Отображает конверсии, которые происходят, когда пользователь кликает на объявление о предоставлении местных услуг и звонит, пишет сообщение или бронирует услугу у рекламодателя.
Эксперименты
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	Новые значения перечисления	Добавлена ​​поддержка новых типов ExperimentType : COMPARE_CAMPAIGNS : Для экспериментов по комбинированию кампаний и пользовательских экспериментов Performance Max, которые сравнивают несколько кампаний одного или разных типов в одном эксперименте. PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION : Для экспериментов по оптимизации производительности при настройке текста и расширении конечного URL-адреса.
Общий
Asset.synthetic_content_info Ad.synthetic_content_info	Новые поля	Содержит подтверждения для синтетического/сгенерированного ИИ контента, разделенные на advertiser_input (заявления, предоставленные непосредственно рекламодателем) и system_input (подтверждения, автоматически обнаруженные или предоставленные системой). Эта функция была перенесена в версии 23 и 22. Чтобы помочь вам спланировать предстоящую работу по интеграции для версии 25, интерфейс для изменения полей подтверждения рекламодателя будет представлен заранее для версий 22 и выше. Интерфейс доступен в этих версиях, но поля synthetic_content_info.advertiser_attestation.status и synthetic_content_info.advertiser_attestation.source останутся неизменяемыми для этих версий. При попытке изменить значение любого из этих полей будет возвращена одна из следующих ошибок: «Поле, которое пытались изменить, неизменяемо» или «Поле не может быть установлено». Начиная с версии 25, эти поля станут полностью изменяемыми. Мы рекомендуем использовать интерфейс уже сейчас для создания и тестирования вашей внутренней логики, чтобы ваша система была готова к полноценной записи данных после запуска версии 25.
Многосторонняя авторизация	Новые функции	Бета-версия: Эта функция в настоящее время находится в стадии бета-тестирования и может быть изменена в будущих релизах. Добавлена ​​поддержка многосторонних проверок авторизации (MPA): Добавлен ресурс MultiPartyAuthReview и соответствующий MultiPartyAuthReviewService . Добавлено перечисление MultiPartyAuthReviewStatus для отслеживания статуса проверки. Добавлена CustomerUserAccess.pending_multi_party_auth_review для ссылки на ожидающую проверки. Добавлены MutateCustomerUserAccessResult.multi_party_auth_review и MutateCustomerUserAccessInvitationResult.multi_party_auth_review для возврата соответствующего имени ресурса для проверки. Добавлена MultiPartyAuthReviewError для обработки ошибок валидации. Эта функция была перенесена в версии 23.3 , 22.2 и 21.2 .
IncentiveService.FetchIncentive	Изменение поведения	В случае предоставления в запросе недействительного адреса электронной почты, метод теперь корректно возвращает стандартные предложения по поощрениям вместо того, чтобы выдавать ошибку AuthenticationError.INVALID_EMAIL_ADDRESS .
Планирование
GenerateCreatorInsightsRequest.search_topics	Новое поле	Добавлено в сервис ContentCreatorInsightsService.GenerateCreatorInsights . Эта опция ищет авторов, обсуждающих тему в стране, указанной в country_locations (поддерживает поиск только по одной стране).
CREATOR_TOPIC_INSIGHTS	Новое значение перечисления	Добавлено в InsightsKnowledgeGraphEntityCapabilities для обозначения сущностей, используемых для поиска авторов, обсуждающих определенную тему. Эти сущности следует использовать в поле search_topics . Получено с помощью AudienceInsightsService.ListAudienceInsightsAttributes .
KnowledgeGraphEntitySearchOptions	Новый тип / параметры	Содержит дополнительные параметры поиска по темам в ListAudienceInsightsAttributes , включая возможность получения всех тем, поддерживаемых в качестве атрибутов создателя, и фильтрацию по возможностям.
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data	Новые поля	Необязательные входные данные для методов ContentCreatorInsightsService . Указание этого поля позволяет добавить в ответ дополнительные данные о местоположении или атрибуты создателя контента.
local_creator_insights related_local_creators	Новые поля	Заполняется, если в поле supplemental_data содержится перечисление LOCAL_CREATOR_DATA . Отображает информацию о местных авторах, чьи профили просматриваются или которые находятся в выбранной стране и дали согласие на предоставление данных о местоположении.
GenerateTrendingInsightsRequest.sub_country_locations	Новое поле	Добавлена ​​функция ContentCreatorInsightsService.GenerateTrendingInsights , позволяющая осуществлять поиск трендовых данных по стране и регионам.
Отчеты
PerformanceMaxPlacementView	Расширение сегментов	Сегментация осуществляется с помощью ad_network_type .
Покупки
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	Новое поле	Если это так, исключения по брендам игнорируются для товарных объявлений. Поддерживается только для товарных кампаний.
Целенаправленное воздействие
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	Новое значение перечисления / ошибка	Возвращается при попытке указать язык, который не разрешен.
Видео
DataLink.youtube_link_metadata	Новое поле	Содержит параметр brand_channel_id , указывающий идентификатор связанного канала бренда на YouTube.

v24.1 (13.05.2026)

В версии Google Ads API v24.1 были добавлены следующие новые функции и обновления. Незначительные версии, такие как v24.1, не содержат критических изменений.

Функции и обновления	Тип	Описание
Реклама
DemandGenMultiAssetAdInfo.classic_display_images	Новое поле	Изображения, загруженные пользователем, отображаются без необходимости использования дополнительных адаптивных ресурсов.
Эксперименты
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	Новые значения перечисления	Добавлена ​​поддержка новых типов ExperimentType : ADOPT_AI_MAX : Для экспериментов, проверяющих, как AI Max может помочь вам привлечь больше клиентов с помощью Google AI и ключевых слов с широким соответствием. ADOPT_BROAD_MATCH_KEYWORDS : Для экспериментов, проверяющих, как ключевые слова с широким соответствием могут влиять на количество поисковых запросов, в которых отображаются ваши объявления. OPTIMIZE_ASSETS : Для проведения пользовательских экспериментов по оптимизации ресурсов. PMAX_REPLACEMENT_SHOPPING : Для экспериментов, проверяющих, как ваши торговые кампании работают по сравнению с Performance Max.
Experiment.video_experiment	Новое поле	Поддержка настройки существующих экспериментов YOUTUBE_CUSTOM , состоящих из видеокампаний.
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	Новые поля	Предоставляет доступ к полям для поддержки тестирования активов, групп активов и настроек максимальной производительности в экспериментальных группах: asset_testing_info : Подробная информация об активах, связанных с экспериментальными копиями рекламы. asset_groups : Список групп активов в экспериментальной группе для экспериментов по оптимизации активов. performance_max_experiment_arm_info : Настройки для кампаний Performance Max в экспериментах PMAX_REPLACEMENT_SHOPPING .
Общий
CustomerUserAccess.passkey_enabled	Новое поле	Поле только для чтения, указывающее, включен ли у пользователя пароль.
Отчеты
mobile_device_platform	Новый сегмент	Позволяет сегментировать отчеты по платформе устройства пользователя (например, iOS или Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	Новое значение перечисления / ошибка	Возвращается, если запрошенная дневная, почасовая или еженедельная детализация времени не поддерживается для диапазонов дат запроса (доступно только за последние 37 месяцев).
vertical_ads_listing_user_rating vertical_ads_listing_venue	Новые сегменты	Новые сегменты будут использоваться для вертикальной рекламы.
user_rating , venue , event_participant_display_name	Новые критерии фильтрации	Поддерживается фильтрация в VerticalAdsItemGroupRuleInfo для ресурса SharedCriterion .
Показатели контрольного/экспериментального эксперимента	Новые поля	Добавлены контрольные значения ( control_clicks и т. д.), значения обработки ( clicks и т. д.), точечные оценки ( clicks_point_estimate и т. д.), погрешности ( clicks_margin_of_error и т. д.) и p-значения ( clicks_p_value и т. д.) для семи основных групп метрик (Клики, Показы, Стоимость, Конверсии, Стоимость конверсии, Ценность конверсии, Ценность конверсии в расчете на стоимость).
Показатели абсолютного изменения конверсий	Новые поля	Поддержка оценки абсолютной разницы Conversions с использованием полей точечной оценки, погрешности и p-значения.
Целенаправленное воздействие
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS	Новое значение перечисления / ошибка	Результат возвращается при попытке исключить все целевые демографические группы.
Видео
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR	Новое значение перечисления	Компания ZEFR выступает в качестве стороннего партнера по интеграции функций повышения видимости контента.
DataLink.youtube_video.channel_id	Новое поле	Предоставляет доступ к идентификатору канала YouTube, связанному с каналом передачи данных.

v24 (2026-04-22)

В Google Ads API версии 24, являющейся крупным релизом, были добавлены следующие новые функции, обновления и изменения, нарушающие обратную совместимость.

См. раздел «Обновление до последней версии» для получения инструкций.

Изменения, нарушающие гармонию

Начальное состояние	Новый штат	Изменить тип	Руководство по внедрению
Реклама
Дополнительные videos и logo_images в DemandGenVideoResponsiveAdInfo	Обязательные поля	Изменение поведения	При создании или изменении адаптивных видеообъявлений для генерации спроса указывайте videos и logo_images .
Дополнительные параметры: videos , business_name и logo_images в VideoResponsiveAdInfo	Обязательные поля	Изменение поведения	При создании или изменении адаптивных видеообъявлений указывайте videos , business_name и logo_images . Обратите внимание, что VideoResponsiveAdInfo теперь можно изменять.
Кампании
Campaign.video_brand_safety_suitability	Никто	Удаление	Контроль соответствия на уровне кампании удален. Проверка соответствия на уровне клиента по-прежнему доступна для обеспечения безопасности бренда. Используйте вместо этого Customer.video_brand_safety_suitability .
Конверсии
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Никто	Удаление	Категория пользователей, регистрирующихся в программе лояльности, удалена. Удалите ссылки на неё из кода.
Планирование
InsightsAudienceAttributeGroup — тип для topic_audience_combinations	common. InsightsAudienceAttributeGroup тип	Изменение поведения / смена типа поведения	Интеграцию типизированных клиентских библиотек необходимо обновить, чтобы использовать новые пространства имен ресурсов.
Поле youtube_select_lineups в ReachPlanService.ListPlannableProducts	Никто	Удаление	Переключитесь на использование составов команд из youtube_select_lineup_targeting .
Поле is_brand_connect_creator в ContentCreatorInsightsService.GenerateCreatorInsights и GenerateTrendingInsights	Никто	Удаление	Вместо этого проверьте, есть ли у создателя доступ CREATOR_PARTNERSHIPS в partnership_opportunities .
geo_modifiers и biddable_keywords в KeywordPlanIdeaService.GenerateKeywordForecastMetrics	geo_target_constants и keywords	Переименовать / удалить	Заменено на CampaignToForecast.geo_target_constants[] и ForecastAdGroup.keywords[] .
Устаревшие поля планирования/прогнозирования ключевых слов в GenerateKeywordForecastMetrics	Никто	Удаление	Удалены следующие поля и типы плана/прогноза: CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords и ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate Обновите интеграции соответствующим образом.
Отчеты
сегмент ad_sub_network_type в campaign_budget	Никто	Удаление	Удалён сегмент ad_sub_network_type для ресурса campaign_budget .
Сегмент click_type в представлениях активов	Никто	Удаление	Удалён сегмент из представлений AdGroupAsset , CampaignAsset и CustomerAsset .
Видео
В ShareablePreviewService.GenerateShareablePreviews допускается частичная ошибка.	Частичный сбой отсутствует	Изменение поведения	Если какой-либо идентификатор в запросе не пройдет проверку, он завершится с ошибкой.
Устаревшие коды ShareablePreviewError : ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST	Переименование / изменение поведения	Коды ошибок, возвращаемые для групп ресурсов, изменяются в соответствии с ошибками в объявлениях групп. Обновите логику обработки ошибок проверки.

Новые функции и обновления (не нарушающие критическую совместимость)

Функции и обновления	Тип	Описание
Реклама
Изменяемость VideoResponsiveAdInfo	Изменение поведения	Теперь информационные объекты в адаптивных видеорекламах могут быть изменяемыми.
Ресурсы
travel_feed_data в AssetSet	Новое поле	Добавлена ​​возможность получения атрибутов ресурсов из ленты новостей о путешествиях ( hotel_center_account_id , merchant_center_id , partner_center_id , subset_id , travel_feed_vertical_type ).
Кампании
Campaign.view_through_conversion_optimization_enabled	Новое поле	Позволяет включить оптимизацию конверсии по показателю «Просмотр через» (VTC) (по умолчанию false ) в кампаниях по генерации спроса и кампаниях для приложений.
CampaignCriterion.gender	Новая функция	Включена возможность исключения по полу для кампаний Performance Max во всех версиях Google Ads API.
Конверсии
Типы конверсии для генерации лидов	Новые значения перечисления	В ConversionActionType добавлены новые перечисления типов действий преобразования GA4/Firebase: GOOGLE_ANALYTICS_4_GENERATE_LEAD GOOGLE_ANALYTICS_4_QUALIFY_LEAD GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD FIREBASE_ANDROID_GENERATE_LEAD FIREBASE_ANDROID_QUALIFY_LEAD FIREBASE_ANDROID_CLOSE_CONVERT_LEAD FIREBASE_IOS_GENERATE_LEAD FIREBASE_IOS_QUALIFY_LEAD FIREBASE_IOS_CLOSE_CONVERT_LEAD
Общий
UserListErrorEnum.DUPLICATE_LOOKALIKE	Новое значение перечисления / ошибка	Возвращается при попытке создать несколько идентичных списков похожих элементов.
Планирование
Поля ProductCoreAttributes в ListPlannableProductsResponse	Новые поля	В раздел ListPlannableProductsResponse добавлены планируемое описание продукта, маркетинговая цель, модель затрат и способ закупки в поле ProductCoreAttributes .
Отчеты
CartDataSalesView	Новый ресурс для составления отчетов	Предоставляет отчеты, сегментирующие показатели конверсии по конкретному продаваемому товару (бренду и т. д.), а также по товару, на который был совершен клик.
Показатели, не подлежащие торгам	Новые поля	Добавлены показатели, не зависящие от назначения ставок (показатели конверсий, которые не оптимизируются в рамках кампаний), ко всем соответствующим ресурсам: all_average_cart_size all_average_order_value_micros all_cost_of_goods_sold_micros all_cross_sell_cost_of_goods_sold_micros all_cross_sell_gross_profit_micros all_cross_sell_revenue_micros all_cross_sell_units_sold all_gross_profit_margin all_gross_profit_micros all_lead_cost_of_goods_sold_micros all_lead_gross_profit_micros all_lead_revenue_micros all_lead_units_sold all_orders all_revenue_micros all_units_sold
conversion_attribution_event_type	Новый сегмент	Добавлено в ShoppingPerformanceView .
Покупки
Рекламные кампании приложений в ShoppingProduct	Новая функция	Поддерживаются кампании приложений внутри ресурса ShoppingProduct . Обратите внимание, что статусы и проблемы не поддерживаются.
Фильтрация товаров по тегам	Новая функция	Введена функция фильтрации с использованием динамических выражений логических множеств: Добавлены типы критериев RETAIL_FILTER_BUNDLE и RETAIL_FILTER . Добавлен общий тип набора RETAIL_FILTER . В AdGroupCriterion добавлено поле retail_filter_bundle . В SharedCriterion добавлено поле retail_filter . Добавлено RETAIL в ListingGroupFilterListingSource . Добавлен параметр RetailFilter в AssetGroupListingGroupFilter . Добавлены новые ошибки проверки в разделах CriterionError и AssetGroupListingGroupFilterError . Эта функция доступна только для учетных записей, включенных в список разрешенных.

v23 основные и дополнительные версии

В версию 23 Google Ads API включены следующие новые функции, обновления и изменения, нарушающие обратную совместимость.

v23.3 (24.06.2026)

В версии Google Ads API v23.3 были добавлены следующие новые функции и обновления. Незначительные версии, такие как v23.3, не содержат критических изменений.

Функции и обновления	Тип	Описание
Общий
Asset.synthetic_content_info Ad.synthetic_content_info	Новые поля	Содержит подтверждения для синтетического/сгенерированного ИИ контента, разделенные на advertiser_attestation (заявления, предоставленные непосредственно рекламодателем) и system_attestation (подтверждения, автоматически обнаруженные или предоставленные системами Google). Чтобы помочь вам спланировать предстоящую работу по интеграции для версии 25, интерфейс для изменения полей подтверждения рекламодателя будет представлен заранее для версий 22 и выше. Интерфейс доступен в этих версиях, но поля synthetic_content_info.advertiser_attestation.status и synthetic_content_info.advertiser_attestation.source останутся неизменяемыми для этих версий. При попытке изменить значение любого из этих полей будет возвращена одна из следующих ошибок: «Поле, которое пытались изменить, неизменяемо» или «Поле не может быть установлено». Начиная с версии 25, эти поля станут полностью изменяемыми. Мы рекомендуем использовать интерфейс уже сейчас для создания и тестирования вашей внутренней логики, чтобы ваша система была готова к полноценной записи данных после запуска версии 25.
Согласования от нескольких сторон	Новые функции	Бета-версия: Эта функция в настоящее время находится в стадии бета-тестирования и может быть изменена в будущих релизах. Добавлена ​​поддержка многосторонних согласований (MPA): Добавлен ресурс MultiPartyAuthReview и соответствующий MultiPartyAuthReviewService . Добавлено перечисление MultiPartyAuthReviewStatus для отслеживания статуса проверки. Добавлена CustomerUserAccess.pending_multi_party_auth_review для ссылки на ожидающую проверки. Добавлены MutateCustomerUserAccessResult.multi_party_auth_review и MutateCustomerUserAccessInvitationResult.multi_party_auth_review для возврата соответствующего имени ресурса для проверки. Добавлена MultiPartyAuthReviewError для обработки ошибок валидации.

v23.2 (2026-03-25)

В версии Google Ads API v23.2 были добавлены следующие новые функции и обновления. Незначительные версии, такие как v23.2, не содержат критических изменений.

Функции и обновления	Тип	Описание
Ресурсы
VideoEnhancement	Новый ресурс	Содержит информацию о видеорекламе, специфичную для данной функции, например, сгенерирована ли она Google или предоставлена ​​рекламодателем. Подробнее см. в разделе «Об улучшениях видеорекламы» .
AppTopCombinationView	Новый ресурс	Ресурс только для чтения, предоставляющий информацию о наиболее эффективных сочетаниях рекламных материалов в кампаниях мобильных приложений.
CustomerAsset	Новая функция	Добавлена ​​поддержка получения данных CustomerAsset с field_type , установленным в значение BUSINESS_LOGO .
Кампании
AdGroupAd.start_date_time AdGroupAd.end_date_time	Новые поля	Предоставьте более детальные ограничения по расписанию на даты кампании. Эта функция поддерживается только для некоторых типов групп объявлений.
HotelSettingInfo.disable_hotel_setting	Новое поле	Позволяет отключить отображение информации об отелях в кампаниях по генерации спроса.
Общий
CustomerClientLinkError	Новые значения перечисления / ошибки	Добавлены два новых кода ошибок: MAX_CUSTOMER_LIMIT_REACHED и ACCOUNT_CREATION_POLICY_VIOLATION .
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Изменение поведения	Теперь при попытке использовать эту устаревшую категорию типа клиента из списка пользователей возникает ошибка.
Планирование
GenerateTrendingInsights GenerateCreatorInsights	Новые функции	Добавлена ​​поддержка пользовательских комбинаций И/ИЛИ для сущностей, тем и аудиторий.
ReachPlanService.GenerateReachForecast	Новые значения перечисления	Добавлены новые целевые возрастные диапазоны, такие как AGE_RANGE_21_44 или AGE_RANGE_21_49 .
youtube_select_lineup_targeting	Новое поле	Добавлено в ReachPlanService.ListPlannableProducts , которое заменит youtube_select_lineups . Оба поля в настоящее время заполнены.
ReachPlanSurface	Новое значение перечисления	Добавлен IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS в качестве опции для отображения потока.
Forecast	Новое поле	Добавлены clicks для функции Demand Gen Max Clicks (CPC) в ReachPlanService.GenerateReachForecast .
partnership_opportunities	Новое поле	Добавлено в ContentCreatorInsightsService.GenerateCreatorInsights и ContentCreatorInsightsService.GenerateTrendingInsights .
Отчеты
biddable_indirect_install_first_in_app_conversion_micros	Новое поле	Добавлено в ресурсы Campaign , Customer и AdGroup .
Видео
ShareablePreviewService	Новая функция	Расширена поддержка предварительного просмотра прямых трансляций YouTube путем установки preview_type в значение YOUTUBE_LIVE_PREVIEW . Добавлены UNSUPPORTED_AD_TYPE и TOO_MANY_RESOURCES_IN_REQUEST в ShareablePreviewError . Это поддерживается только для некоторых типов рекламы.

v23.1 (2026-02-25)

В версии Google Ads API v23.1 были добавлены следующие новые функции и обновления. Незначительные версии, такие как v23.1, не содержат критических изменений.

Функции и обновления	Тип	Описание
Управление учетными записями
advertising_partner_properties.allowed_domain	Новое поле	Добавлено в ресурсы ProductLinkInvitation и ProductLink . Рекламный партнер сможет размещать рекламу только на этом домене.
Customer.contains_eu_political_advertising	Новое поле	Получает информацию о статусе объявления на уровне учетной записи, указывающую, содержит ли она политическую рекламу, ориентированную на ЕС, и возвращает объект EuPoliticalAdvertisingStatus .
Кампании
Campaign.text_guidelines	Новое поле	Добавлена ​​поддержка текстовых рекомендаций, которые можно использовать с кампаниями Performance Max и Search для программного управления текстовыми материалами, генерируемыми ИИ. В параметре text_guidelines можно определить term_exclusions и messaging_restrictions .
CampaignPrimaryStatusReason	Новые значения перечисления	Добавлены CAMPAIGN_NOT_BOOKED , BOOKING_HOLD_EXPIRING , BOOKING_HOLD_EXPIRED и BOOKING_CANCELLED для указания основных причин статуса кампаний со стратегией назначения ставок FIXED_CPM .
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details	Новые поля	Добавлена ​​поддержка самораскрытия категории объявления о бронировании и отображения сведений о бронировании только для чтения.
Campaign.missing_eu_political_advertising_declaration	Новое поле	Поддерживает запросы и фильтрацию кампаний, в которых отсутствует информация о наличии политической рекламы, ориентированной на ЕС.
Конверсии
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS	Новое значение перечисления	Поддерживает отслеживание пользователей, которые смотрят рекламу, а затем просматривают видео с того же канала.
Общий
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED	Новое значение перечисления / ошибка	Результат возвращается при попытке выбрать только неопределенную категорию в демографических параметрах.
Стимулы
IncentiveErrorEnum	Новые значения перечисления / ошибки	Добавлены два новых кода ошибок: MAX_INCENTIVES_REDEEMED и ACCOUNT_TOO_OLD . Эти ошибки могут возникать при запросах, сделанных 11 марта 2026 года или позже.
Планирование
GenerateBenchmarksMetrics	Новая функция	Добавлена ​​поддержка разбивки по датам с использованием BreakdownDefinition .
ReachPlanService.GenerateReachForecast	Новое значение перечисления	Добавлена GOOGLE_DISPLAY_NETWORK в качестве целевой площадки для генерации спроса и повышения конверсии.
GenerateTrendingInsights	Новые поля	Добавлена ​​информация TrendInsights исторических линиях тренда в TrendInsightDataPoint при поиске по теме.
Отчеты
Уникальные показатели частоты использования пользователей	Новые поля	Добавлены новые метрики, показывающие, сколько пользователей видели вашу рекламу хотя бы два, три, четыре, пять или десять раз: unique_users_two_plus , unique_users_three_plus , unique_users_four_plus , unique_users_five_plus и unique_users_ten_plus .
SearchTermMatchSource	Новое значение перечисления	Добавлена VERTICAL_ADS_DATA_FEED для поддержки потоков данных по вертикальным рекламным кампаниям, например, для таргетинга по категориям туристической рекламы.
YouTubeVideoUpload
YouTubeVideoUpload	Новая услуга / ресурс	Добавлен сервис YouTubeVideoUpload для поддержки загрузки и управления видео на YouTube, а также ресурс YouTubeVideoUpload для поддержки получения статуса загрузки и метаданных. Эта функция поддерживается только для REST и клиентской библиотеки Python.

v23 (2026-01-28)

В Google Ads API версии 23, являющейся крупным релизом, были добавлены следующие новые функции, обновления и изменения, нарушающие обратную совместимость.

См. раздел «Обновление до последней версии» для получения инструкций.

Изменения, нарушающие гармонию

Начальное состояние	Новый штат	Изменить тип	Руководство по внедрению
Реклама
Разрешено размещение рекламы.	AdGroupAdError.AD_SHARING_NOT_ALLOWED	Изменение поведения	Совместное использование рекламы несколькими группами объявлений больше не разрешено. Запросы на совместное использование рекламы будут возвращать ошибку AD_SHARING_NOT_ALLOWED .
Поддержка CallAd и CallAdInfo	Никто	Удаление	Поддержка рекламных звонков прекращена. См. статью в справочном центре «О рекламных звонках» .
Кампании
Campaign.start_date Campaign.end_date	Campaign.start_date_time Campaign.end_date_time	Переименовать / заменить	Используйте новые поля даты и времени для указания временных компонентов в кампаниях. Исходные поля только для даты удалены.
Генерация спроса
DemandGenMultiAssetAdInfo.lead_form_only	Никто	Удаление	Поле lead_form_only удалено. Обновите ссылки в вашем коде.
Отчеты
Совокупные показатели эффективности активов, метрики и перечисления.	Никто	Удаление	Удалены агрегированные метрики производительности активов. Перечисление меток производительности больше не возвращается для поиска и отображения.

Новые функции и обновления (не нарушающие критическую совместимость)

Функции и обновления	Тип	Описание
Реклама
AdFormatType	Новые значения перечисления	Добавлены новые типы форматирования: TEXT , VERTICAL_ADS_BOOKING_LINK и VERTICAL_ADS_PROMOTION .
Ресурсы
представление asset_group	Новые поля	Добавлены следующие метрики: metrics.engagements , metrics.engagement_rate и metrics.average_cpe .
представление asset_group_asset	Новые поля	Добавлены следующие метрики: metrics.average_cpe , metrics.average_cpm , metrics.trueview_average_cpv , metrics.video_trueview_view_rate , metrics.video_trueview_views и metrics.interaction_event_types .
Asset.orientation	Новое поле	К изображениям и видеофайлам добавлено поле ориентации только для чтения.
CampaignAsset	Новая функция	Добавлена ​​поддержка получения ресурсов кампании с field_type , установленным в значения HEADLINE и DESCRIPTION .
ServedAssetFieldType	Новые значения перечисления	Добавлены HEADLINE_AS_SITELINK_POSITION_ONE , HEADLINE_AS_SITELINK_POSITION_TWO , DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE и DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO для ресурсов, используемых в качестве ссылок на сайт.
BusinessMessageAsset	Новые функции / поддержка	Обновлены материалы для деловых сообщений: Добавлена ​​поддержка Facebook Messenger и Zalo в качестве провайдеров. Добавлены FACEBOOK_MESSENGER и ZALO в BusinessMessageProvider . Добавлены поля facebook_messenger_info и zalo_info . Добавлено CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS в AssetError .
Выставление счетов
InvoiceService.ListInvoices	Новые возможности	Теперь можно получать более подробную информацию в Invoice , включая разбивку затрат на уровне кампании, детализированные нормативные расходы и информацию о корректировках, установив параметр include_granular_level_invoice_details в ListInvoicesRequest .
RegulatoryFeeType UnitOfMeasure	Новые перечисления	Добавлены вспомогательные перечисления для обозначения регулирующих сборов и единиц измерения.
Кампании
CampaignError	Новые значения перечисления / ошибки	Добавлены коды ошибок DURATION_TOO_LONG_FOR_TOTAL_BUDGET и END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET .
Конверсии
Категория конверсииДействия	Новое значение перечисления	Добавлена ​​опция YOUTUBE_FOLLOW_ON_VIEWS для отслеживания пользователей, которые сначала смотрят рекламу, а затем видео с того же канала.
Генерация спроса
DemandGenVideoResponsiveAdInfo.companion_banner	Новое поле	Добавлена ​​поддержка сопутствующих баннеров в адаптивных видеообъявлениях для генерации спроса.
Стимулы
Добавлена ​​поддержка системы поощрений «Выбери сам» (CYO): Добавлен метод FetchIncentive для получения доступных персонализированных поощрений для пользователя. Добавлен метод ApplyIncentive для применения выбранного бонуса к учетной записи клиента. Добавлен ресурс AppliedIncentive (доступный для запросов с помощью Search и SearchStream ) для предоставления подробной информации о погашении бонусов. Добавлены новые коды ошибок в разделах IncentiveError и AuthenticationError.INVALID_EMAIL_ADDRESS . Для более детальной программной обработки сбоев в будущих релизах мы добавим дополнительные коды ошибок в IncentivesService . Рекомендуем следить за предстоящими объявлениями и примечаниями к релизам, чтобы узнать о новых кодах ошибок и убедиться, что ваши приложения могут обрабатывать эти новые режимы сбоев.
Планирование
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	Новое значение перечисления	Позволяет создавать аудитории, используя события жизненного цикла в функциях GenerateAudienceCompositionInsights , GenerateSuggestedTargetingInsights , GenerateInsightsFinderReport и GenerateCreatorInsights . События жизненного цикла не поддерживаются для других методов AudienceInsightsService , таких как AudienceInsightsService.GenerateAudienceOverlap и AudienceInsightsService.GenerateTargetingSuggestionMetrics .
ReachPlanService.GenerateConversionRates	Новые поля / параметры	Теперь в ответ включены элементы управления, поддерживающие предложения по коэффициенту конверсии на основе настроек этих элементов (например, Gmail, Shorts). Поддерживается только для кампаний по генерации спроса.
LanguageDistribution	Новое поле / тип	Добавлена ​​функция в YouTubeChannelInsights , предоставляющая подробную информацию о распространении контента на YouTube-каналах на разных языках.
BenchmarksService	Новая услуга	Сравнивает данные о рекламе на YouTube с отраслевыми показателями.
AudienceInsightsService.GenerateAudienceDefinition	Новый метод	Преобразует текстовое описание целевой аудитории в соответствующие атрибуты аудитории с помощью генеративного искусственного интеллекта.
YouTubeChannelInsights.relevance_score	Новое поле	Оценивает релевантность автора теме с учетом количества просмотров.
TrendInsightMetrics.trend_change_percent	Новое поле	Представляет собой процентное изменение значения тренда за сравниваемый период.
Рекомендации
GenerateRecommendationsRequest	Новое поле	Добавлен is_new_customer . Если для рекомендаций CAMPAIGN_BUDGET установлено значение true , используется модель, оптимизированная для новых клиентов (рекомендуется только для клиентов без кампаний).
Отчеты
AdGroupAdAssetView	Поддержка новых функций/метрик	Теперь поддерживаются метрики показов, эффективности и конверсии для RESPONSIVE_DISPLAY_AD .
сегмент ad_sub_network_type	Новый сегмент	Предоставляет подробную разбивку эффективности в рамках рекламной сети. Первоначально доступно для кампаний по генерации спроса на YouTube (в потоке, в ленте, короткие ролики). Необходимо выбрать вместе с ad_network_type .
Отчетность Performance Max	Новая функция	Включена детализация по типам рекламных сетей для кампаний Performance Max.
UserLocationView GeographicView	Поддержка новых сегментов	Поддерживаются метрики, сегментированные по дате конверсии: conversions_by_conversion_date , all_conversions_by_conversion_date , conversions_value_by_conversion_date , all_conversions_value_by_conversion_date , value_per_conversions_by_conversion_date , value_per_all_conversions_by_conversion_date , cross_device_conversions_by_conversion_date и cross_device_conversions_value_by_conversion_date .
Вертикальные сегменты рекламы	Новые сегменты	Добавлены следующие сегменты: vertical_ads_event_participant_display_names , vertical_ads_hotel_class , vertical_ads_listing , vertical_ads_listing_brand , vertical_ads_listing_city , vertical_ads_listing_country , vertical_ads_listing_region , vertical_ads_partner_account и vertical_ads_vertical .
PerStoreView MatchedLocationInterestView	Новые ресурсы для составления отчетов	Добавлена PerStoreView для запроса информации о местоположении магазинов, а также MatchedLocationInterestView (для кампаний AI Max) для предоставления показателей эффективности по интересующим географическим местоположениям.
Покупки
ShoppingPerformanceView	Поддержка новых метрик	Теперь поддерживаются следующие метрики, сегментированные по дате конверсии: conversions_by_conversion_date , all_conversions_by_conversion_date , conversions_value_by_conversion_date , value_per_conversions_by_conversion_date и value_per_all_conversions_by_conversion_date .
ShoppingPerformanceView	Поддержка новых метрик	Добавлена ​​поддержка следующих параметров: search_budget_lost_impression_share , search_rank_lost_impression_share , search_budget_lost_absolute_top_impression_share и search_rank_lost_absolute_top_impression_share .
ShoppingProduct.product_image_uri	Новое поле	Добавлено в раздел ShoppingProduct .
Вертикальная реклама
AdGroup.vertical_ads_format_setting	Новое поле	Позволяет контролировать, какие форматы рекламы могут отображаться в поисковых кампаниях с использованием туристических фидов.
AdGroupCriterion SharedCriterion	Новые поля / критерии	Добавлен тип критерия vertical_ads_item_group_rule_list в AdGroupCriterion и vertical_ads_item_group_rule в SharedCriterion , что позволяет таргетировать группы товаров в поисковых кампаниях с туристическими фидами.
Интеграция потока данных вертикальной рекламы	Новая функция	Теперь можно подключить фид данных вертикальной рекламы к поисковой кампании, работающей под управлением AI Max, чтобы показывать рекламные объявления о недвижимости и ссылки на бронирование туристических услуг наряду с текстовыми объявлениями. Форматы можно контролировать с помощью параметра vertical_ads_format_setting , а правила — с помощью vertical_ads_item_group_rule . Доступна сегментация отчетов по AdFormatType и параметрам фида данных вертикальной рекламы.
Видео
AdVideoAssetInfo.ad_video_asset_feature_control	Новое поле	Добавлены параметры управления функциями для видеорекламы.
CampaignCriterionError	Новое значение перечисления / ошибка	Добавлен код ошибки INVALID_VIDEO_LINEUP_ID .
Показатели слышимости на YouTube	Новые показатели	Добавлены метрики слышимости для аудиорекламы на YouTube, позволяющие определить, была ли реклама слышимой и на каком количестве показов можно измерить слышимость.

v22 основные и дополнительные версии

В версию 22 API Google Ads включены следующие новые функции, обновления и изменения, нарушающие обратную совместимость.

v22.2 (24.06.2026)

В версии Google Ads API v22.2 были добавлены следующие новые функции и обновления. Незначительные версии, такие как v22.2, не содержат критических изменений.

Функции и обновления	Тип	Описание
Общий
Asset.synthetic_content_info Ad.synthetic_content_info	Новые поля	Содержит подтверждения для синтетического/сгенерированного ИИ контента, разделенные на advertiser_attestation (заявления, предоставленные непосредственно рекламодателем) и system_attestation (подтверждения, автоматически обнаруженные или предоставленные системами Google). Чтобы помочь вам спланировать предстоящую работу по интеграции для версии 25, интерфейс для изменения полей подтверждения рекламодателя будет представлен заранее для версий 22 и выше. Интерфейс доступен в этих версиях, но поля synthetic_content_info.advertiser_attestation.status и synthetic_content_info.advertiser_attestation.source останутся неизменяемыми для этих версий. При попытке изменить значение любого из этих полей будет возвращена одна из следующих ошибок: «Поле, которое пытались изменить, неизменяемо» или «Поле не может быть установлено». Начиная с версии 25, эти поля станут полностью изменяемыми. Мы рекомендуем использовать интерфейс уже сейчас для создания и тестирования вашей внутренней логики, чтобы ваша система была готова к полноценной записи данных после запуска версии 25.
Согласования от нескольких сторон	Новые функции	Бета-версия: Эта функция в настоящее время находится в стадии бета-тестирования и может быть изменена в будущих релизах. Добавлена ​​поддержка многосторонних согласований (MPA): Добавлен ресурс MultiPartyAuthReview и соответствующий MultiPartyAuthReviewService . Добавлено перечисление MultiPartyAuthReviewStatus для отслеживания статуса проверки. Добавлена CustomerUserAccess.pending_multi_party_auth_review для ссылки на ожидающую проверки. Добавлены MutateCustomerUserAccessResult.multi_party_auth_review и MutateCustomerUserAccessInvitationResult.multi_party_auth_review для возврата соответствующего имени ресурса для проверки. Добавлена MultiPartyAuthReviewError для обработки ошибок валидации.

v22.1 (2026-02-25)

В версии Google Ads API v22.1 добавлена ​​следующая новая функция. Незначительные версии, такие как v22.1, не содержат критических изменений.

Функции и обновления	Тип	Описание
Управление учетными записями
Customer.contains_eu_political_advertising	Новое поле	Получает информацию о статусе объявления на уровне учетной записи, указывающую, содержит ли она политическую рекламу, ориентированную на ЕС, и возвращает объект EuPoliticalAdvertisingStatus .
Кампании
Campaign.missing_eu_political_advertising_declaration	Новое поле	Поддерживает запросы и фильтрацию кампаний, в которых отсутствует информация о наличии политической рекламы, ориентированной на ЕС.

v22 (15.10.2025)

В Google Ads API версии 22, являющейся крупным релизом, были добавлены следующие новые функции, обновления и изменения, нарушающие обратную совместимость.

См. раздел «Обновление до последней версии» для получения инструкций.

Изменения, нарушающие гармонию

Начальное состояние	Новый штат	Изменить тип	Руководство по внедрению
Генерация спроса
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros	minimum_budget_amount_micros	Переименование / исправление орфографических ошибок	Переименуйте ссылки, используя исправленное имя поля.
Общий
В AddBatchJobOperations нет ограничений на количество операций.	Ограничение на 10 000 операций на один запрос.	Изменение поведения	Убедитесь, что ни один запрос AddBatchJobOperations не содержит более 10 000 операций.
В запросе ListBatchJobResultsRequest размер страницы ограничен 1000 строками (без уведомления).	Возвращает ошибку INVALID_PAGE_SIZE	Изменение поведения	Убедитесь, что для ListBatchJobResultsRequest.page_size установлено значение 1000 или меньше, поскольку запрос страницы большего размера теперь приведет к ошибке.
Максимальная производительность
Метки показателей эффективности активов	Никто	Удаление	Поддержка меток эффективности активов и связанное с ними перечисление меток эффективности были удалены для кампаний Performance Max. Обновите интеграции соответствующим образом.
Campaign.url_expansion_opt_out	Флаг FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION в AssetAutomationSetting	Демонтаж / замена	Используйте окончательную настройку автоматизации текстовых ресурсов для расширения URL-адресов. Поле отказа от расширения URL-адресов на уровне кампании удалено.
Планирование
views	trueview_views	Демонтаж / замена	Замените ссылки на views новым полем trueview_views в ReachPlanService .
Видео
average_cpv video_view_rate video_views video_view_rate_in_feed video_view_rate_in_stream video_view_rate_shorts	trueview_average_cpv video_trueview_view_rate video_trueview_views video_trueview_view_rate_in_feed video_trueview_view_rate_in_stream video_trueview_view_rate_shorts	Переименования	Обновите строки запросов и интеграции, чтобы использовать новые названия метрик, представляющие просмотры видео в TrueView.

Новые функции и обновления (не нарушающие критическую совместимость)

Функции и обновления	Тип	Описание
Ресурсы
AssetFieldType.LANDING_PAGE_PREVIEW	Новое значение перечисления	Добавлено в качестве нового типа поля для графических ресурсов.
AssetGenerationService	Новый сервис (бета-версия)	Позволяет создавать текстовые и графические ресурсы с использованием генеративного искусственного интеллекта: GenerateText : Генерирует текст на основе конечного URL-адреса, подсказок, ключевых слов и т. д. GenerateImages : Генерирует изображения на основе конечного URL-адреса, подсказок или путем реконтекстуализации изображений товаров. В результате выполнения операции возвращаются коды ошибок из AssetGenerationError . Изначально эта функция была доступна только ограниченному числу участников закрытого бета-тестирования.
Кампании
AppCampaignBiddingStrategyGoalType	Новые значения перечисления	Добавлены новые цели для кампаний приложений по установке (ACi) для оптимизации без указания целевого показателя: OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA : Use with standard Maximize Conversions. OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS : Use with standard Maximize Conversion Value.
BiddingStrategyType	Новая функция	Added support for the fixed share of voice bidding strategy type.
Campaign.feed_types	New field	Shows the types of feeds attached to a campaign. For Performance Max campaigns, this can indicate the business vertical, such as MERCHANT_CENTER_FEED for retail.
Shared set targeting	Новая функция	Allowed attaching negative keywords shared sets to multi-channel (for App campaigns) and local campaigns.
Генерация спроса
TargetCPC bidding	Новая функция	Added bidding strategy to maximize clicks at target CPC: set campaign-level target CPC using Campaign.target_cpc and override at ad group level using AdGroup.target_cpc_micros .
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES	New enum value	If enabled for DemandGenMultiAssetAdInfo , this adds design elements and embeds text assets into image assets to create new image assets with different aspect ratios (enabled by default).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS	New enum value	If enabled for DemandGenMultiAssetAdInfo , it generates videos using other assets like images and text, which can then be used to create new DemandGenVideoResponsiveAdInfo instances (enabled by default).
Общий
ListBatchJobResultsRequest page size fallback	Behavioral change	If page_size is not set or is 0, it now defaults to the maximum of 1,000 (previously returned INVALID_PAGE_SIZE ).
QuotaError	New enum value / error	Added PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED to indicate when payment profile activation rate limit is exceeded.
Максимальная производительность
Asset automation settings	New enum values	Added new PMax asset automation options: GENERATE_IMAGE_ENHANCEMENT : Enables automatic creation of enhanced images (auto-cropping). Enabled by default. GENERATE_IMAGE_EXTRACTION : Sourced images from final URLs. Defaults to account Dynamic Image Extension setting.
PMax reporting segments	New segments	Added new segments unique to Performance Max campaigns: ad_using_product_data : Indicates if an ad uses Google Merchant Center product data. ad_using_video : Indicates if an ad uses a video asset.
Планирование
CRM partner data lists	New feature / enum value	Added THIRD_PARTY_PARTNER_DATA to CRM data sources, along with partner audience validation error codes (such as tos acceptance, Link missing, etc.).
Livestream creator metrics	New field	Added YouTubeMetrics.is_active_live_stream_creator , returned by creator insights to indicate if a creator published a livestream in the past 90 days.
Plannable CRM source metadata	Новое сообщение	Added PlannableUserListMetadata inside PlannableUserList , returned by ReachPlanService.ListPlannableUserLists , to show CRM data source types.
Support for related videos and creators in TrendInsight	New fields	Added support for related_videos and related_creators on TrendInsight , and watch properties in video_properties and publish_date .
InsightsFinder improvements	Новая функция	GenerateInsightsFinderReport now supports parental_status , income_ranges , and more complex AND/OR targeting combinations.
Отчеты
New click types	New enum values	Added CLICK_TO_MESSAGE_THIRD_PARTY_CLICK and CLICK_TO_MESSAGE_LANDING_PAGE_CLICK .
AssetGroupAsset segmentation	New segments support	AssetGroupAsset is now segmentable by device , conversion_action , conversion_action_name , and conversion_action_category .
RSAs in AdGroupAdAssetView	New feature / metrics support	AdGroupAdAssetView now fully supports performance and conversion metrics for RESPONSIVE_SEARCH_AD (previously only impressions were returned).
Exploration query cluster metric segmentations	New segments support	Metrics clicks_unique_query_clusters , conversions_unique_query_clusters , and impressions_unique_query_clusters are now segmentable by date fields.
TargetingExpansionView	New reporting resource	Added TargetingExpansionView to report metrics for expansions over manual targeting, such as keywordless expansion for AI Max for Search Campaigns.
Покупки
Shopping scope fix	Исправлена ​​ошибка	Fixed the campaign and ad group scoping of metrics in the ShoppingProduct resource.
Unified goals
Retention goals	Новая функция	Added support for customer retention goals to optimize for re-engaging existing customers (eg, using target_option with TARGET_SPECIFIC or TARGET_ALL ).
Видео
Video watch time metrics	New fields	Added watch time duration metrics: video_watch_time_duration_millis (total duration) and average_video_watch_time_duration_millis (average duration per impression).

v21 major and minor versions

Google Ads API v21 includes the following new features, updates, and breaking changes.

v21.2 (2026-06-24)

The following new features and updates were added in Google Ads API v21.2. Minor versions like v21.2 don't contain breaking changes.

Features and updates	Тип	Описание
Общий
Multi-party approvals	Новые функции	Beta: This feature is currently in beta and is subject to change in future releases. Added support for multi-party approvals (MPA) reviews: Added the MultiPartyAuthReview resource and corresponding MultiPartyAuthReviewService . Added the MultiPartyAuthReviewStatus enum to track the review status. Added CustomerUserAccess.pending_multi_party_auth_review to link to a pending review. Added MutateCustomerUserAccessResult.multi_party_auth_review and MutateCustomerUserAccessInvitationResult.multi_party_auth_review to return the associated review resource name. Added MultiPartyAuthReviewError for validation errors.

v21.1 (2026-02-25)

The following new features and updates were added in Google Ads API v21.1. Minor versions like v21.1 don't contain breaking changes.

Features and updates	Тип	Описание
Управление учетными записями
Customer.contains_eu_political_advertising	New field	Retrieves the account-level declaration status of whether it contains political advertising targeted towards the EU, and returns an EuPoliticalAdvertisingStatusEnum .
Кампании
Campaign.missing_eu_political_advertising_declaration	New field	Supports querying and filtering campaigns that are missing declarations about whether they contain political advertising targeted towards the EU.

v21 (2025-08-06)

The following new features, updates, and breaking changes were added in Google Ads API v21, which is a major release.

See Upgrade to the latest version for guidance.

Изменения, нарушающие гармонию

Начальное состояние	New state	Изменить тип	Implementation guidance
Кампании
Returns CriterionError.INVALID_LISTING_GROUP_HIERARCHY	Returns CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION	Error code change	For requests with a partial failure enabled, handle the new error code instead of the original hierarchy error code.
Конверсии
Access to debug_enabled mode in ConversionUploadService	Никто	Удаление	The debug_enabled field is removed. Update code referencing it to not set or query this parameter.
EU political advertising changes
Optional campaign self-declarations for EU political advertising	Required contains_eu_political_advertising field for new campaigns	Validation rule / behavioral shift	API calls to create new campaigns will fail with a FieldError.REQUIRED error if this field is not set. Starting September 22, 2025, campaigns declared as CONTAINS_EU_POLITICAL_ADVERTISING will no longer serve in the EU.
Modifiable criteria without self-declaration	Fails updates with CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION	Validation rule / behavioral shift	Set the self-declaration status before attempting to create or update campaign- or ad group-level proximity, location, or location group targeting criteria for existing campaigns.
Experiments without self-declaration requirements	Fails updates with ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION	Validation rule / behavioral shift	Ensure that the self-declarations have been completed on the experiment's campaigns.
Максимальная производительность
brand_guidelines_enabled defaults to false	Defaults to true	Behavioral shift	For new Performance Max campaigns, brand guidelines are enabled by default. Explicitly set the field to false if they should be disabled.
Планирование
Original input argument type for AudienceInsightsService.GenerateTargetingSuggestionMetrics	Input of type InsightsAudience	Type change	Update implementations to pass the new input type which supports an AND-of-ORs combination of user interests, permitting potential reach metrics for custom audience definitions.

Features and updates (non-breaking)

Features and updates	Тип	Описание
AI Max для поисковых кампаний
ai_max_setting.enable_ai_max in Campaign	New field	Enables AI Max to expand search term matching (respecting previous text asset automation and brand lists until toggled off). The field Campaign.ai_max_setting.bundling_required indicates if AI Max must be enabled to respect/modify those settings, and AdGroup.ai_max_ad_group_setting.disable_search_term_matching can disable matching at the ad group level. See Unlock next-level performance with AI Max for Search campaigns .
CampaignError.AI_MAX_MUST_BE_ENABLED	New enum value / error	Thrown when opting in to URL expansion text asset automation in Search campaigns without enabling AI Max.
Ad group level targeting	Новая функция	Support added in AI Max for Search campaigns for brand lists, locations, and webpages (URL rules) at the ad group level.
ai_max_search_term_ad_combination_view	New reporting resource	Reports performance on combinations of search terms, headlines, and landing pages.
search_term_match_type segment	New enum value	Added AI_MAX as a search term match type option.
Ресурсы
PromotionAsset	New fields	Added terms_and_conditions_text , terms_and_conditions_uri , and oneof promotion_trigger options ( promotion_barcode_info , promotion_qr_code_info ). See About promotion assets .
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION	New enum value	Added to AssetAutomationType to control automated text and landing page generation from final URLs in Search campaigns.
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset	New service / method	Allows removing automatically created final URL expansion assets from campaigns.
ServedAssetFieldType.DESCRIPTION_PREFIX	New enum value	Added to correct a reporting issue where the type was returned as UNKNOWN in ad_group_ad_asset_combination_view .
Кампании
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING	New enum value	Returned when location-restricted campaigns lack location targeting (which now throws LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN if targeted outside the allowed area).
Third-party app analytics integration	New fields	Added support for VideoCustomer.third_party_integration_partners and Campaign.third_party_integration_partners . See Track app conversions with third-party app analytics .
Campaign.advertising_partner_ids	New field support	The field can now be set for existing campaigns (remains immutable after being set).
Manager-level negative placements	Новая функция	Allows exclusions of placement lists across individual advertiser accounts using CustomerNegativeCriterion .
Tolerance configurations in target ROAS strategies	New fields	Added support for TargetRoas.target_roas_tolerance_percent_millis (for Search campaign portfolio strategies) in MaximizeConversionValue and TargetRoas .
LocationInterestView	New reporting resource	Summarizes performance of ad group location interest criteria.
Конверсии
conversion_attribution_event_type segment	New enum value	Added ENGAGED_VIEW to conversion attribution type options.
Генерация спроса
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM	New enum value / error	Added in preparation for enforcing minimum daily budgets for Demand Gen campaigns. Details are exposed using budgetDailyMinimumErrorDetails .
Максимальная производительность
campaign_search_term_view	New reporting resource	Aggregates search terms metrics at the campaign level, enabling search term analysis and reporting for Performance Max.
Планирование
ReachPlanService.ListPlannableUserInterests	New method	Allows discovering plannable affinities and in-market interests for generateReachForecast .
AdditionalApplicationInfo	New field	Added as an optional input in ReachPlanService.ListPlannableUserLists .
AudienceInsights attributes listing	Новая функция	AudienceInsightsService.ListAudienceInsightsAttributes now fetches available 1P user lists.
AudienceCompositionInsights targeting CRM lists	Новая функция	AudienceInsightsService.GenerateAudienceCompositionInsights now returns user list index details for AudienceInsightsDimension dimensions: AGE_RANGE , GENDER , AFFINITY_USER_INTEREST , and IN_MARKET_USER_INTEREST .
TrendInsightMetrics audience share	New field	Represents the share of an audience for a trend.
KnowledgeGraphAttributeMetadata categories	New fields	Filters Knowledge Graph attributes by matching categories.
Отчеты
Asset views metrics	New features / metrics	Added multiple new metrics to AssetGroupAsset , ChannelAggregateAssetView , and CampaignAggregateAssetView . PMax campaigns also now report true values for impressions .
Selector extensions	Новая функция	Made AssetSet and CampaignAssetSet queryable together inside ChangeStatus .
search_term_targeting_status	Новый сегмент	Selectable segment in the campaign search term view.
final_url_expansion_asset_view	New reporting resource	Reports final URL expansion asset performance details.
AssetGroup value adjustments	New fields	Added support for value_adjustment and all_value_adjustment metrics in the AssetGroup report.
landing_page_source	Новый сегмент	Provides a landing page source segment in landing_page_view .
search_term_match_source	Новый сегмент	Selectable segment in the search term and campaign search term views.
match_type	Новый сегмент	Selectable segment key in the keyword view.
Unique query intent clusters reporting	New fields	Added clicks_unique_query_clusters , conversions_unique_query_clusters , and impressions_unique_query_clusters to report unique query intent clusters.
ClickType.VEHICLE_ASSETS	New enum value	Track and report clicks related specifically to vehicle ad formats in the click_view report.
Smart Bidding Exploration
tolerance configurations in Search strategies	New fields / settings	Allows enabling Smart Bidding Exploration on Search campaigns by setting target_roas_tolerance_percent_millis between 10,000 (10%) and 30,000 (30%) inclusive (Maximize Conversions requires target_roas setting). See our blog post on Smart Bidding Exploration and help center article .
diversity reporting compatibility	Новая функция	Aggregated diversity reporting is now supported for the following metrics for unique query intent clusters. A time segmented view is available in the Google Ads UI: clicks_unique_query_clusters conversions_unique_query_clusters impressions_unique_query_clusters
Видео
YouTubeVideoListAsset	New resource / field	Allows establishing links between campaigns and video list assets using Asset.youtube_video_list_asset . See Use related videos .
Insights metadata extensions	New fields	Added new metadata to YouTubeChannelInsights and YouTubeVideoAttributeMetadata .
Interactive click types	New enum values	Added click types: VIDEO_RELATED_VIDEOS_CLICK , VIDEO_CHANNEL_CLICK , and PRODUCT_ASSETS .
VideoAdInventoryControl.allow_non_skippable_in_stream	New field	Lets Video Responsive ads serve as non-skippable in-stream ads for campaigns mixing skip and non-skip formats.
Video sequencing settings	New fields	Added read-only sequencing configurations: Campaign.VideoCampaignSettings.video_ad_sequence and VideoAdSequenceStepSetting . See About video ad sequencing .
Video lineup targeting	New criterion type / field	Added VIDEO_LINEUP criterion type and corresponding field in CampaignCriterion and AdGroupCriterion . This feature is only available to accounts on the allowlist.
Content suitability placements views	New reporting resources	Added a Content Suitability report for both detail ( detail_content_suitability_placement_view ) and group ( group_content_suitability_placement_view ) levels. See About the 'Content suitability' report .

Archived release notes

See Sunsetted versions for archived release notes.