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

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

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

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

Версия	Дата выпуска	Критические изменения	Функции и обновления	Таблица различий в прототипах
v26 (последняя)	2026-10-14	Критические изменения в версии 26	Функции и обновления в версии 26	Различия между протоколами версий 25 и 26
v25.2	2026-09-23	Нет (минорный выпуск)	Функции и обновления в версии 25.2	Различия между протоколами v24 и v25
v25.1	2026-08-19	Нет (минорный выпуск)	Функции и обновления в версии 25.1	Различия между протоколами версий 24 и 25
v25	2026-07-22	Критические изменения в версии 25	Функции и обновления в версии 25	Различия между протоколами версий 24 и 25
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

Основная версия 26

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

Версия 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	Переименование или удаление	Обновите ссылки, чтобы использовать поля критериев, не зависящие от вертикали. Это позволит настраивать таргетинг на разные вертикали в сфере туризма, а не только на гостиницы (например, на Things to do). Идентификаторы критериев, поведение таргетинга и существующие модификаторы ставок останутся прежними. Значения min_nights и max_nights переносятся в min_days и max_days без изменений.
HotelDateSelectionType и тип segments.user_set_dates	DateSelectionType	Переименование или изменение типа	Используйте DateSelectionType вместо HotelDateSelectionType.
Причины ошибок, связанных с гостиницами, в 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 добавлены перечисленные ниже функции и обновления. Промежуточные версии, например 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. Добавлены новые сегменты и показатели для поддержки анализа 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	Переименование или удаление	Используйте новые отдельные поля enum вместо устаревших полей 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.
Групповое одобрение	Новые функции	Бета-версия. Эта функция находится на стадии бета-тестирования и может быть изменена в будущих выпусках. Добавлена поддержка проверок группового одобрения: Добавлен ресурс 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 добавлены следующие новые функции и обновления. Промежуточные версии, например 24.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 добавлены перечисленные ниже новые функции и обновления. Промежуточные версии, например 23.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. Они позволяют узнать, было ли объявление слышно и для какого количества показов удалось определить слышимость.

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

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