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

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

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

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

v25.1 (19.08.2026)

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

Функции и обновления	Тип	Описание
Ресурсы
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER	Новые значения перечисления	Добавлена ​​поддержка текстовых дисклеймеров.
Кампании
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time	Новые поля	Следите за предстоящим автоматическим переходом на AI Max.
Конверсии
Измерения Brand Lift	Новые функции	Добавлена ​​поддержка измерений Brand Lift в следующих обновлениях: Добавлены новые доступные только для чтения данные о параметрах результатов исследования лифтинга: LiftMeasurementAgeRange , LiftMeasurementCampaign , LiftMeasurementDevice , LiftMeasurementGender и LiftMeasurementVideo . Добавлены новые сегменты и метрики для поддержки анализа прироста бренда с помощью LiftMeasurementConfig и новых многомерных ресурсов. Добавлены следующие перечисления: BrandLiftMeasurementType , LiftMeasurementFlightStatus , SurveyIntendedAction , SurveyLiftFlightTargetResponseMode и SurveySubjectType .
Измерения лифта для переоборудования	Новые функции	В следующих обновлениях добавлена ​​поддержка измерений для лифтов-конвертерных систем: Добавлен новый ресурс только для чтения LiftMeasurementConfig , представляющий собой исследование лифта. Добавлены новые выбираемые сегменты для сегментации и фильтрации результатов. Добавлено 24 новых показателя повышения конверсии и метрики оценки победителя, поддерживающие подробный статистический анализ эффективности повышения конверсии. Добавлена ​​поддержка получения подробной информации о кампании и целях конверсии. Добавлено новое необязательное поле Experiment.lift_measurement_config . Добавлено перечисление ConversionLiftIncludedConversionActionTypes .
LiftMeasurementFlight	Новый ресурс	Новый ресурс только для чтения, представляющий подробные сведения о полете для конфигурации измерения подъемной силы, включая измеренные даты начала и окончания полета ( start_date и end_date ).
Общий
SmartCampaignError	Новые значения перечисления	Добавлены новые специфические коды ошибок для ограничений генерации Performance Max: VALIDATE_ONLY_GENERATE_PMAX_NOT_SUPPORTED GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	Новое значение перечисления / ошибка	Возвращается, когда проект Google Cloud с уровнем доступа TEST пытается отправлять запросы к учетной записи, не относящейся к тестовой.
Планирование
Анализ настроений потребителей в отношении бренда	Новые функции	Добавлена ​​поддержка анализа настроений потребителей в ContentCreatorInsightsService : Добавлены сообщения BrandSentimentInsight , SentimentInsightDistribution и SentimentInsightSummary . Добавлено перечисление Sentiment . Добавлено значение BRAND_SENTIMENT_DATA в перечисление ContentCreatorInsightsSupplementalData . Добавлено значение BRAND в перечисление InsightsKnowledgeGraphEntityCapabilities .
Контрольные показатели. Улучшения BenchmarksService	Новые функции	Добавлена ​​поддержка категорий в качестве фильтров для определения области анализа сравнительных показателей. Также добавлена ​​поддержка дополнительных критически важных для бизнеса метрик: Добавлена ​​возможность сравнения показателей со всеми рекламодателями, размещающими рекламу в одной или нескольких категориях товаров и услуг, с помощью BenchmarksService.GenerateBenchmarksMetrics и category_filter . Добавлены дополнительные метрики для анализа рекламы, такие как совокупная стоимость, количество просмотров и т. д., а также метрики доли аудитории, например, share_of_voice . Метрики возвращаются с помощью AggregateMetrics и ShareMetrics . Список поддерживаемых категорий можно получить с помощью BenchmarksService.ListBenchmarksSources , указав тип источника CATEGORY .
Целевой подход к родительскому статусу	Новая функция	Добавлена ​​поддержка таргетинга по родительскому статусу в планировании охвата. Новое поле parental_statuses добавлено в Targeting для сервиса ReachPlanService.GenerateReachForecast , а parental_statuses добавлено в PlannableTargeting для сервиса ReachPlanService.ListPlannableProducts .
Рекомендации
Recommendation.campaign_specific_app_goal_recommendation	Новая рекомендация	Предлагается добавить цель по конверсии приложения, специфичную для конкретной кампании. Новый ресурс EffectiveAutomaticGoal используется для представления текущих целей в рамках этой рекомендации.
Отчеты
Metrics.original_conversion_value	Новое поле	Представляет собой исходное значение конверсии, полученное в результате совершения ставок. Это нескорректированное значение конверсий до применения каких-либо правил оценки, таких как правила оценки конверсии или корректировки целей жизненного цикла.
Статистика лояльности участников программы лояльности	Новые функции	Добавлена ​​поддержка сегментации статистики по статусу участия пользователя в программе лояльности, а также добавлен основной параметр «Участие в программе лояльности» для правил расчета стоимости конверсии: Добавлен сегмент Segments.loyalty_membership для поддержки сегментации показателей отчетов по уровню программы лояльности пользователя, совершившего конверсию. Добавлен основной параметр LOYALTY_MEMBERSHIP для определения случаев выполнения условия членства в программе лояльности для правила расчета стоимости конверсии.
Целенаправленное воздействие
vertical_ads_item_bid	Новый тип критерия	В файл AdGroupCriterion.criterion добавлен новый тип критерия vertical_ads_item_bid .

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 ).	Никто	Удаление	Используйте обновленную схему единых целей: Используйте поле new_customer_acquisition_goal_settings в ресурсе Goal . Используйте поле campaign_new_customer_acquisition_settings в ресурсе CampaignGoalConfig для настройки переопределений, специфичных для конкретной кампании.
Общий
Вложенные поля перечисления в сообщениях запроса и ответа службы стимулирования: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	Автономные поля перечисления: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_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 теперь полностью изменяемы.
Кампании
Цель по удержанию лояльности	Новые функции / настройки	Добавлена ​​поддержка цели по удержанию лояльных клиентов, которая позволяет рекламодателям оптимизировать кампании для сохранения участников программы лояльности. В перечисление GoalType добавлено значение LOYALTY_RETENTION . Добавлена CampaignGoalConfig.campaign_loyalty_retention_settings для настройки параметров удержания лояльности для конкретных кампаний, включая корректировку ставок и отображение преимуществ для участников в формате PLA. Добавлена Goal.loyalty_retention_goal_settings для настройки целевых показателей удержания лояльности на уровне учетной записи. Добавлены новые коды ошибок: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
Цель по привлечению новых клиентов	Новые функции / настройки	В API Google Ads обновлена ​​поддержка целей по привлечению новых клиентов в соответствии с обновленной унифицированной схемой целей: Ресурс Goal расширен для поддержки настроек привлечения новых клиентов с использованием поля new_customer_acquisition_goal_settings . Ресурс CampaignGoalConfig расширен для поддержки переопределения параметров привлечения новых клиентов в зависимости от конкретной кампании с помощью поля campaign_new_customer_acquisition_settings . Добавлено новое перечисление CustomerLifecycleOptimizationGoalSubType для определения поддерживаемых подтипов целей. В перечисление GoalType добавлено значение NEW_CUSTOMER_ACQUISITION . В GoalError добавлены новые причины ошибок валидации: NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS В CampaignGoalConfigError добавлены новые причины ошибок валидации: CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE CANNOT_USE_INCOMPATIBLE_CLO_GOALS Добавлена ​​структура ErrorDetails.incompatible_clo_goal_error_details для отображения новой структуры IncompatibleCloGoalsErrorDetails для ошибок валидации.
Конверсии
Атрибуция конверсий сторонними сервисами YouTube	Новые поля	Добавлена ​​поддержка проверки атрибуции конверсий на YouTube с использованием сторонних партнеров: Добавлена ​​переменная CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners , позволяющая настраивать партнеров по интеграции на уровне клиента. Добавлена ​​функция CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners , позволяющая настраивать партнеров по интеграции на уровне кампании. Подробнее можно узнать в статье Справочного центра .
Общий
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 . Это справедливо, если автор дал согласие на предоставление непубличных данных. В этом случае заполняются следующие поля: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
Отчеты
ad_sub_format_type	Новый сегмент	Предоставляет разбивку по продолжительности неотключаемых рекламных объявлений в видеопотоке YouTube: INSTREAM_NON_SKIPPABLE_STANDARD (стандартная продолжительность не пропускаемой рекламы в потоке) INSTREAM_NON_SKIPPABLE_MAX30_SEC (непропускаемая реклама в потоке длительностью не более 30,99 секунд) INSTREAM_NON_SKIPPABLE_MAX60_SEC (непропускаемая реклама в потоке длительностью не более 60,99 секунд) Этот сегмент всегда должен быть выбран вместе с ad_format_type . Он может быть выбран вместе с AdGroup , AdGroupAd , Campaign , Customer , Video и VideoEnhancement .
Социальные метрики, специфичные для видео	Новые поля / метрики	Добавлены специальные социальные метрики для видео, которые помогут рекламодателям отслеживать вовлеченность пользователей (комментарии, лайки и репосты) в рекламных объявлениях Shorts на YouTube: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares Они доступны в 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): Добавлен ресурс 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	Новые поля	Added the following metrics: metrics.average_cpe , metrics.average_cpm , metrics.trueview_average_cpv , metrics.video_trueview_view_rate , metrics.video_trueview_views , and metrics.interaction_event_types .
Asset.orientation	Новое поле	Read-only orientation field added to image and video assets.
CampaignAsset	Новая функция	Added support to retrieve campaign assets with field_type set to HEADLINE and DESCRIPTION .
ServedAssetFieldType	New enum values	Added HEADLINE_AS_SITELINK_POSITION_ONE , HEADLINE_AS_SITELINK_POSITION_TWO , DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE , and DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO for assets served as sitelinks.
BusinessMessageAsset	New features / support	Updated Business Message assets: Added support for Facebook Messenger and Zalo as providers. Added FACEBOOK_MESSENGER and ZALO to BusinessMessageProvider . Added fields facebook_messenger_info and zalo_info . Added CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS to AssetError .
Выставление счетов
InvoiceService.ListInvoices	New options	Can now return more granular details in Invoice , including campaign-level cost breakdown, itemized regulatory costs, and adjustment information, by setting include_granular_level_invoice_details in ListInvoicesRequest .
RegulatoryFeeType UnitOfMeasure	New enums	Added helper enums for regulatory fees and units of measure.
Кампании
CampaignError	New enum values / errors	Added DURATION_TOO_LONG_FOR_TOTAL_BUDGET and END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET error codes.
Конверсии
ConversionActionCategory	New enum value	Added YOUTUBE_FOLLOW_ON_VIEWS to support tracking users who watch an ad and later watch a video from the same channel.
Генерация спроса
DemandGenVideoResponsiveAdInfo.companion_banner	Новое поле	Added support for companion banners in Demand Gen responsive video ads.
Стимулы
Added Choose Your Own (CYO) incentives support: Added the FetchIncentive method to retrieve available personalized incentives for a user. Added the ApplyIncentive method to apply a selected incentive to a customer account. Added the AppliedIncentive resource (queryable using Search and SearchStream ) to provide redemption details. Added new error codes in IncentiveError and AuthenticationError.INVALID_EMAIL_ADDRESS . To facilitate more granular programmatic handling of failures, we will add additional error codes to IncentivesService in future releases. We recommend that you monitor upcoming announcements and release notes for these new error codes to make sure your applications can manage these new failure modes.
Планирование
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	New enum value	Allows building audiences using Life Events in GenerateAudienceCompositionInsights , GenerateSuggestedTargetingInsights , GenerateInsightsFinderReport , and GenerateCreatorInsights . Life Events are not supported for other AudienceInsightsService methods such as AudienceInsightsService.GenerateAudienceOverlap and AudienceInsightsService.GenerateTargetingSuggestionMetrics .
ReachPlanService.GenerateConversionRates	New fields / options	The response now includes surfaces to support conversion rate suggestions based on surface controls (eg, Gmail, Shorts). Only supported for Demand Gen campaigns.
LanguageDistribution	New field / type	Added to YouTubeChannelInsights to provide language distribution details in YouTube channel content.
BenchmarksService	Новая услуга	Compares YouTube advertisement data against industry benchmarks.
AudienceInsightsService.GenerateAudienceDefinition	New method	Translates a free text description of a target audience into matching audience attributes using generative AI.
YouTubeChannelInsights.relevance_score	Новое поле	Evaluates how relevant a creator is for a topic weighted by views.
TrendInsightMetrics.trend_change_percent	Новое поле	Represents the percentage change in a trend's value over the comparison period.
Рекомендации
GenerateRecommendationsRequest	Новое поле	Added is_new_customer . When set to true for CAMPAIGN_BUDGET recommendations, it uses a model optimized for new customers (only recommended for customers with no campaigns).
Отчеты
AdGroupAdAssetView	New feature / metrics support	Now supports impression, performance, and conversion metrics for RESPONSIVE_DISPLAY_AD .
ad_sub_network_type segment	New segment	Provides granular performance breakdown within an ad network. Initially available for Demand Gen campaigns on YouTube (In-stream, In-feed, Shorts). Must be selected along with ad_network_type .
Performance Max reporting	Новая функция	Enabled ad network type breakdown for Performance Max campaigns.
UserLocationView GeographicView	New segments support	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	Новое поле	Added to ShoppingProduct .
Vertical ads
AdGroup.vertical_ads_format_setting	Новое поле	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	Новое поле	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	New fields	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.
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.

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	Новое поле	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	Новое поле	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.

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

Начальное состояние	New state	Изменить тип	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	Новое поле	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	Новое поле	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).

Archived release notes

See Sunsetted versions for archived release notes.

,

Refer to Feature deprecations for an up to date list of current and planned feature deprecations.

v25 major and minor versions

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

v25.1 (2026-08-19)

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

Features and updates	Тип	Описание
Ресурсы
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER	New enum values	Added support for text disclaimer assets.
Кампании
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time	New fields	Track the upcoming auto-migration to AI Max.
Конверсии
Brand Lift measurements	Новые функции	Added support for Brand Lift measurements with the following updates: Added new read-only dimensional resources for lift study results: LiftMeasurementAgeRange , LiftMeasurementCampaign , LiftMeasurementDevice , LiftMeasurementGender , and LiftMeasurementVideo . Added new segments and metrics to support Brand Lift analysis with LiftMeasurementConfig and the new dimensional resources. Added the following enums: BrandLiftMeasurementType , LiftMeasurementFlightStatus , SurveyIntendedAction , SurveyLiftFlightTargetResponseMode , and SurveySubjectType .
Conversion Lift measurements	Новые функции	Added support for Conversion Lift measurements with the following updates: Added a new read-only resource LiftMeasurementConfig representing a lift study. Added new selectable segments to segment and filter lift results. Added 24 new Conversion Lift metrics and winner score metrics supporting detailed statistical analysis of lift performance. Added support to retrieve campaign details and conversion goals. Added a new optional field Experiment.lift_measurement_config . Added the ConversionLiftIncludedConversionActionTypes enum.
LiftMeasurementFlight	New resource	A new read-only resource representing flight details for a lift measurement configuration, including measured flight start and end dates ( start_date and end_date ).
Общий
SmartCampaignError	New enum values	Added new specific error codes for Performance Max generation constraints: VALIDATE_ONLY_GENERATE_PMAX_NOT_SUPPORTED GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	New enum value / error	Returned when a Google Cloud project with TEST access level attempts to make requests against a non-test account.
Планирование
Brand sentiment insights	Новые функции	Added support for brand sentiment insights in ContentCreatorInsightsService : Added the BrandSentimentInsight , SentimentInsightDistribution , and SentimentInsightSummary messages. Added the Sentiment enum. Added the BRAND_SENTIMENT_DATA value to the ContentCreatorInsightsSupplementalData enum. Added the BRAND value to the InsightsKnowledgeGraphEntityCapabilities enum.
BenchmarksService enhancements	Новые функции	Added support for categories as filters for scoping a benchmarks analysis. Also supported additional business critical metrics: Added an option to benchmark against all advertisers running Ads in one or more Product & Service Categories using BenchmarksService.GenerateBenchmarksMetrics and the category_filter . Surfaced more customer ad metrics such as the customer's aggregate cost, views, etc. and share metrics such as share_of_voice . Metrics are returned using AggregateMetrics and ShareMetrics . The list of supported categories can be retrieved using BenchmarksService.ListBenchmarksSources with the CATEGORY source type.
Parental status targeting	Новая функция	Added support for parental status targeting in reach planning. The new field parental_statuses has been added to Targeting for service ReachPlanService.GenerateReachForecast , and parental_statuses has been added to PlannableTargeting for service ReachPlanService.ListPlannableProducts .
Рекомендации
Recommendation.campaign_specific_app_goal_recommendation	New recommendation	Suggests adding a campaign-specific app conversion goal. The new EffectiveAutomaticGoal resource is used to represent current goals within this recommendation.
Отчеты
Metrics.original_conversion_value	Новое поле	Represents the original conversion value from biddable conversions. This is the unadjusted value of conversions before any value rule adjustments, such as conversion value rules or lifecycle goals adjustments are applied.
Loyalty membership stats	Новые функции	Added support for segmenting stats by user loyalty membership program status, and added loyalty membership primary dimension for conversion value rules: Added the Segments.loyalty_membership segment to support segmenting report metrics by the loyalty program tier of the converting user. Added the LOYALTY_MEMBERSHIP primary dimension to identify when a loyalty membership condition was satisfied for a conversion value rule.
Целенаправленное воздействие
vertical_ads_item_bid	New criterion type	Added the new vertical_ads_item_bid criterion type to AdGroupCriterion.criterion .

v25 (2026-07-22)

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

See Upgrade to the latest version for guidance.

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

Начальное состояние	New state	Изменить тип	Implementation guidance
Кампании
Standalone fields additional_value and additional_high_lifetime_value in CustomerLifecycleOptimizationValueSettings	Part of value_adjustment and high_lifetime_value_adjustment oneofs respectively, alongside the new value_multiplier and high_lifetime_value_multiplier fields	Структурные изменения	Update references to these fields as they are now part of oneofs.
Legacy CustomerLifecycleGoal and CampaignLifecycleGoal resources, their corresponding services CustomerLifecycleGoalService and CampaignLifecycleGoalService , and legacy settings/enums ( CustomerAcquisitionGoalSettings , CustomerAcquisitionOptimizationModeEnum , LifecycleGoalValueSettings )	Никто	Удаление	Use the revamped unified goals schema: Use the new_customer_acquisition_goal_settings field in the Goal resource. Use the campaign_new_customer_acquisition_settings field in the CampaignGoalConfig resource to configure campaign-specific overrides.
Общий
Nested enum fields in Incentive Service request and response messages: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	Standalone enum fields: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	Rename / removal	Use the new standalone enum fields instead of the legacy type fields.
Optional selected_incentive_id and customer_id fields in ApplyIncentiveRequest	Обязательные поля	Behavioral shift	Ensure you provide both fields when calling ApplyIncentive .
The consumer email address field ContactDetails.email in the LocalServicesLead resource	Никто	Удаление	Remove references to this field because it is no longer supported.
Optional allowed_domain field in AdvertisingPartnerLinkInvitationProperties	Required field when calling CreateProductLinkInvitation for an advertising partner	Behavioral shift	Ensure you provide allowed_domain when creating a product link invitation for an advertising partner.
Планирование
The search_brand field in GenerateCreatorInsightsRequest	Никто	Удаление	Use search_topics instead.
The plannable_location_id field in Targeting and cookie_frequency_cap field in GenerateReachForecastRequest	Никто	Удаление	Switch to using plannable_location_ids and cookie_frequency_cap_setting .
Отчеты
customer_metrics field in GenerateBenchmarksMetricsResponse and BreakdownMetrics of type Metrics	Field of type CustomerMetrics	Type change / behavioral shift	Update your integrations to use the new CustomerMetrics type, which only contains metrics representing the customer's ad performance.

Features and updates (non-breaking)

Features and updates	Тип	Описание
Реклама
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	New enum value / behavior	Available for DemandGenMultiAssetAds . If enabled, it generates animated images using non-animated images as input. New DemandGenMultiAssetAds are opted in by default starting with this API version.
Synthetic content info mutability	Behavior change	Asset.synthetic_content_info and Ad.synthetic_content_info are now fully mutable in v25, v24, and v23.
Кампании
Loyalty Retention Goal	New features / settings	Added support for Loyalty Retention Goal, which allows advertisers to optimize campaigns for retaining loyalty program members. Added LOYALTY_RETENTION to the GoalType enum. Added CampaignGoalConfig.campaign_loyalty_retention_settings to configure campaign-specific loyalty retention settings, including bid adjustments and showing member benefits in PLA format. Added Goal.loyalty_retention_goal_settings to configure account-level loyalty retention goal settings. Added new error codes: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
New Customer Acquisition Goal	New features / settings	Updated New Customer Acquisition Goal support in the Google Ads API to reflect the revamped unified goals schema: Extended the Goal resource to support New Customer Acquisition settings using the new_customer_acquisition_goal_settings field. Extended the CampaignGoalConfig resource to support campaign-specific overrides for New Customer Acquisition using the campaign_new_customer_acquisition_settings field. Added the new CustomerLifecycleOptimizationGoalSubType enum to define supported goal subtypes. Added NEW_CUSTOMER_ACQUISITION to the GoalType enum. Added new validation error reasons to GoalError : NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS Added new validation error reasons to CampaignGoalConfigError : CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE CANNOT_USE_INCOMPATIBLE_CLO_GOALS Added ErrorDetails.incompatible_clo_goal_error_details to expose the new IncompatibleCloGoalsErrorDetails structure for validation errors.
Конверсии
YouTube third-party conversion attribution	New fields	Added support for YouTube conversion attribution verification using third-party partners: Added CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners to allow configuring integration partners at the customer level. Added CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners to allow configuring integration partners at the campaign level. See the Help Center article to learn more.
Общий
ContactDetails.phone_number_extension	Новое поле	Added to the LocalServicesLead resource.
IncentiveError	New enum values / errors	Added new specific error codes for incentive redemption failures: BILLING_COUNTRY_NOT_ELIGIBLE (the customer's billing country is not eligible for the incentive) USER_IS_MCC_MANAGER (the user is a manager account and cannot redeem the incentive) USER_SUSPENDED (the customer account is suspended) MAX_PENDING_INCENTIVES (the customer has reached the maximum number of pending incentives) ACCOUNT_HAD_RECENT_SPEND (the account had recent spend and is not eligible) MAX_INCENTIVES_REDEEMED_FROM_OFFER (the customer has already redeemed the maximum number of incentives from this offer) MISMATCHING_BILLING_COUNTRY_CODE (the billing country code provided in the request does not match the customer's account country)
Планирование
YouTube channel details in trending insights	New fields	Added support for more YouTube channel details of related videos when searching trending insights. The new fields channel_id , channel_name , and channel_url have been added to YouTubeVideoAttributeMetadata .
YouTubeChannelInsights.data_sharing_consent_given	Новое поле	Added to YouTubeChannelInsights . This is true if a creator has consented to sharing non-public data. If so, the following fields are populated: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
Отчеты
ad_sub_format_type	New segment	Provides a breakdown of YouTube instream non-skippable ads by duration: INSTREAM_NON_SKIPPABLE_STANDARD (standard duration instream non-skippable ad) INSTREAM_NON_SKIPPABLE_MAX30_SEC (instream non-skippable ad no longer than 30.99 seconds) INSTREAM_NON_SKIPPABLE_MAX60_SEC (instream non-skippable ad no longer than 60.99 seconds) This segment must always be selected together with ad_format_type . It is selectable with AdGroup , AdGroupAd , Campaign , Customer , Video , and VideoEnhancement .
Video-specific social metrics	New fields / metrics	Added video-specific social metrics to help advertisers track user engagement (comments, likes, and shares) for Shorts ads on YouTube: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares They are available in AdGroup , AdGroupAd , Asset , Campaign , Customer , and Video .

v24 major and minor versions

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

v24.2 (2026-06-24)

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

Features and updates	Тип	Описание
Реклама
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	New enum value	Generates text information from the landing page to be shown in the engagement panel for DemandGenVideoResponsiveAd instances (which are opted in by default starting with this API version).
Ресурсы
AssetGroup.google_local_services_info	Новое поле	Added to support Local Services Ads information (category ID and callouts) in Performance Max campaigns.
AssetGroupSignal.local_services_id	Новое поле	Added to support Local Services Ads service ID signals in Performance Max campaigns.
AssetGroupSignal.vertical_ads_item_group_rule_list	Новое поле	Added to support vertical ads item group rules for selecting items from attached vertical feeds in Performance Max campaigns. This feature is only available to accounts on the allowlist.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN	New enum value / error	Returned when attempting to remove all asset groups from a campaign.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS	New enum value / error	Returned when attempting to remove all signals from an asset group.
Кампании
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled	New fields	Support identifying Local Services Performance Max campaigns.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	Новое поле	Includes Google Maps in the selectable channels for Demand Gen ad groups.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	New enum value / error	Returned when attempting to remove all locations from a local services Performance Max campaign.
SmartCampaignErrorEnum.CREATION_FAILED	New enum value / error	Returned when attempting to create new Smart Campaigns.
Конверсии
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	New enum values	Represent conversions that occur when a user clicks on a local services ad and calls, messages, or books the advertiser.
Эксперименты
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	New enum values	Added support for new ExperimentType types: COMPARE_CAMPAIGNS : For campaign mix experiments and custom Performance Max experiments that compare multiple campaigns of the same or different types in a single experiment. PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION : For Performance Max optimization experiments for text customization and Final URL expansion.
Общий
Asset.synthetic_content_info Ad.synthetic_content_info	New fields	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 the system). This feature has been backported to v23 and v22. 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.
Multi-Party Authorization	Новые функции	Beta: This feature is currently in beta and is subject to change in future releases. Added support for Multi-Party Authorization (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. This feature has been backported to v23.3 , v22.2 , and v21.2 .
IncentiveService.FetchIncentive	Behavioral change	When an invalid email address is provided in the request, the method now gracefully falls back to returning the default incentive offers instead of throwing an AuthenticationError.INVALID_EMAIL_ADDRESS error.
Планирование
GenerateCreatorInsightsRequest.search_topics	Новое поле	Added to the ContentCreatorInsightsService.GenerateCreatorInsights service. This option searches for creators talking about a topic in the country specified in country_locations (supports searching for one country only).
CREATOR_TOPIC_INSIGHTS	New enum value	Added to InsightsKnowledgeGraphEntityCapabilities to signify entities for searching creators talking about a topic. These entities should be used in the search_topics field. Retrieved using AudienceInsightsService.ListAudienceInsightsAttributes .
KnowledgeGraphEntitySearchOptions	New type / options	Contains additional search options for topics in ListAudienceInsightsAttributes , including options to retrieve all topics supported as creator attributes, and filtering by capabilities.
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data	New fields	Optional inputs to the ContentCreatorInsightsService methods. Supplying this field populates additional locations or creator attributes in the response.
local_creator_insights related_local_creators	New fields	Populated when supplemental_data contains the LOCAL_CREATOR_DATA enum. Exposes local creators viewed in or based in the chosen country who consented to share location data.
GenerateTrendingInsightsRequest.sub_country_locations	Новое поле	Added to ContentCreatorInsightsService.GenerateTrendingInsights , allowing searches for trending insights using country location and sub country locations.
Отчеты
PerformanceMaxPlacementView	Segments extension	Made segmentable by ad_network_type .
Покупки
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	Новое поле	If true, brand exclusions are ignored for Shopping ads. Only supported for Shopping campaigns.
Целенаправленное воздействие
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	New enum value / error	Returned when attempting to target a language that is not allowed.
Видео
DataLink.youtube_link_metadata	Новое поле	Contains brand_channel_id to specify the ID of the linked YouTube brand channel.

v24.1 (2026-05-13)

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

Features and updates	Тип	Описание
Реклама
DemandGenMultiAssetAdInfo.classic_display_images	Новое поле	Custom uploaded display images served without requiring extra responsive assets.
Эксперименты
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	New enum values	Added support for new ExperimentType types: ADOPT_AI_MAX : For experiments that test how AI Max can help you engage more customers with Google AI and broad match keywords. ADOPT_BROAD_MATCH_KEYWORDS : For experiments that test how broad match keywords can impact the number of searches your ads appear in. OPTIMIZE_ASSETS : For custom experiments for optimizing assets. PMAX_REPLACEMENT_SHOPPING : For experiments that test how your Shopping campaigns perform compared to Performance Max.
Experiment.video_experiment	Новое поле	Configuration support for existing YOUTUBE_CUSTOM experiments consisting of Video campaigns.
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	New fields	Exposes fields to support asset testing, asset groups, and Performance Max settings in experiment arms: asset_testing_info : Details of assets associated with the experimental copies of ads. asset_groups : List of asset groups in the experiment arm for Optimize Assets experiments. performance_max_experiment_arm_info : Settings for Performance Max campaigns in PMAX_REPLACEMENT_SHOPPING experiments.
Общий
CustomerUserAccess.passkey_enabled	Новое поле	Read-only field indicating whether the user has a passkey enabled.
Отчеты
mobile_device_platform	New segment	Allows segmenting reports by the user device's platform (such as iOS or Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	New enum value / error	Returned when the requested daily, hourly, or weekly time granularity is not supported for query date ranges (only available for the last 37 months).
vertical_ads_listing_user_rating vertical_ads_listing_venue	New segments	New segments to be used for vertical ads.
user_rating , venue , event_participant_display_name	New filter criteria	Supported filtering in VerticalAdsItemGroupRuleInfo for the SharedCriterion resource.
Control/treatment experiment metrics	New fields	Added control values ( control_clicks , etc.), treatment values ( clicks , etc.), point estimates ( clicks_point_estimate , etc.), margins of error ( clicks_margin_of_error , etc.), and p-values ( clicks_p_value , etc.) across seven core metric families (Clicks, Impressions, Cost, Conversions, Cost per conversion, Conversion value, Conversion value per cost).
Conversions absolute change metrics	New fields	Support for Conversions absolute difference estimations using point estimate, margin of error, and p-value fields.
Целенаправленное воздействие
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS	New enum value / error	Returned when attempting to exclude all demographics targets.
Видео
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR	New enum value	Published ZEFR as a third party viewability integration partner.
DataLink.youtube_video.channel_id	Новое поле	Exposes the YouTube channel ID associated with the data link.

v24 (2026-04-22)

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

See Upgrade to the latest version for guidance.

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

Начальное состояние	New state	Изменить тип	Implementation guidance
Реклама
Optional videos and logo_images in DemandGenVideoResponsiveAdInfo	Обязательные поля	Behavioral shift	Provide videos and logo_images when creating or mutating responsive Demand Gen video ads.
Optional videos , business_name , and logo_images in VideoResponsiveAdInfo	Обязательные поля	Behavioral shift	Provide videos , business_name , and logo_images when creating or mutating video responsive ads. Note that VideoResponsiveAdInfo is now mutable.
Кампании
Campaign.video_brand_safety_suitability	Никто	Удаление	Campaign-level suitability control is removed. Brand safety suitability is still available on the customer level. Use Customer.video_brand_safety_suitability instead.
Конверсии
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Никто	Удаление	The loyalty sign ups user category has been removed. Remove code references to it.
Планирование
InsightsAudienceAttributeGroup type for topic_audience_combinations	common. InsightsAudienceAttributeGroup type	Behavioral shift / type change	Typed client libraries integrations must be updated to use the new resource namespaces.
youtube_select_lineups field in ReachPlanService.ListPlannableProducts	Никто	Удаление	Switch to using lineups from youtube_select_lineup_targeting .
is_brand_connect_creator field in ContentCreatorInsightsService.GenerateCreatorInsights and GenerateTrendingInsights	Никто	Удаление	Instead, check if a creator has CREATOR_PARTNERSHIPS available in partnership_opportunities .
geo_modifiers and biddable_keywords in KeywordPlanIdeaService.GenerateKeywordForecastMetrics	geo_target_constants and keywords	Rename / removal	Replaced by CampaignToForecast.geo_target_constants[] and ForecastAdGroup.keywords[] .
Deprecated keywords plan / forecast fields in GenerateKeywordForecastMetrics	Никто	Удаление	Removed the following plan / forecast fields and types: CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords and ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate Update integrations accordingly.
Отчеты
ad_sub_network_type segment in campaign_budget	Никто	Удаление	Removed ad_sub_network_type segment for the campaign_budget resource.
click_type segment in asset views	Никто	Удаление	Removed segment from AdGroupAsset , CampaignAsset , and CustomerAsset views.
Видео
Partial failure allowed in ShareablePreviewService.GenerateShareablePreviews	No partial failure	Behavioral shift	Requests will fail and throw an error if any ID within it fails validation.
ShareablePreviewError legacy codes: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST	Rename / behavioral shift	Error codes returned for asset groups are modified to align with ad group ad errors. Update validation catch logic.

Features and updates (non-breaking)

Features and updates	Тип	Описание
Реклама
Mutability of VideoResponsiveAdInfo	Behavioral change	Responsive video ads information objects are now mutable.
Ресурсы
travel_feed_data in AssetSet	Новое поле	Added to retrieve travel feed assets attributes ( hotel_center_account_id , merchant_center_id , partner_center_id , subset_id , travel_feed_vertical_type ).
Кампании
Campaign.view_through_conversion_optimization_enabled	Новое поле	Allows enabling View-Through Conversion (VTC) Optimization (default false ) in Demand Gen and App campaigns.
CampaignCriterion.gender	Новая функция	Enabled gender exclusions for Performance Max campaigns on all Google Ads API versions.
Конверсии
Lead Gen conversion types	New enum values	Added new GA4/Firebase conversion action type enums in ConversionActionType : 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	New enum value / error	Returned when attempting to create multiple identical lookalike lists.
Планирование
ProductCoreAttributes fields in ListPlannableProductsResponse	New fields	Added plannable product description, marketing objective, cost model, and buying method to ProductCoreAttributes under ListPlannableProductsResponse .
Отчеты
CartDataSalesView	New reporting resource	Exposes reports segmenting conversions metrics by the specific product sold (brand, etc.) in addition to the clicked product.
Non-biddable metrics	New fields	Added non-biddable metrics (metrics showing conversions that campaigns are not optimizing for) to all matching resources: 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	New segment	Added to ShoppingPerformanceView .
Покупки
App campaigns in ShoppingProduct	Новая функция	Supported App campaigns inside the ShoppingProduct resource. Note status and issues are not supported.
Tag-based product filtering	Новая функция	Introduced filtering using logical set expressions dynamically: Added RETAIL_FILTER_BUNDLE and RETAIL_FILTER criterion types. Added RETAIL_FILTER shared set type. Added the retail_filter_bundle field to AdGroupCriterion . Added the retail_filter field to SharedCriterion . Added RETAIL to ListingGroupFilterListingSource . Added RetailFilter dimension to AssetGroupListingGroupFilter . Added related new validation errors in CriterionError and AssetGroupListingGroupFilterError . This feature is only available to accounts on the allowlist.

v23 major and minor versions

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

v23.3 (2026-06-24)

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

Features and updates	Тип	Описание
Общий
Asset.synthetic_content_info Ad.synthetic_content_info	New fields	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.
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.

v23.2 (2026-03-25)

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

Features and updates	Тип	Описание
Ресурсы
VideoEnhancement	New resource	Contains enhancement-specific video ad information, such as whether it's Google-generated or advertiser-provided. See the About video enhancements to learn more.
AppTopCombinationView	New resource	Read-only resource to provide insights into top-performing asset combinations in App campaigns.
CustomerAsset	Новая функция	Added support to retrieve CustomerAsset with field_type set to BUSINESS_LOGO .
Кампании
AdGroupAd.start_date_time AdGroupAd.end_date_time	New fields	Provide more granular scheduling constraints over the campaign's dates. This is only supported for some ad group types.
HotelSettingInfo.disable_hotel_setting	Новое поле	Allows disabling the hotel feed in Demand Gen campaigns.
Общий
CustomerClientLinkError	New enum values / errors	Added two new error codes: MAX_CUSTOMER_LIMIT_REACHED and ACCOUNT_CREATION_POLICY_VIOLATION .
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Behavioral change	An error is now thrown when attempting to use this sunsetted user list customer type category.
Планирование
GenerateTrendingInsights GenerateCreatorInsights	Новые функции	Added support for custom AND/OR combinations of entities, topics, and audiences.
ReachPlanService.GenerateReachForecast	New enum values	Added new targetable age ranges, such as AGE_RANGE_21_44 or AGE_RANGE_21_49 .
youtube_select_lineup_targeting	Новое поле	Added to ReachPlanService.ListPlannableProducts , which will replace youtube_select_lineups . Both fields are currently populated.
ReachPlanSurface	New enum value	Added IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS as a surface option.
Forecast	Новое поле	Added clicks for Demand Gen Max Clicks (CPC) in ReachPlanService.GenerateReachForecast .
partnership_opportunities	Новое поле	Added to ContentCreatorInsightsService.GenerateCreatorInsights and ContentCreatorInsightsService.GenerateTrendingInsights .
Отчеты
biddable_indirect_install_first_in_app_conversion_micros	Новое поле	Added to Campaign , Customer , and AdGroup resources.
Видео
ShareablePreviewService	Новая функция	Extended to support YouTube Live previews by setting preview_type to YOUTUBE_LIVE_PREVIEW . Added UNSUPPORTED_AD_TYPE and TOO_MANY_RESOURCES_IN_REQUEST to ShareablePreviewError . This is only supported for some ad types.

v23.1 (2026-02-25)

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

Features and updates	Тип	Описание
Управление учетными записями
advertising_partner_properties.allowed_domain	Новое поле	Added to ProductLinkInvitation and ProductLink resources. The advertising partner will only be able to advertise on this domain.
Customer.contains_eu_political_advertising	Новое поле	Retrieves the account-level declaration status of whether it contains political advertising targeted towards the EU, and returns an EuPoliticalAdvertisingStatus .
Кампании
Campaign.text_guidelines	Новое поле	Added support for text guidelines, which can be used with Performance Max and Search campaigns to programmatically control AI-generated text assets. Within text_guidelines , you can define term_exclusions and messaging_restrictions .
CampaignPrimaryStatusReason	New enum values	Added CAMPAIGN_NOT_BOOKED , BOOKING_HOLD_EXPIRING , BOOKING_HOLD_EXPIRED , and BOOKING_CANCELLED to provide primary status reasons for campaigns with the FIXED_CPM bidding strategy.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details	New fields	Added support for reservation ad category self disclosure and read-only booking details.
Campaign.missing_eu_political_advertising_declaration	Новое поле	Supports querying and filtering campaigns that are missing declarations about whether they contain political advertising targeted towards the EU.
Конверсии
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS	New enum value	Supports tracking users who watch an ad and later watch a video from the same channel.
Общий
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED	New enum value / error	Returned when attempting to target only the undetermined category in demographics dimensions.
Стимулы
IncentiveErrorEnum	New enum values / errors	Added two new error codes: MAX_INCENTIVES_REDEEMED and ACCOUNT_TOO_OLD . These errors can be returned for requests made on or after March 11, 2026.
Планирование
GenerateBenchmarksMetrics	Новая функция	Added support for date breakdowns using a BreakdownDefinition .
ReachPlanService.GenerateReachForecast	New enum value	Added GOOGLE_DISPLAY_NETWORK as a targetable surface for Demand Gen Max Conversions.
GenerateTrendingInsights	New fields	Added historical trend line information in TrendInsightDataPoint to TrendInsights when searching by topic.
Отчеты
Unique user frequency metrics	New fields	Added new metrics that report how many users saw your ad at least two, three, four, five or ten times: unique_users_two_plus , unique_users_three_plus , unique_users_four_plus , unique_users_five_plus , and unique_users_ten_plus .
SearchTermMatchSource	New enum value	Added VERTICAL_ADS_DATA_FEED to support vertical ad data feeds, such as Travel Ads entity targeting.
YouTubeVideoUpload
YouTubeVideoUpload	New service / resource	Added the YouTubeVideoUpload service to support uploading and managing videos on YouTube, and the YouTubeVideoUpload resource to support fetching upload status and metadata. This feature is only supported for REST and the Python client library.

v23 (2026-01-28)

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

See Upgrade to the latest version for guidance.

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

Начальное состояние	New state	Изменить тип	Implementation guidance
Реклама
Ad sharing permitted	AdGroupAdError.AD_SHARING_NOT_ALLOWED	Behavioral shift	Ad sharing among multiple ad groups is no longer permitted. Requests attempting to share ads will return an AD_SHARING_NOT_ALLOWED error.
Support for CallAd and CallAdInfo	Никто	Удаление	Support for call ads has been removed. Refer to the About call ads help center article.
Кампании
Campaign.start_date Campaign.end_date	Campaign.start_date_time Campaign.end_date_time	Rename / replacement	Use the new date-time fields to specify time components for campaigns. The original date-only fields are removed.
Генерация спроса
DemandGenMultiAssetAdInfo.lead_form_only	Никто	Удаление	The lead_form_only field has been removed. Update references in your code.
Отчеты
Aggregate asset performance label metrics and enum	Никто	Удаление	Removed aggregate asset performance label metrics. The performance label enum is no longer returned for Search and Display.

Features and updates (non-breaking)

Features and updates	Тип	Описание
Реклама
AdFormatType	New enum values	Added new format types: TEXT , VERTICAL_ADS_BOOKING_LINK , and VERTICAL_ADS_PROMOTION .
Ресурсы
asset_group view	New fields	Added the following metrics: metrics.engagements , metrics.engagement_rate , and metrics.average_cpe .
asset_group_asset view	New fields	Added the following metrics: metrics.average_cpe , metrics.average_cpm , metrics.trueview_average_cpv , metrics.video_trueview_view_rate , metrics.video_trueview_views , and metrics.interaction_event_types .
Asset.orientation	Новое поле	Read-only orientation field added to image and video assets.
CampaignAsset	Новая функция	Added support to retrieve campaign assets with field_type set to HEADLINE and DESCRIPTION .
ServedAssetFieldType	New enum values	Added HEADLINE_AS_SITELINK_POSITION_ONE , HEADLINE_AS_SITELINK_POSITION_TWO , DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE , and DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO for assets served as sitelinks.
BusinessMessageAsset	New features / support	Updated Business Message assets: Added support for Facebook Messenger and Zalo as providers. Added FACEBOOK_MESSENGER and ZALO to BusinessMessageProvider . Added fields facebook_messenger_info and zalo_info . Added CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS to AssetError .
Выставление счетов
InvoiceService.ListInvoices	New options	Can now return more granular details in Invoice , including campaign-level cost breakdown, itemized regulatory costs, and adjustment information, by setting include_granular_level_invoice_details in ListInvoicesRequest .
RegulatoryFeeType UnitOfMeasure	New enums	Added helper enums for regulatory fees and units of measure.
Кампании
CampaignError	New enum values / errors	Added DURATION_TOO_LONG_FOR_TOTAL_BUDGET and END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET error codes.
Конверсии
ConversionActionCategory	New enum value	Added YOUTUBE_FOLLOW_ON_VIEWS to support tracking users who watch an ad and later watch a video from the same channel.
Генерация спроса
DemandGenVideoResponsiveAdInfo.companion_banner	Новое поле	Added support for companion banners in Demand Gen responsive video ads.
Стимулы
Added Choose Your Own (CYO) incentives support: Added the FetchIncentive method to retrieve available personalized incentives for a user. Added the ApplyIncentive method to apply a selected incentive to a customer account. Added the AppliedIncentive resource (queryable using Search and SearchStream ) to provide redemption details. Added new error codes in IncentiveError and AuthenticationError.INVALID_EMAIL_ADDRESS . To facilitate more granular programmatic handling of failures, we will add additional error codes to IncentivesService in future releases. We recommend that you monitor upcoming announcements and release notes for these new error codes to make sure your applications can manage these new failure modes.
Планирование
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	New enum value	Allows building audiences using Life Events in GenerateAudienceCompositionInsights , GenerateSuggestedTargetingInsights , GenerateInsightsFinderReport , and GenerateCreatorInsights . Life Events are not supported for other AudienceInsightsService methods such as AudienceInsightsService.GenerateAudienceOverlap and AudienceInsightsService.GenerateTargetingSuggestionMetrics .
ReachPlanService.GenerateConversionRates	New fields / options	The response now includes surfaces to support conversion rate suggestions based on surface controls (eg, Gmail, Shorts). Only supported for Demand Gen campaigns.
LanguageDistribution	New field / type	Added to YouTubeChannelInsights to provide language distribution details in YouTube channel content.
BenchmarksService	Новая услуга	Compares YouTube advertisement data against industry benchmarks.
AudienceInsightsService.GenerateAudienceDefinition	New method	Translates a free text description of a target audience into matching audience attributes using generative AI.
YouTubeChannelInsights.relevance_score	Новое поле	Evaluates how relevant a creator is for a topic weighted by views.
TrendInsightMetrics.trend_change_percent	Новое поле	Represents the percentage change in a trend's value over the comparison period.
Рекомендации
GenerateRecommendationsRequest	Новое поле	Added is_new_customer . When set to true for CAMPAIGN_BUDGET recommendations, it uses a model optimized for new customers (only recommended for customers with no campaigns).
Отчеты
AdGroupAdAssetView	New feature / metrics support	Now supports impression, performance, and conversion metrics for RESPONSIVE_DISPLAY_AD .
ad_sub_network_type segment	New segment	Provides granular performance breakdown within an ad network. Initially available for Demand Gen campaigns on YouTube (In-stream, In-feed, Shorts). Must be selected along with ad_network_type .
Performance Max reporting	Новая функция	Enabled ad network type breakdown for Performance Max campaigns.
UserLocationView GeographicView	New segments support	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	Новое поле	Added to ShoppingProduct .
Vertical ads
AdGroup.vertical_ads_format_setting	Новое поле	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	Новое поле	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	New fields	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.
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.

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	Новое поле	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	Новое поле	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.

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

Начальное состояние	New state	Изменить тип	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	Новое поле	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	Новое поле	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).

Archived release notes

See Sunsetted versions for archived release notes.