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

Актуальный список текущих и запланированных прекращений поддержки функций приведен в разделе Прекращение поддержки функций. Сроки жизненного цикла версий указаны в расписании прекращения поддержки и отключения. В разделе Обновление версии API вы найдете таблицы различий между версиями proto с возможностью фильтрации.

Сводка выпуска и быстрые ссылки

В таблице ниже приведены ссылки на разделы с критическими изменениями, новыми функциями и таблицами различий в протоколах для каждого выпуска.

Версия	Дата выпуска	Критические изменения	Функции и обновления	Таблица различий в прототипах
v26.1 (последняя)	2026-10-28	Нет (незначительный выпуск)	Функции и обновления в версии 26.1	Различия между прототипами v25 и v26
v26	2026-10-14	Критические изменения в версии 26	Функции и обновления в версии 26	Различия между прототипами v25 и v26
v25.2	2026-09-23	Нет (незначительный выпуск)	Функции и обновления в версии 25.2	Различия между протоколами v24 и v25
v25.1	2026-08-19	Нет (незначительный выпуск)	Функции и обновления в версии 25.1	Различия между протоколами v24 и v25
v25	2026-07-22	Критические изменения в версии 25	Новые функции и обновления в версии 25	Различия между протоколами v24 и v25
v24.2	2026-06-24	Нет (незначительный выпуск)	Функции и обновления в версии 24.2	Различия между протоколами версий 23 и 24
v24.1	2026-05-13	Нет (незначительный выпуск)	Функции и обновления в версии 24.1	Различия между протоколами версий 23 и 24
v24	2026-04-22	Критические изменения в версии 24	Функции и обновления в версии 24	Различия между протоколами версий 23 и 24
v23.3	2026-06-24	Нет (незначительный выпуск)	Функции и обновления в версии 23.3	Различия между протоколами версий 22 и 23
v23.2	2026-03-25	Нет (незначительный выпуск)	Функции и обновления в версии 23.2	Различия между протоколами версий 22 и 23
v23.1	2026-02-25	Нет (незначительный выпуск)	Функции и обновления в версии 23.1	Различия между протоколами версий 22 и 23
v23	2026-01-28	Критические изменения в версии 23	Функции и обновления в версии 23	Различия между протоколами версий 22 и 23

Основные и промежуточные версии v26

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

Версия 26.1 (28.10.2026)

В Google Ads API версии 26.1 добавлены перечисленные ниже новые функции и обновления. Промежуточные версии, например v26.1, не содержат критических изменений.

Функции и обновления	Тип	Описание
Объекты
Отслеживание использования промоакций на внешних ресурсах	Новые сообщения, поля, перечисления и ошибки	Добавлено неизменяемое поле PromotionAsset.external_redeem_info типа ExternalRedeemInfo, в котором можно указать сведения для отслеживания внешних погашений промоакции: ExternalRedeemInfo.partner_promotion_id – неизменяемое сообщение ExternalPartnerId, которое содержит целочисленный (int_value) или строковый (string_value) идентификатор промоакции в системе партнера. Обязательно, если для поля code_source задано значение GOOGLE_GENERATED. ExternalRedeemInfo.code_type – обязательное и неизменяемое поле. Тип промокода для офлайн-покупок (OfflinePromotionCodeType: SINGLE_USE_PROMOTION_CODE или MULTI_USE_PROMOTION_CODE). ExternalRedeemInfo.code_source – обязательное и неизменяемое поле. Источник промокода для офлайн-покупок (OfflinePromotionCodeSource: CUSTOMER_UPLOADED или GOOGLE_GENERATED). Также добавлен код ошибки AssetError.PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE, который API возвращает, когда поле partner_promotion_id использует формат, не поддерживаемый интеграцией промоакций аккаунта.
Кампании
Приоритизация каналов и ограничения бюджетов кампаний в каскаде	Новые функции, ресурсы, сервисы, поля и перечисления	Добавлена поддержка каскадной приоритизации каналов и ограничений бюджета кампаний, что позволяет контролировать распределение бюджета между каналами сети (ресурсами, принадлежащими Google и управляемыми ею, сетью поисковых партнеров и контекстно-медийной сетью Google). Подробную информацию можно найти в записи блога о приоритизации каналов и распределении бюджета. Добавлено поле CampaignBudget.budget_network_settings типа BudgetNetworkSettings, которое содержит не более одного сообщения BudgetNetworkSetting для каждого типа рекламного канала (advertising_channel_type) в поле BudgetNetworkSettings.settings. Каждая настройка назначает каналы сети (NetworkChannelType: OWNED_AND_OPERATED, SEARCH_PARTNER и GOOGLE_DISPLAY) уровням приоритета (ChannelPriorityTier: TIER1 и TIER2) в поле BudgetNetworkSetting.channel_priorities (тип ChannelPriorityConfig). Настройка также может ограничивать долю бюджета, которую каналы сети вторичного уровня расходуют в поле BudgetNetworkSetting.budget_caps (тип BudgetCapConfig). Поле BudgetCapConfig.cap_percent_millis указывает ограничение в миллипроцентах (1,000 = 1%, 100,000 = 100%, а 0 = 0% – отказ). Если значение не задано, применяются настройки по умолчанию на уровне клиента в ресурсе CustomerBudgetNetworkSetting. Добавлено доступное только для чтения поле CampaignBudget.budget_network_eligibility типа BudgetNetworkEligibility, которое указывает, соответствует ли бюджет требованиям (eligible) для приоритезации каскада и ограничений бюджета, а если нет, то причины несоответствия (ineligible_reasons типа BudgetNetworkIneligibleReason). Добавлен ресурс CustomerBudgetNetworkSetting, который является синглтоном для каждого клиента с названием ресурса customers/{customer_id}/customerBudgetNetworkSettings. Поле budget_network_settings типа BudgetNetworkSettings содержит значения по умолчанию, которые применяются ко всем бюджетам кампаний, для которых не задано поле CampaignBudget.budget_network_settings. Добавлен сервис CustomerBudgetNetworkSettingService с методом CustomerBudgetNetworkSettingService.MutateCustomerBudgetNetworkSetting для создания или обновления настроек. Вы также можете изменить ресурс с помощью метода GoogleAdsService.Mutate и запросить его с помощью методов GoogleAdsService.Search и GoogleAdsService.SearchStream. Добавлено перечисление BudgetNetworkSettingError, которое возвращает API, если настройки размещения бюджета недействительны.
Ошибка активации преобразованной кампании для создания спроса	Новое перечисление и ошибка	Добавлено перечисление DemandGenCampaignError с кодом ошибки DemandGenCampaignError.CANNOT_ACTIVATE_MIGRATED_CAMPAIGN. API возвращает эту ошибку, если вы пытаетесь активировать перенесенную кампанию для создания спроса, не удалив исходную, или если активна другая перенесенная кампания, созданная на основе той же исходной.
Общие
Информация о соответствии требованиям для Рекламы местных услуг по категориям и услугам	Новый сервис, сообщения и поля	Добавлен сервис LocalServicesEligibilityService с методом LocalServicesEligibilityService.CheckLocalServicesEligibility, позволяющий проверить, соответствует ли клиент и идентификатор профиля компании в Google (CheckLocalServicesEligibilityRequest) требованиям для показа Рекламы местных услуг. Сообщение CheckLocalServicesEligibilityResponse возвращает: eligible: указывает, может ли клиент использовать Местные услуги. eligible_goals (тип EligibleGoal) – сопоставляет каждый доступный тип лида (EligibleGoal.lead_type) с доступными категориями услуг (EligibleGoal.categories типа EligibleCategory), включая идентификатор каждой категории (category_id), отображаемое название (display_name), доступные идентификаторы типов заданий (job_types) и идентификаторы уточнений (callouts). suggestion_reasons (тип SuggestionReason): содержит краткое и подробное текстовое объяснение (short_text и long_text) причин, по которым товар не соответствует требованиям (например, из-за проблем с лицензированием).
Настройки внешнего поставщика услуг по погашению для Местных услуг	Обновленное поле, новые сообщения и новые поля	Поле Customer.local_services_settings изменено с OUTPUT_ONLY на изменяемое. Также добавлено поле LocalServicesSettings.redemption_provider_info типа RedemptionProviderInfo для настройки внешнего поставщика услуг по погашению для аккаунта Местных услуг. Это сообщение содержит обязательное поле RedemptionProviderInfo.external_merchant_id типа ExternalPartnerMerchantId, в котором хранится идентификатор продавца – целое число (numeric_id) или строка длиной от 1 до 50 символов (alphanumeric_id).
Рекомендации
Рекомендация "Оптимизируйте кампании для привлечения новых клиентов"	Новая рекомендация	Добавлено значение перечисления RecommendationType.OPTIMIZE_FOR_NEW_CUSTOMERS и следующие поля для поддержки оптимизации кампаний по привлечению новых клиентов (с дополнительной ценностью конверсий, выраженной в стандартных единицах местной валюты аккаунта, а не в микроединицах): Recommendation.optimize_for_new_customers_recommendation (тип OptimizeForNewCustomersRecommendation): предоставляет поле recommended_incremental_conversion_value. ApplyRecommendationOperation.optimize_for_new_customers (тип OptimizeForNewCustomersParameters): принимает поля account_default_incremental_conversion_value и campaign_override_incremental_conversion_value, когда вы применяете рекомендацию.
Отчеты
Сегменты частоты показа в отчетах об охвате и информация о состоянии показателей	Новые показатели, сообщение и перечисление	В сообщение Metrics добавлены следующие показатели, которые дополняют набор сегментов частоты N+ (от 1+ до 10+) для отчетов об охвате: Metrics.unique_users_six_plus Metrics.unique_users_seven_plus Metrics.unique_users_eight_plus Metrics.unique_users_nine_plus В сообщение Metrics также добавлены следующие показатели ReachMetricInfo, которые предоставляют дополнительную информацию о состоянии (поле ReachMetricInfo.reach_metric_states типа ReachMetricState, например когда значение скрыто из соображений конфиденциальности или качества) для каждого показателя уникальных пользователей: Metrics.unique_users_info Metrics.unique_users_two_plus_info Metrics.unique_users_three_plus_info Metrics.unique_users_four_plus_info Metrics.unique_users_five_plus_info Metrics.unique_users_six_plus_info Metrics.unique_users_seven_plus_info Metrics.unique_users_eight_plus_info Metrics.unique_users_nine_plus_info Metrics.unique_users_ten_plus_info
Поддержка процента полученных показов в верхней части страницы и процента полученных кликов в поисковой сети для сегментов маршрутов бронирования гостиниц и вертикальных объявлений	Обновленные показатели и сегменты	Расширена поддержка показателей Metrics.search_top_impression_share и Metrics.search_click_share, чтобы вы могли выбирать их со следующими сегментами маршрутов бронирования гостиниц и вертикальных объявлений: Segments.advance_booking_window Segments.length_of_booking Segments.start_date Segments.start_day_of_week Segments.user_set_dates Segments.vertical_ads_event_participant_display_names Segments.vertical_ads_hotel_class Segments.vertical_ads_listing Segments.vertical_ads_listing_brand Segments.vertical_ads_listing_city Segments.vertical_ads_listing_country Segments.vertical_ads_listing_region Segments.vertical_ads_listing_user_rating Segments.vertical_ads_listing_venue Segments.vertical_ads_partner_account Segments.vertical_ads_price_tier Segments.vertical_ads_rate_rule_id Segments.vertical_ads_rate_type Segments.vertical_ads_vertical
Таргетинг
Исключение семейных доходов в кампаниях с максимальной эффективностью	Расширенная поддержка	Добавлена поддержка исключений по семейному доходу в кампаниях с максимальной эффективностью. Чтобы исключить диапазоны семейного дохода, создайте ресурс CampaignCriterion с заданным полем income_range.

Версия 26 (14.10.2026)

В Google Ads API версии 26, которая является основной, добавлены перечисленные ниже новые функции, обновления и критические изменения.

Подробнее о том, как перейти на последнюю версию…

Критические изменения

Начальное состояние	Новое состояние	Тип изменения	Советы по размещению рекламы
Кампании
Необязательное поле country_code в LocalServicesPmaxCampaignSettings	Обязательное поле при создании кампании с максимальной эффективностью для Местных услуг (LocalServicesPmaxCampaignSettings.country_code).	Изменение поведения	При создании кампаний с максимальной эффективностью для местных услуг обязательно укажите country_code (вместе с новым обязательным полем listing_id).
Конверсии
Поле enhanced_conversions_for_leads_enabled в ConversionTrackingSetting (Customer.conversion_tracking_setting)	Нет	Рубка	ConversionTrackingSetting.enablement_setting в Customer.conversion_tracking_setting, чтобы проверить настройки расширенного отслеживания конверсий на уровне аккаунта.
Таргетинг
Поля критериев для гостиниц в AdGroupBidModifier: hotel_date_selection_type hotel_advance_booking_window hotel_length_of_stay (min_nights и max_nights) hotel_check_in_day hotel_check_in_date_range	Поля критериев, не зависящие от вертикали, в AdGroupBidModifier: user_set_dates типа UserSetDatesInfo advance_booking_window типа AdvanceBookingWindowInfo length_of_booking типа LengthOfBookingInfo (min_days и max_days) start_day_of_week типа StartDayOfWeekInfo start_date_range типа StartDateRangeInfo	Переименование или удаление	Обновите ссылки, чтобы использовать поля критериев, не зависящие от вертикали. Они по-прежнему поддерживаются только для рекламы отелей в кампаниях для гостиниц и поисковых кампаниях для туризма. Идентификаторы критериев, поведение таргетинга и существующие модификаторы ставок остаются прежними, а значения min_nights и max_nights переносятся в min_days и max_days без конверсии. Подробнее о том, как корректировать ставки с помощью модификаторов…
HotelDateSelectionType и тип segments.user_set_dates	DateSelectionType	Переименование или изменение типа	Используйте DateSelectionType вместо HotelDateSelectionType для модификаторов ставок user_set_dates и segments.user_set_dates.
Причины ошибок, связанных с гостиницами, в CriterionError: HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE HOTEL_CHECK_IN_DATE_RANGE_REVERSED	Причины ошибок, не зависящие от отрасли, в CriterionError: LENGTH_OF_BOOKING_OVERLAPS_WITH_EXISTING_CRITERION ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_START_DATE_TOO_EARLY START_DATE_RANGE_END_DATE_TOO_LATE START_DATE_RANGE_REVERSED	Переименовать	Обновите обработку ошибок, чтобы проверять новые причины ошибок, не зависящие от вертикали.

Функции и обновления (некритические)

Функции и обновления	Тип	Описание
Объекты
Поставщики услуг по отправке сообщений в LINE и SMS	Новые поля и значения перечисления	В BusinessMessageAsset добавлена поддержка LINE и SMS в качестве поставщиков сообщений, включая новые поля BusinessMessageAsset.line_info и BusinessMessageAsset.sms_info, а также BusinessMessageProvider.LINE и BusinessMessageProvider.SMS.
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY	Новое перечисляемое значение/ошибка	Добавлено в AssetGroupError, чтобы указывать, когда категория, заданная в GoogleLocalServicesInfo (AssetGroup.google_local_services_info), не поддерживается в кампаниях с максимальной эффективностью для Местных услуг.
Кампании
Создание кампании с максимальной эффективностью для местных услуг	Новые функции, поля и ошибка	Обновлен PmaxCampaignSettings.local_services_enabled с OUTPUT_ONLY до IMMUTABLE, что позволяет внешним API-клиентам указывать local_services_enabled = true при создании новых кампаний с максимальной эффективностью для Местных услуг. Также добавлено поле LocalServicesPmaxCampaignSettings.listing_id, которое позволяет показывать идентификатор профиля компании в Google, связанного с кампанией с максимальной эффективностью для местных услуг (обязательно при создании кампании с максимальной эффективностью для местных услуг), и код ошибки CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID.
Ошибки проверки кампании "Реклама местных услуг"	Новые значения перечислений и ошибки	Добавлены новые ошибки проверки для кампаний "Реклама местных услуг": CampaignError: LOCAL_SERVICES_MULTIPLE_PERFORMANCE_MAX_CAMPAIGNS_NOT_ALLOWED LOCAL_SERVICES_AGREEMENT_REQUIRED AssetSetLinkError: LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID CampaignConversionGoalError и CampaignGoalConfigError: CANNOT_UNLINK_LOCAL_SERVICES_GOAL_FROM_LOCAL_SERVICES_CAMPAIGN GOAL_NOT_ALLOWED_FOR_LOCAL_SERVICES_CAMPAIGN LOCAL_SERVICES_GOAL_NOT_ALLOWED_FOR_NON_LOCAL_SERVICES_CAMPAIGN ConversionGoalCampaignConfigError: CANNOT_DISABLE_CAMPAIGN_OVERRIDE_GOALS_FOR_LOCAL_SERVICES_CAMPAIGN
Проверка связи с аккаунтом Hotel Center	Новое перечисляемое значение/ошибка	В CampaignError добавлен код ошибки CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED, который указывает, что для связывания набора объектов гостиницы (Campaign.hotel_property_asset_set) с кампанией с максимальной эффективностью для целей туризма требуется активная связь с аккаунтом Hotel Center.
Минимальный дневной бюджет кампании для создания спроса	Новое поле	В CurrencyConstant добавлено поле demand_gen_info.minimum_budget_per_day_micros, в котором указывается минимальный дневной бюджет для кампаний для создания спроса в этой валюте. Значение этого поля обновляется, когда меняется минимальный бюджет, установленный API.
Конфигурация измерения роста для кампаний	Новое поле	Добавлено поле Campaign.lift_measurement_config, в котором указывается название ресурса конфигурации оценки роста, связанной с кампанией.
Проверка эксперимента в кампании AI Max	Новое перечисляемое значение/ошибка	В ExperimentArmError добавлен код ошибки ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED, которая возникает при попытке создать эксперимент ADOPT_AI_MAX для кампании, в которой уже включены функции AI Max (или они включены в том же запросе до создания группы эксперимента).
Тип объявления в торговой кампании	Расширенная поддержка	Расширенная поддержка Campaign.listing_type для торговых кампаний.
Обновление правил в отношении самостоятельного декларирования политической рекламы в ЕС	Изменения в работе и новые поля	Campaign.contains_eu_political_advertising теперь необязателен для некоторых кампаний, в которых не настроен таргетинг на Европейский союз. За исключением кампаний DEMAND_GEN с обновленным таргетингом, это поле необязательно, если после выполнения запроса кампания соответствует всем следующим условиям: Не содержит критерия кампании с положительным местоположением в ЕС. Не содержит положительного критерия кампании для группы адресов или целевой области в радиусе. Содержит хотя бы один положительный критерий кампании по местоположению за пределами ЕС. Для кампаний типа DEMAND_GEN с upgraded_targeting это поле необязательно, если после выполнения запроса каждая активная группа объявлений в кампании соответствует всем следующим условиям: Не содержит критериев группы объявлений с положительным таргетингом на местоположение в ЕС Не содержит критериев группы объявлений с положительным радиусом или группой адресов. Содержит хотя бы один положительный критерий группы объявлений по местоположению за пределами ЕС. Это поле также необязательно для кампаний без активных групп объявлений. Если в результате запроса создается группа объявлений, не соответствующая этим условиям, возвращается ошибка AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION. Эти изменения коснутся как новых, так и существующих кампаний. В некоторых случаях новую кампанию можно создать, только если в том же запросе добавлены критерии. Для группировки изменений используйте GoogleAdsService.Mutate. Обновлен Campaign.missing_eu_political_advertising_declaration в соответствии с изменениями в Campaign.contains_eu_political_advertising. Добавлено поле GeoTargetConstant.require_eu_political_advertising_declaration, которое указывает, находится ли местоположение в ЕС. Добавлены CampaignCriterion.require_eu_political_advertising_declaration и AdGroupCriterion.require_eu_political_advertising_declaration. Поле Campaign.contains_eu_political_advertising обязательно, если поле true задано для любого критерия на уровне кампании (или для любого активного критерия на уровне группы объявлений в кампаниях DEMAND_GEN с улучшенным таргетингом). Поля возвращают true, если поле negative критерия имеет значение false, а критерий – это местоположение в ЕС, близость (независимо от того, пересекается ли она с территорией ЕС) или группа адресов (независимо от того, пересекается ли она с территорией ЕС).
Конверсии
Единая конфигурация расширенного отслеживания конверсий	Новые поля и перечисление	Добавлены поля ConversionTrackingSetting.enablement_setting и ConversionTrackingSetting.effective_enablement_setting (в Customer.conversion_tracking_setting), чтобы показывать унифицированную конфигурацию расширенного отслеживания конверсий для аккаунта, представленную с помощью нового перечисления EnhancedConversionsConfig.
ConversionActionCategory.MESSAGE_LEAD	Новое перечисляемое значение	Добавлено в ConversionActionCategory для поддержки сообщений или чатов, указывающих на интерес к предложению рекламодателя.
ConversionAttributionEventType.CLICK	Новое перечисляемое значение	Добавлено в ConversionAttributionEventType для представления конверсий, связанных с кликом по объявлению, которые ранее были включены в значение перечисления UNKNOWN.
Общие
Обновления лидов в Местных услугах	Новое поле и значение enum	В ресурс LocalServicesLead добавлено поле LocalServicesLead.campaign, позволяющее связать лид с кампанией. Добавлено поле COUPON в LocalServicesLeadType для поддержки типов лидов с купонами в Рекламе местных услуг.
Рекомендации
Рекомендация по увеличению бюджета для кампаний в поисковой сети	Новая рекомендация	Добавлены RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation и ApplyRecommendationOperation.raise_budget_performance_too_low для поддержки увеличения бюджетов, когда дневные бюджеты слишком низкие для поисковых кампаний.
Отчеты
Измерения эффективности на основе поисковых запросов	Новые функции, ресурсы, сегменты и показатели	Добавлена поддержка показателей эффективности на основе поисковых запросов: Добавлен новый ресурс только для чтения SearchLiftKeywordBundle, представляющий набор ключевых слов в исследовании эффективности на основе поисковых запросов. Добавлены новые сегменты (segments.search_lift_keyword_bundle и segments.search_property) и 15 новых показателей Search Lift (например, relative_search_lift, normalized_incremental_searches, search_lift_cost_micros и search_lift_impressions) для поддержки анализа Search Lift с помощью LiftMeasurementConfig (связанного с кампаниями, в которых используется Campaign.lift_measurement_config). Добавлены перечисления SearchLiftKeywordBundleStatus, SearchLiftMatchingInfoSource и SearchLiftSearchProperty.
Просмотр объектов дополнения конечного URL для торговых кампаний	Расширенная поддержка	Расширен ресурс final_url_expansion_asset_view для поддержки торговых кампаний (с возможностью выбора ad_group в качестве атрибутированного ресурса наряду с final_url_expansion_asset_view.ad_group).
Видео
Сообщения о контенте, созданном генеративным ИИ, на YouTube	Новые поля и перечисление	Добавлена поддержка раскрытия информации о контенте, созданном генеративным ИИ, для загрузок на YouTube. В YouTubeVideoUpload добавлено новое поле YouTubeVideoUpload.video_content_metadata типа VideoContentMetadata, содержащее настройки раскрытия информации в VideoContentMetadata.generative_content_disclosure типа YouTubeVideoUploadGenerativeContentDisclosure.

Основные и промежуточные версии v25

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

Версия 25.2 (23.09.2026)

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

Функции и обновления	Тип	Описание
Объекты
Параметры URL для аккаунта "AssetGroup"	Новые поля	Добавлена поддержка параметров URL в AssetGroup, что позволяет рекламодателям указывать шаблоны отслеживания, специальные параметры и суффиксы конечных URL на уровне группы объектов: AssetGroup.tracking_url_template – шаблон URL для создания URL отслеживания. AssetGroup.url_custom_parameters – список сопоставлений, которые будут использоваться для замены тегов специальных параметров URL в tracking_url_template, final_urls или final_mobile_urls. AssetGroup.final_url_suffix – шаблон URL для добавления параметров к URL целевых страниц, которые показываются при параллельном отслеживании.
Кампании
Информация об автоматическом сканировании видео	Новые поля и перечисления	В Campaign.AssetAutomationSetting добавлено поле AutomatedVideoCrawlSetting, а также AssetAutomationType.AUTOMATED_VIDEO_CRAWL, что позволяет задавать настройки автоматического сканирования видео для кампании с максимальной эффективностью. AutomatedVideoCrawlSetting.automated_video_crawl_infos содержит список записей AutomatedVideoCrawlInfo, каждая из которых настраивает сканирование url, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL или YOUTUBE) и статус согласия enabled.
Ошибки множителя ценности при оптимизации жизненного цикла клиента	Новые значения перечислений и ошибки	Добавлены новые причины ошибок валидации при настройке множителей ценности (value_multiplier и high_lifetime_value_multiplier) для оптимизации жизненного цикла клиентов: GoalError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CampaignGoalConfigError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE
SmartCampaignSettingService.GeneratePMaxDraftCampaign	Новинка	Добавлено поле SmartCampaignSettingService.GeneratePMaxDraftCampaign, которое позволяет создавать проект кампании с максимальной эффективностью на основе существующей умной кампании. Проект инициализируется со статусом CampaignStatus.PAUSED и статусом создания CampaignCreationStatus.INCOMPLETE (см. раздел Преобразование умных кампаний в кампании с максимальной эффективностью): Задайте для параметра GeneratePMaxDraftCampaignRequest.validate_only значение true, чтобы проверить конверсию и получить предупреждения или сообщения о проблемах в GeneratePMaxDraftCampaignResponse.validated_info, не создавая проект кампании. Оставьте поля gbp_enabled и image_enabled незаполненными или укажите для них значение false. Значение true пока не поддерживается и возвращает ошибку SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED или SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED. GeneratePMaxDraftCampaignResponse возвращает названия ресурсов созданных объектов (pmax_campaign, campaign_budget, asset_group и assets) вместе с validated_info.
Конверсии
Показы объявлений Firebase	Новые типы и категория действий-конверсий	Добавлены типы действий-конверсий FIREBASE_ANDROID_APP_AD_IMPRESSION и FIREBASE_IOS_APP_AD_IMPRESSION, что позволяет получать и изменять эти действия-конверсии. Также в ConversionActionCategory добавлена категория IN_APP_AD_REVENUE, которая позволяет отслеживать доход от монетизации рекламы в приложении.
Общие
BusinessProfileLocationSyncError	Новые перечисления и ошибки	Добавлены причины ошибок синхронизации адресов из профиля компании при синхронизации адресов в AssetSet типа LOCATION_SYNC. Вместо общей ошибки UNKNOWN API теперь возвращает BusinessProfileLocationSyncError с указанием конкретных причин (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED и NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT).
Планирование
Показатели процентилей BenchmarksService.GenerateBenchmarksMetrics	Новые функции	Обновлен ресурс BenchmarksService.GenerateBenchmarksMetrics. Теперь он предоставляет показатели, отражающие конкурентную позицию клиента среди других рекламодателей в формате процентилей. Показатели возвращаются в PercentileMetrics в новом поле CustomerMetrics.percentile_metrics (как в GenerateBenchmarksMetricsResponse.customer_metrics, так и в BreakdownMetrics.customer_metrics) и представлены с помощью BenchmarksCustomerPercentileTier. Поле CustomerMetrics.percentile_metrics заполняется, только если в GenerateBenchmarksMetricsRequest выполняются оба следующих условия: PERCENTILE_DATA запрашивается в supplemental_data. Для свойства BenchmarksSource.all_advertisers задано значение benchmarks_source (в этом случае также необходимо указать свойство category_filter). Добавлена поддержка показателей процентиля для дат открытого квартала в ListBenchmarksAvailableDatesResponse.supported_dates (возвращается BenchmarksService.ListBenchmarksAvailableDates). Хотя агрегированные показатели клиентов (CustomerMetrics.aggregate_metrics), показатели коэффициентов клиентов (CustomerMetrics.average_rate_metrics) и показатели процентиля клиентов (CustomerMetrics.percentile_metrics) поддерживаются для всех дат в supported_dates (включая открытые кварталы), показатели доли клиентов (CustomerMetrics.share_metrics) и показатели коэффициентов источника контрольных показателей (average_benchmarks_metrics, например average_cpm объявлений в категории "Одежда") не поддерживаются для открытых кварталов и исключаются из ответа, если только запрашиваемый date_range не попадает в более узкий диапазон ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics. Добавлена специальная ошибка BenchmarksError.NO_METRICS_FOUND, которая указывает, что для выбранной комбинации входных данных не найдены показатели. Это сделано для удобства использования.
Псевдонимы каналов YouTube для статистики авторов	Новинка	ContentCreatorInsightsService.GenerateCreatorInsights теперь поддерживает поиск по псевдонимам каналов YouTube с помощью YouTubeChannels.youtube_channel_handles (действительные псевдонимы каналов должны начинаться с @, например @channel_handle). Этот вариант аналогичен поиску по идентификаторам каналов YouTube. В ответе будет статистика по запрошенным авторам YouTube.
Рекомендации
Рекомендации по ставкам на основе цены за конверсию и рентабельности инвестиций в рекламу	Новые рекомендации	Добавлены Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) и Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW), а также ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low и ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low, чтобы повышать целевую цену за конверсию или снижать целевую рентабельность инвестиций в рекламу, когда ставки слишком низкие для участия поисковых кампаний в аукционах: RaiseTargetCpaPerformanceBidTooLowRecommendation предоставляет recommended_target_multiplier (коэффициент больше 1.0) и current_average_target_cpa_micros. Примените его с помощью RaiseTargetCpaPerformanceBidTooLowParameters с target_cpa_multiplier. LowerTargetRoasPerformanceBidTooLowRecommendation предоставляет recommended_target_multiplier (коэффициент меньше 1.0) и current_average_target_roas. Примените его с помощью LowerTargetRoasPerformanceBidTooLowParameters с target_roas_multiplier.
Отчеты
Сегменты по параметрам маршрутов гостиниц	Новые сегменты	В Segments добавлены следующие сегменты параметров маршрута бронирования отелей и путешествий (доступны для выбора с campaign, ad_group и customer): Segments.advance_booking_window – сроки предварительного бронирования для программы пребывания (в днях). Segments.length_of_booking – продолжительность бронирования в днях. Segments.start_date – дата начала бронирования в формате yyyy-MM-dd. Segments.start_day_of_week – день недели, в который начинается бронирование (DayOfWeek). Segments.user_set_dates – указывает, были ли выбраны даты, указанные пользователем (HotelDateSelectionType).
Показатели вертикальных объявлений	Новые показатели	В отчеты о рекламе гостиниц и путешествий (Metrics) добавлены следующие показатели, которые можно выбрать с помощью campaign, ad_group и customer: Metrics.vertical_ads_average_booking_value_micros – средняя суточная стоимость бронирования гостиницы в микроединицах валюты, взвешенная по кликам, включая налоги и сборы, за всю длительность пребывания. Metrics.vertical_ads_potential_impressions – общее количество доступных показов с ограничением частоты, которые могут быть выполнены в контексте запроса. Metrics.vertical_ads_price_difference_percentage – разница в процентах между ценой, предложенной рекламодателем, и самой низкой ценой конкурента для того же объекта.
Сегменты вертикальных объявлений	Новые сегменты	В Segments добавлены следующие сегменты для отчетов о рекламе гостиниц и путешествий (их можно выбрать с помощью campaign, ad_group и customer): Segments.vertical_ads_price_tier – ценовой уровень рекламодателя (HotelPriceBucket) по сравнению с конкурентами на аукционе. Segments.vertical_ads_rate_rule_id – идентификатор правила назначения цен, связанный с правилом назначения цен рекламодателя. Segments.vertical_ads_rate_type – тип тарифа (HotelRateType) при бронировании гостиницы.

Версия 25.1 (19.08.2026)

В Google Ads API версии 25.1 добавлены перечисленные ниже новые функции и обновления. Промежуточные версии, например 25.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. Добавлены новые сегменты и показатели для поддержки анализа Brand Lift с помощью LiftMeasurementConfig и новых ресурсов параметров. Добавлены следующие перечисления: BrandLiftMeasurementType, LiftMeasurementFlightStatus, SurveyIntendedAction, SurveyLiftFlightTargetResponseMode и SurveySubjectType.
Измерения Conversion Lift	Новые функции	Добавлена поддержка показателей роста конверсий со следующими обновлениями: Добавлен новый ресурс только для чтения LiftMeasurementConfig, представляющий исследование роста. Добавлены новые сегменты, которые можно выбирать для сегментирования и фильтрации результатов продвижения. Добавлены 24 новых показателя Conversion Lift и оценки победителей, которые позволяют проводить подробный статистический анализ эффективности роста. Добавлена поддержка получения сведений о кампаниях и целях конверсий. Добавлено новое необязательное поле Experiment.lift_measurement_config. Добавлено перечисление ConversionLiftIncludedConversionActionTypes.
LiftMeasurementFlight	Новый ресурс	Новый ресурс только для чтения, представляющий сведения о периоде трансляции для конфигурации измерения роста, включая даты начала и окончания измеренного периода трансляции (start_date и end_date).
Общие
SmartCampaignError	Новые значения перечисления	Добавлены новые коды ошибок для ограничений генерации в кампаниях с максимальной эффективностью: 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. В перечисление ContentCreatorInsightsSupplementalData добавлено значение BRAND_SENTIMENT_DATA. В перечисление InsightsKnowledgeGraphEntityCapabilities добавлено значение BRAND.
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.

Версия 25 (22.07.2026)

В 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.
Общие
Вложенные поля перечисления в сообщениях запроса и ответа Incentive Service: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	Отдельные поля перечисления: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	Переименование или удаление	Используйте новые отдельные поля перечисления вместо устаревших полей type.
Необязательные поля selected_incentive_id и customer_id в ApplyIncentiveRequest	Обязательные поля	Изменение поведения	При вызове 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. Если функция включена, она генерирует анимированные изображения на основе неанимированных. Начиная с этой версии API новые DemandGenMultiAssetAds включены по умолчанию.
Изменяемость информации о синтетическом контенте	Изменение поведения	Asset.synthetic_content_info и Ad.synthetic_content_info теперь полностью изменяемы в версиях 25, 24 и 23.
Кампании
Цель "Удержание клиентов"	Новые функции и настройки	Добавлена поддержка цели "Удержание участников программы лояльности", которая позволяет рекламодателям оптимизировать кампании для удержания участников программы лояльности. В перечисление GoalType добавлено значение LOYALTY_RETENTION. Добавлен параметр CampaignGoalConfig.campaign_loyalty_retention_settings, позволяющий настраивать удержание клиентов в рамках программы лояльности на уровне кампании, в том числе корректировки ставок и показ преимуществ для участников в товарных объявлениях. Добавлен метод Goal.loyalty_retention_goal_settings для настройки цели удержания клиентов на уровне аккаунта. Добавлены новые коды ошибок: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
Цель "Привлечение новых клиентов"	Новые функции и настройки	Обновлена поддержка цели "Привлечение новых клиентов" в Google Ads API в соответствии с обновленной схемой унифицированных целей: Расширен ресурс 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	Новый сегмент	Разбивка объявлений In-Stream без возможности пропуска на YouTube по продолжительности: INSTREAM_NON_SKIPPABLE_STANDARD (объявление In-Stream без возможности пропуска стандартной длительности) INSTREAM_NON_SKIPPABLE_MAX30_SEC (объявление In-Stream без возможности пропуска длительностью не более 30,99 секунды) INSTREAM_NON_SKIPPABLE_MAX60_SEC (объявление In-Stream без возможности пропуска длительностью не более 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

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

Версия 24.2 (24.06.2026)

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

Функции и обновления	Тип	Описание
Реклама
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	Новое перечисляемое значение	Генерирует текстовую информацию с целевой страницы, которая будет показываться на панели взаимодействия для экземпляров DemandGenVideoResponsiveAd (которые включены по умолчанию, начиная с этой версии API).
Объекты
AssetGroup.google_local_services_info	Новое поле	Добавлена поддержка информации о рекламе местных услуг (идентификатор категории и уточнения) в кампаниях с максимальной эффективностью.
AssetGroupSignal.local_services_id	Новое поле	Добавлено для поддержки сигналов идентификаторов сервисов Рекламы местных услуг в кампаниях с максимальной эффективностью.
AssetGroupSignal.vertical_ads_item_group_rule_list	Новое поле	Добавлено для поддержки правил групп позиций вертикальных объявлений, чтобы выбирать позиции из прикрепленных вертикальных фидов в кампаниях с максимальной эффективностью. Эта функция доступна только для аккаунтов из белого списка.
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 Карты включены в список каналов, которые можно выбрать для групп объявлений для создания спроса.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	Новое перечисляемое значение/ошибка	Возвращается при попытке удалить все местоположения из кампании с максимальной эффективностью для местных услуг.
SmartCampaignErrorEnum.CREATION_FAILED	Новое перечисляемое значение/ошибка	Возвращается при попытке создать умную кампанию.
Конверсии
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	Новые значения перечисления	Конверсии, которые происходят, когда пользователь нажимает на рекламу местных услуг и звонит рекламодателю, отправляет ему сообщение или бронирует услугу.
Эксперименты
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	Новые значения перечисления	Добавлена поддержка новых типов ExperimentType: COMPARE_CAMPAIGNS – для экспериментов с миксами кампаний и собственных экспериментов в кампаниях с максимальной эффективностью, в которых сравнивается несколько кампаний одного или разных типов. 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 останутся неизменными. Если вы попытаетесь отправить запрос mutate для любого из этих полей, будет возвращена одна из следующих ошибок: "Поле, которое вы пытаетесь изменить, является неизменяемым" или "Не удалось задать значение поля". Эти поля станут полностью изменяемыми начиная с версии 25. Рекомендуем использовать интерфейс уже сейчас, чтобы создать и протестировать внутреннюю логику. Тогда ваша система будет готова к полноценной записи, когда выйдет версия 25.
Групповое одобрение	Новые функции	Бета-версия. Эта функция находится на стадии бета-тестирования и может быть изменена в будущих выпусках. Добавлена поддержка проверок группового одобрения (MPA): Добавлен ресурс MultiPartyAuthReview и соответствующий метод MultiPartyAuthReviewService. Добавлено перечисление MultiPartyAuthReviewStatus для отслеживания статуса проверки. Добавлен параметр CustomerUserAccess.pending_multi_party_auth_review для ссылки на ожидающий отзыв. Добавлены поля MutateCustomerUserAccessResult.multi_party_auth_review и MutateCustomerUserAccessInvitationResult.multi_party_auth_review, которые возвращают название ресурса связанного отзыва. Добавлено свойство MultiPartyAuthReviewError для ошибок проверки. Эта функция была перенесена в версии v23.3, v22.2 и v21.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	Новое поле	Если задано значение true, исключения брендов игнорируются для товарных объявлений. Поддерживается только для торговых кампаний.
Таргетинг
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	Новое перечисляемое значение/ошибка	Возвращается при попытке настроить таргетинг на недопустимый язык.
Видео
DataLink.youtube_link_metadata	Новое поле	Содержит brand_channel_id, чтобы указать идентификатор связанного канала бренда на YouTube.

Версия 24.1 (13.05.2026)

В Google Ads API версии 24.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 и ключевых слов с широким соответствием. ADOPT_BROAD_MATCH_KEYWORDS – для экспериментов, в которых проверяется, как ключевые слова с широким соответствием влияют на количество поисковых запросов, по которым показываются ваши объявления. OPTIMIZE_ASSETS – для собственных экспериментов по оптимизации объектов. PMAX_REPLACEMENT_SHOPPING – для экспериментов, в которых сравнивается эффективность торговых кампаний и кампаний с максимальной эффективностью.
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 – настройки кампаний с максимальной эффективностью в экспериментах 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, связанного с данными.

Версия 24 (22.04.2026)

В 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	Новое поле	Позволяет включить оптимизацию конверсий по показам (по умолчанию false) в кампаниях для создания спроса и кампаниях для приложений.
CampaignCriterion.gender	Новинка	В кампаниях с максимальной эффективностью во всех версиях 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	Новые поля	В ProductCoreAttributes в разделе ListPlannableProductsResponse добавлены описание планируемого продукта, маркетинговая цель, модель ценообразования и способ покупки.
Отчеты
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. В AssetGroupListingGroupFilter добавлен параметр RetailFilter. Добавлены новые ошибки проверки в CriterionError и AssetGroupListingGroupFilterError. Эта функция доступна только для аккаунтов из белого списка.

Основные и промежуточные версии v23

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

Версия 23.3 (24.06.2026)

В Google Ads API версии 23.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 останутся неизменными. Если вы попытаетесь отправить запрос mutate для любого из этих полей, будет возвращена одна из следующих ошибок: "Поле, которое вы пытаетесь изменить, является неизменяемым" или "Не удалось задать значение поля". Эти поля станут полностью изменяемыми начиная с версии 25. Рекомендуем использовать интерфейс уже сейчас, чтобы создать и протестировать внутреннюю логику. Тогда ваша система будет готова к полноценной записи, когда выйдет версия 25.
Групповое одобрение	Новые функции	Бета-версия. Эта функция находится на стадии бета-тестирования и может быть изменена в будущих выпусках. Добавлена поддержка проверок группового одобрения (MPA): Добавлен ресурс MultiPartyAuthReview и соответствующий метод MultiPartyAuthReviewService. Добавлено перечисление MultiPartyAuthReviewStatus для отслеживания статуса проверки. Добавлен параметр CustomerUserAccess.pending_multi_party_auth_review для ссылки на ожидающий отзыв. Добавлены поля MutateCustomerUserAccessResult.multi_party_auth_review и MutateCustomerUserAccessInvitationResult.multi_party_auth_review, которые возвращают название ресурса связанного отзыва. Добавлено свойство MultiPartyAuthReviewError для ошибок проверки.

Версия 23.2 (25.03.2026)

В Google Ads API версии 23.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 для стратегии "Максимум кликов" (цена за клик) в кампаниях для создания спроса в ReachPlanService.GenerateReachForecast.
partnership_opportunities	Новое поле	Добавлено в разделы ContentCreatorInsightsService.GenerateCreatorInsights и ContentCreatorInsightsService.GenerateTrendingInsights.
Отчеты
biddable_indirect_install_first_in_app_conversion_micros	Новое поле	Добавлено в ресурсы Campaign, Customer и AdGroup.
Видео
ShareablePreviewService	Новинка	Добавлена поддержка предварительного просмотра YouTube Live. Для этого нужно задать для параметра preview_type значение YOUTUBE_LIVE_PREVIEW. В список "ShareablePreviewError" добавлены UNSUPPORTED_AD_TYPE и TOO_MANY_RESOURCES_IN_REQUEST. Эта функция поддерживается только для некоторых типов объявлений.

Версия 23.1 (25.02.2026)

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

Функции и обновления	Тип	Описание
Управление аккаунтом
advertising_partner_properties.allowed_domain	Новое поле	Добавлено в ресурсы ProductLinkInvitation и ProductLink. Партнер по рекламе сможет размещать рекламу только в этом домене.
Customer.contains_eu_political_advertising	Новое поле	Получает статус заявления на уровне аккаунта о том, содержит ли он политическую рекламу с таргетингом на ЕС, и возвращает EuPoliticalAdvertisingStatus.
Кампании
Campaign.text_guidelines	Новое поле	Добавлена поддержка правил создания текстовых объектов, которые можно использовать в кампаниях с максимальной эффективностью и поисковых кампаниях, чтобы программно управлять текстовыми объектами, созданными искусственным интеллектом. Внутри 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	Новые поля	Добавлена информация о трендах за период с TrendInsightDataPoint по TrendInsights при поиске по теме.
Отчеты
Показатели частоты показов уникальным пользователям	Новые поля	Добавлены новые показатели, которые позволяют узнать, сколько пользователей видели ваше объявление не менее двух, трех, четырех, пяти или десяти раз: 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.

Версия 23 (28.01.2026)

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

Подробнее о том, как перейти на последнюю версию…

Критические изменения

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

Функции и обновления (некритические)

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

Архив примечаний к выпускам

Примечания к выпуску для устаревших версий можно найти в разделе Устаревшие версии.