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

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

основная версия v25

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

v25 (2026-07-22)

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

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

Изменения, нарушающие покой

Начальное состояние Новый штат Изменить тип Руководство по внедрению
Кампании
Автономные поля additional_value и additional_high_lifetime_value в CustomerLifecycleOptimizationValueSettings Часть объектов value_adjustment и high_lifetime_value_adjustment соответственно, наряду с новыми полями value_multiplier и high_lifetime_value_multiplier Структурные изменения Обновите ссылки на эти поля, так как теперь они являются частью объектов типа oneof.
Устаревшие ресурсы CustomerLifecycleGoal и CampaignLifecycleGoal , соответствующие им сервисы CustomerLifecycleGoalService и CampaignLifecycleGoalService , а также устаревшие настройки/перечисления ( CustomerAcquisitionGoalSettings , CustomerAcquisitionOptimizationModeEnum , LifecycleGoalValueSettings ). Никто Удаление Используйте обновленную схему единых целей:
Общий
Вложенные поля перечисления в сообщениях запроса и ответа службы стимулирования:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
 Автономные поля перечисления: Переименовать / удалить Вместо устаревших полей type используйте новые автономные поля перечисления.
В ApplyIncentiveRequest необязательными являются поля selected_incentive_id и customer_id Обязательные поля Изменение поведения При вызове функции ApplyIncentive обязательно укажите оба поля.
Поле адреса электронной почты потребителя ContactDetails.email в ресурсе LocalServicesLead Никто Удаление Удалите ссылки на это поле, поскольку оно больше не поддерживается.
Необязательное поле allowed_domain в AdvertisingPartnerLinkInvitationProperties Обязательное поле при вызове функции CreateProductLinkInvitation для рекламного партнера. Изменение поведения При создании приглашения по ссылке на продукт для рекламного партнера обязательно укажите allowed_domain .
Планирование
Поле search_brand в GenerateCreatorInsightsRequest Никто Удаление Вместо этого используйте search_topics .
Поле plannable_location_id в Targeting и поле cookie_frequency_cap в GenerateReachForecastRequest Никто Удаление Переключитесь на использование plannable_location_ids и cookie_frequency_cap_setting .
Отчеты
Поле customer_metrics в GenerateBenchmarksMetricsResponse и BreakdownMetrics типа Metrics Поле типа CustomerMetrics Изменение типа личности / сдвиг в поведении Обновите свои интеграции, чтобы использовать новый тип CustomerMetrics , который содержит только метрики, отражающие эффективность рекламы клиента.

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

Функции и обновления Тип Описание
Реклама
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS Новое значение перечисления / поведение Доступно для DemandGenMultiAssetAds . Если включено, генерируются анимированные изображения, используя в качестве входных данных неанимированные изображения. Новые DemandGenMultiAssetAds по умолчанию включены, начиная с этой версии API.
Изменчивость информации о синтетическом контенте Изменение поведения В версиях v25, v24 и v23 Asset.synthetic_content_info и Ad.synthetic_content_info теперь полностью изменяемы.
Кампании
Цель по удержанию лояльности Новые функции / настройки Добавлена ​​поддержка цели по удержанию лояльных клиентов, которая позволяет рекламодателям оптимизировать кампании для сохранения участников программы лояльности.
Цель по привлечению новых клиентов Новые функции / настройки В API Google Ads обновлена ​​поддержка целей по привлечению новых клиентов в соответствии с обновленной унифицированной схемой целей:
Конверсии
Атрибуция конверсий сторонними сервисами YouTube Новые поля Добавлена ​​поддержка проверки атрибуции конверсий на YouTube с использованием сторонних партнеров: Подробнее можно узнать в статье Справочного центра .
Общий
ContactDetails.phone_number_extension Новое поле Добавлено в ресурс LocalServicesLead .
IncentiveError Новые значения перечисления / ошибки Добавлены новые специальные коды ошибок для случаев неудачного использования бонусных баллов:
  • BILLING_COUNTRY_NOT_ELIGIBLE не имеет права на получение бонуса (страна выставления счетов клиента не имеет права на получение бонуса)
  • USER_IS_MCC_MANAGER (пользователь является менеджером и не может использовать бонус)
  • USER_SUSPENDED (учетная запись клиента приостановлена)
  • MAX_PENDING_INCENTIVES (клиент достиг максимального количества ожидающих начисления бонусов)
  • ACCOUNT_HAD_RECENT_SPEND (на этом счете недавно были траты, и он не соответствует условиям)
  • MAX_INCENTIVES_REDEEMED_FROM_OFFER (клиент уже использовал максимальное количество бонусов по этому предложению)
  • MISMATCHING_BILLING_COUNTRY_CODE (код страны, указанный в запросе, не соответствует стране учетной записи клиента)
Планирование
Подробная информация о YouTube-канале в разделе «Аналитика трендов». Новые поля Добавлена ​​поддержка отображения более подробной информации о YouTube-канале для связанных видео при поиске в разделе "Анализ трендов". В поле YouTubeVideoAttributeMetadata добавлены новые поля channel_id , channel_name и channel_url .
YouTubeChannelInsights.data_sharing_consent_given Новое поле Добавлено в YouTubeChannelInsights . Это справедливо, если автор дал согласие на предоставление непубличных данных. В этом случае заполняются следующие поля:
Отчеты
ad_sub_format_type Новый сегмент Предоставляет разбивку по продолжительности неотключаемых рекламных объявлений в видеопотоке YouTube: Этот сегмент всегда должен быть выбран вместе с ad_format_type . Он может быть выбран вместе с AdGroup , AdGroupAd , Campaign , Customer , Video и VideoEnhancement .
Социальные метрики, специфичные для видео Новые поля / метрики Добавлены специальные социальные метрики для видео, которые помогут рекламодателям отслеживать вовлеченность пользователей (комментарии, лайки и репосты) в рекламных объявлениях Shorts на YouTube: Они доступны в AdGroup , AdGroupAd , Asset , Campaign , Customer и Video .

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_attestation (заявления, предоставленные непосредственно рекламодателем) и system_attestation (подтверждения, автоматически обнаруженные или предоставленные системой).

Эта функция была перенесена в версии 23 и 22.

Чтобы помочь вам спланировать предстоящую работу по интеграции для версии 25, интерфейс для изменения полей подтверждения рекламодателя будет представлен заранее для версий 22 и выше. Интерфейс доступен в этих версиях, но поля synthetic_content_info.advertiser_attestation.status и synthetic_content_info.advertiser_attestation.source останутся неизменяемыми для этих версий.

При попытке изменить значение любого из этих полей будет возвращена одна из следующих ошибок:

«Поле, которое пытались изменить, неизменяемо» или «Поле не может быть установлено».

Начиная с версии 25, эти поля станут полностью изменяемыми. Мы рекомендуем использовать интерфейс уже сейчас для создания и тестирования вашей внутренней логики, чтобы ваша система была готова к полноценной записи данных после запуска версии 25.

Многосторонняя авторизация Новые функции Добавлена ​​поддержка многосторонних проверок авторизации (MPA):
Эта функция была перенесена в версии 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 Никто Удаление Удалены следующие поля и типы плана/прогноза: Обновите интеграции соответствующим образом.
Отчеты
сегмент ad_sub_network_type в campaign_budget Никто Удаление Удалён сегмент ad_sub_network_type для ресурса campaign_budget .
Сегмент click_type в представлениях активов Никто Удаление Удалён сегмент из представлений AdGroupAsset , CampaignAsset и CustomerAsset .
Видео
В ShareablePreviewService.GenerateShareablePreviews допускается частичная ошибка. Частичный сбой отсутствует Изменение поведения Если какой-либо идентификатор в запросе не пройдет проверку, он завершится с ошибкой.
Устаревшие коды ShareablePreviewError : 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 Новый ресурс для составления отчетов Предоставляет отчеты, сегментирующие показатели конверсии по конкретному продаваемому товару (бренду и т. д.), а также по товару, на который был совершен клик.
Показатели, не подлежащие торгам Новые поля Добавлены показатели, не зависящие от назначения ставок (показатели конверсий, которые не оптимизируются в рамках кампаний), ко всем соответствующим ресурсам:
conversion_attribution_event_type Новый сегмент Добавлено в ShoppingPerformanceView .
Покупки
Рекламные кампании приложений в ShoppingProduct Новая функция Поддерживаются кампании приложений внутри ресурса ShoppingProduct . Обратите внимание, что статусы и проблемы не поддерживаются.
Фильтрация товаров по тегам Новая функция Введена функция фильтрации с использованием динамических выражений логических множеств: Эта функция доступна только для учетных записей, включенных в список разрешенных.

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):

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 Новые функции / поддержка Обновлены материалы для деловых сообщений:
Выставление счетов
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		 Поддержка новых сегментов Support metrics segmented by conversion date: 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 , and cross_device_conversions_value_by_conversion_date .
Vertical ads segments New segments Added the following segments: 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 , and vertical_ads_vertical .
PerStoreView
MatchedLocationInterestView		 New reporting resources Added PerStoreView to query store location details, and MatchedLocationInterestView (for AI Max campaigns) to provide performance metrics by geographic locations of interest.
Покупки
ShoppingPerformanceView New metrics support Now supports the following metrics segmented by conversion date: conversions_by_conversion_date , all_conversions_by_conversion_date , conversions_value_by_conversion_date , and value_per_conversions_by_conversion_date , value_per_all_conversions_by_conversion_date .
ShoppingPerformanceView New metrics support Added support for: search_budget_lost_impression_share , search_rank_lost_impression_share , search_budget_lost_absolute_top_impression_share , and search_rank_lost_absolute_top_impression_share .
ShoppingProduct.product_image_uri New field Added to ShoppingProduct .
Vertical ads
AdGroup.vertical_ads_format_setting New field Allows control over which ad formats can serve in Search campaigns using travel feeds.
AdGroupCriterion
SharedCriterion		 New fields / criteria Added vertical_ads_item_group_rule_list criterion type to AdGroupCriterion and vertical_ads_item_group_rule to SharedCriterion to permit targeting item groups in Search campaigns with travel feeds.
Vertical ads data feed integration Новая функция Can now connect a vertical ads data feed to a search campaign running AI Max to show property promotion and booking link travel ads alongside text ads. Control formats with vertical_ads_format_setting and define rules using vertical_ads_item_group_rule . Segment reporting by AdFormatType and vertical ads data feed dimensions.
Видео
AdVideoAssetInfo.ad_video_asset_feature_control New field Added feature control options for video ad assets.
CampaignCriterionError New enum value / error Added the INVALID_VIDEO_LINEUP_ID error code.
YouTube audibility metrics New metrics Added audibility metrics for audio ads on YouTube, reporting whether an ad was audible and on how many impressions audibility could be measured.

v22 major and minor versions

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

v22.2 (2026-06-24)

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

Features and updates Тип Описание
Общий
Asset.synthetic_content_info
Ad.synthetic_content_info		 Новые поля Contain attestations for synthetic/AI-generated content, split into advertiser_attestation (declarations provided directly by the advertiser) and system_attestation (attestations automatically detected or provided by Google's systems).

To help you plan your upcoming integration work for v25, the interface for mutating advertiser attestation fields is being introduced early for v22 and higher. The interface is visible in these versions, but synthetic_content_info.advertiser_attestation.status and synthetic_content_info.advertiser_attestation.source will remain immutable for these versions.

If you attempt a mutate request on either of these fields, one of these errors will be returned:

"The field attempted to be mutated is immutable" or "Field cannot be set".

These fields will become fully mutable starting in v25. We recommend using the interface now to build and test your internal logic so your system is ready for full write capabilities when v25 is launched.

Согласования от нескольких сторон Новые функции Added support for multi-party approvals (MPA) reviews:

v22.1 (2026-02-25)

The following new feature was added in Google Ads API v22.1. Minor versions like v22.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 EuPoliticalAdvertisingStatus .
Кампании
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.

v22 (2025-10-15)

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

See Upgrade to the latest version for guidance.

Breaking changes

Initial state New state Change type Implementation guidance
Генерация спроса
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros minimum_budget_amount_micros Rename / spelling fix Rename references to use the corrected field name.
Общий
No operations limit in AddBatchJobOperations 10,000 operations limit per request Behavioral shift Ensure that no single AddBatchJobOperations request contains more than 10,000 operations.
Silently capped page size at 1,000 in ListBatchJobResultsRequest Returns INVALID_PAGE_SIZE error Behavioral shift Ensure ListBatchJobResultsRequest.page_size is set to 1,000 or less, as requesting a larger page size will now result in an error.
Максимальная производительность
Asset performance labels Никто Удаление Asset performance labels support and the associated performance label enum have been removed for Performance Max campaigns. Update integrations accordingly.
Campaign.url_expansion_opt_out FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION flag in AssetAutomationSetting Removal / replacement Use the final URL expansion text asset automation setting. The Campaign-level URL expansion opt-out field is removed.
Планирование
views trueview_views Removal / replacement Replace references to views with the new trueview_views field in 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		 Renames Update query strings and integrations to use the new metric names representing TrueView video views.

Features and updates (non-breaking)

Features and updates Тип Описание
Ресурсы
AssetFieldType.LANDING_PAGE_PREVIEW New enum value Added as a new image asset field type.
AssetGenerationService New service (Beta) Allows generating text and image assets using generative AI:
  • GenerateText : Generates text based on final URL, prompts, keywords, etc.
  • GenerateImages : Generates images based on final URL, prompts, or recontextualizing product images.
  • Errors are returned with codes from AssetGenerationError .
Initially available only to a limited set of closed beta participants.
Кампании
AppCampaignBiddingStrategyGoalType New enum values Added new goals for App campaigns for installs (ACi) to optimize without specifying a target:
  • 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:
Планирование
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 Новые поля 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 Новые поля 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 Тип Описание
Общий
Согласования от нескольких сторон Новые функции Added support for multi-party approvals (MPA) reviews:

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.

Breaking changes

Initial state New state Change type 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 По умолчанию — 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 Изменение типа 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 Новые поля 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 Новые поля 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 Новые поля 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 Новые поля 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 New segment 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 Новые поля Added support for value_adjustment and all_value_adjustment metrics in the AssetGroup report.
landing_page_source New segment Provides a landing page source segment in landing_page_view .
search_term_match_source New segment Selectable segment in the search term and campaign search term views.
match_type New segment Selectable segment key in the keyword view.
Unique query intent clusters reporting Новые поля 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 Новые поля 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 Новые поля 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.