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

Актуальный список функций, поддержка которых прекращена или будет прекращена, можно найти в статье Прекращение поддержки функций.

Основная версия 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: Переименование или удаление Обновите ссылки, чтобы использовать поля критериев, не зависящие от вертикали. Это позволит настраивать таргетинг на разные вертикали в сфере туризма, а не только на гостиницы (например, на 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: Переименовать Обновите обработку ошибок, чтобы проверять новые причины ошибок, не зависящие от вертикали.

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

Функции и обновления Тип Описание
Объекты
Поставщики услуг по отправке сообщений LINE и SMS Новые поля и значения перечисления Добавлена поддержка LINE и SMS в качестве поставщиков сообщений в BusinessMessageAsset, включая новые поля 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.

Ошибки проверки кампании Местных услуг Новые значения enum и ошибки Добавлены новые ошибки проверки для кампаний местных услуг:
Проверка связи с аккаунтом 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 Новое значение enum или ошибка Добавлен код ошибки ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED в ExperimentArmError при попытке создать эксперимент 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 Новое значение enum Добавлено в ConversionAttributionEventType для обозначения конверсий, связанных с кликом по объявлению, которые ранее были включены в значение перечисления UNKNOWN.
Общие
Обновления лидов в Местных услугах Новое поле и значение enum
Рекомендации
Рекомендация по увеличению бюджета для поисковой сети Новая рекомендация Добавлены RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation и ApplyRecommendationOperation.raise_budget_performance_too_low для поддержки увеличения бюджетов, когда дневные бюджеты слишком низкие для поисковых кампаний.
Отчеты
Измерения эффективности на основе поисковых запросов Новые функции, ресурсы, сегменты и показатели Добавлена поддержка исследований эффективности на основе поисковых запросов:
Представление объектов с дополнением конечного 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) для оптимизации жизненного цикла клиентов:
SmartCampaignSettingService.GeneratePMaxDraftCampaign Новинка Добавлено поле SmartCampaignSettingService.GeneratePMaxDraftCampaign, которое позволяет создать проект кампании с максимальной эффективностью на основе существующей умной кампании. Проект инициализируется со статусом CampaignStatus.PAUSED и статусом создания CampaignCreationStatus.INCOMPLETE (см. раздел Преобразование умных кампаний в кампании с максимальной эффективностью):
Конверсии
Показы объявлений 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 выполняются оба следующих условия:

Добавлена поддержка показателей процентиля для дат открытого квартала в 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, чтобы можно было повышать целевую цену за конверсию или снижать целевую рентабельность инвестиций в рекламу, когда ставки слишком низкие для участия поисковых кампаний в аукционах:
Отчеты
Сегменты по параметрам маршрутов гостиниц Новые сегменты В Segments добавлены следующие сегменты параметров маршрута бронирования отелей и путешествий (их можно выбрать с помощью campaign, ad_group и customer):
Показатели вертикальных объявлений Новые показатели В отчеты по рекламе гостиниц и туризма в 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):

Версия 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 Новые функции Добавлена поддержка исследований эффективности продвижения бренда со следующими изменениями:
Измерения Conversion Lift Новые функции Добавлена поддержка исследований роста конверсий. В связи с этим:
  • Добавлен новый ресурс только для чтения LiftMeasurementConfig, представляющий исследование роста.
  • Добавлены новые сегменты, которые можно выбирать для сегментирования и фильтрации результатов роста.
  • Добавлены 24 новых показателя роста конверсий и показателей оценки победителя, которые позволяют проводить подробный статистический анализ эффективности роста.
  • Добавлена поддержка получения сведений о кампаниях и целях конверсий.
  • Добавлено новое необязательное поле Experiment.lift_measurement_config.
  • Добавлен перечисляемый тип ConversionLiftIncludedConversionActionTypes.
LiftMeasurementFlight Новый ресурс Новый ресурс, доступный только для чтения, который содержит сведения о периоде трансляции рекламы для конфигурации измерения роста, включая даты начала и окончания периода (start_date и end_date).
Общие
SmartCampaignError Новые значения перечислений Добавлены новые коды ошибок для ограничений генерации в кампаниях с максимальной эффективностью:
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION Новое перечисляемое значение / ошибка Возвращается, когда облачный проект Google Cloud с уровнем доступа TEST пытается отправить запрос к аккаунту, не предназначенному для тестирования.
Планирование
Статистика отношения к бренду Новые функции Добавлена поддержка статистики по отношению к бренду в ContentCreatorInsightsService:
Улучшения 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 Рекламе 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) Нет Рубка Используйте обновленную схему единых целей:
Общие
Вложенные поля перечисления в сообщениях запроса и ответа Incentive Service:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.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.
Кампании
Цель "Удержание участников программы лояльности" Новые функции и настройки Добавлена поддержка цели удержания участников программы лояльности, которая позволяет рекламодателям оптимизировать кампании для удержания участников программы лояльности.
Цель "Привлечение новых клиентов" Новые функции и настройки В Google Рекламе API обновлена поддержка цели "Привлечение новых клиентов" в соответствии с новой единой схемой целей:
Конверсии
Сторонняя атрибуция конверсий на YouTube Новые поля Добавлена поддержка проверки атрибуции конверсий на YouTube с помощью сторонних партнеров: Подробнее об этом рассказывается в статье Справочного центра.
Общие
ContactDetails.phone_number_extension Новое поле Добавлено в ресурс LocalServicesLead.
IncentiveError Новые значения enum и ошибки Добавлены новые коды ошибок, связанных с проблемами при использовании бонусов:
  • BILLING_COUNTRY_NOT_ELIGIBLE (страна нахождения платежного адреса клиента не допущена для получения бонуса)
  • USER_IS_MCC_MANAGER (пользователь является управляющим аккаунтом и не может получить бонус)
  • USER_SUSPENDED (аккаунт клиента заблокирован)
  • MAX_PENDING_INCENTIVES (клиент достиг максимального количества ожидающих бонусов)
  • ACCOUNT_HAD_RECENT_SPEND (в аккаунте недавно были расходы, поэтому он не соответствует требованиям)
  • MAX_INCENTIVES_REDEEMED_FROM_OFFER (клиент уже получил максимальное количество бонусов по этому предложению)
  • MISMATCHING_BILLING_COUNTRY_CODE (код страны нахождения платежного адреса, указанный в запросе, не совпадает со страной аккаунта клиента)
Планирование
Информация о канале YouTube в статистике трендов Новые поля Добавлена поддержка дополнительных сведений о каналах YouTube с похожими видео при поиске статистики тенденций. В YouTubeVideoAttributeMetadata добавлены новые поля: channel_id, channel_name и channel_url.
YouTubeChannelInsights.data_sharing_consent_given Новое поле Добавлено в очередь экрана YouTubeChannelInsights. Это возможно, если автор дал согласие на передачу закрытых данных. Если да, то будут заполнены следующие поля:
Отчеты
ad_sub_format_type Новый сегмент Разбивка объявлений 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: Они доступны в 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 Новое значение enum Создает текстовую информацию на основе целевой страницы, которая будет показываться на панели взаимодействия для объектов 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 Новое значение enum или ошибка Возвращается при попытке удалить все группы объектов из кампании.
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.

Групповая авторизация Новые функции Добавлена поддержка проверок группового одобрения:
Эта функция была добавлена в более ранние версии API: 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 Новое значение enum или ошибка Возвращается при попытке настроить таргетинг на запрещенный язык.
Видео
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 Новое значение enum или ошибка Возвращается, когда запрошенный уровень детализации времени (по дням, часам или неделям) не поддерживается для диапазонов дат запроса (доступно только за последние 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 Новое значение enum или ошибка Возвращается при попытке исключить все демографические цели.
Видео
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR Новое значение enum Компания 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 Нет Рубка Удалены следующие поля и типы планов и прогнозов: Обновите интеграции.
Отчеты
сегмент ad_sub_network_type в campaign_budget Нет Рубка Удален сегмент ad_sub_network_type для ресурса campaign_budget.
click_type Сегмент в представлениях объектов Нет Рубка Удален сегмент из представлений AdGroupAsset, CampaignAsset и CustomerAsset.
Видео
Частичный сбой разрешен в ShareablePreviewService.GenerateShareablePreviews Частичный сбой не произошел Изменение поведения Если хотя бы один идентификатор не пройдет проверку, запрос не будет выполнен и появится сообщение об ошибке.
Устаревшие коды ShareablePreviewError: MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST
Переименование / изменение поведения Коды ошибок, возвращаемые для групп объектов, изменены в соответствии с ошибками объявлений в группах объявлений. Обновлена логика проверки.

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

Функции и обновления Тип Описание
Реклама
Изменяемость VideoResponsiveAdInfo Изменение поведения Объекты с информацией об адаптивных видеообъявлениях теперь можно изменять.
Объекты
travel_feed_data в зоне AssetSet Новое поле Добавлено для получения атрибутов объектов фида путешествий (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type).
Кампании
Campaign.view_through_conversion_optimization_enabled Новое поле Позволяет включить оптимизацию конверсий по показам (по умолчанию false) в кампаниях для создания спроса и для приложений.
CampaignCriterion.gender Новинка В кампаниях с максимальной эффективностью во всех версиях Google Ads API теперь можно исключать пол.
Конверсии
Типы конверсий для лидогенерации Новые значения перечисления Добавлены новые перечисления типов действий-конверсий GA4/Firebase в ConversionActionType:
  • GOOGLE_ANALYTICS_4_GENERATE_LEAD
  • GOOGLE_ANALYTICS_4_QUALIFY_LEAD
  • GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD
  • FIREBASE_ANDROID_GENERATE_LEAD
  • FIREBASE_ANDROID_QUALIFY_LEAD
  • FIREBASE_ANDROID_CLOSE_CONVERT_LEAD
  • FIREBASE_IOS_GENERATE_LEAD
  • FIREBASE_IOS_QUALIFY_LEAD
  • FIREBASE_IOS_CLOSE_CONVERT_LEAD
Общие
UserListErrorEnum.DUPLICATE_LOOKALIKE Новое перечисляемое значение / ошибка Возвращается при попытке создать несколько одинаковых похожих списков.
Планирование
ProductCoreAttributes полей в ListPlannableProductsResponse Новые поля В ProductCoreAttributes в разделе ListPlannableProductsResponse добавлены описание планируемого продукта, маркетинговая цель, модель расчета стоимости и способ покупки.
Отчеты
CartDataSalesView Новый ресурс для отчетов Отчеты, в которых показатели конверсий сегментируются по проданному товару (бренду и т. д.) в дополнение к товару, на который был нажат клик.
Показатели без назначения ставок Новые поля Добавлены показатели без назначения ставок (показывающие конверсии, для которых не выполняется оптимизация кампаний), во все соответствующие ресурсы:
conversion_attribution_event_type Новый сегмент Добавлено в очередь экрана ShoppingPerformanceView.
Покупки
Кампании для приложений в ShoppingProduct Новинка Поддерживаемые кампании для приложений в ресурсе ShoppingProduct. Статус примечания и проблемы не поддерживаются.
Фильтрация товаров на основе тегов Новинка Добавлена динамическая фильтрация с использованием логических выражений: Эта функция доступна только для аккаунтов из белого списка.

Основные и промежуточные версии 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):

Версия 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 Новое значение enum Добавлен вариант поверхности 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. Добавлены UNSUPPORTED_AD_TYPE и TOO_MANY_RESOURCES_IN_REQUEST в ShareablePreviewError. Эта функция поддерживается только для некоторых типов объявлений.

Версия 23.1 (25.02.2026)

В Google Ads API версии 23.1 добавлены перечисленные ниже новые функции и обновления. В промежуточных версиях, например 23.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 Новое значение enum Добавлена возможность выбирать 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 Новые функции и поддержка Обновленные объекты чатов:
Оплата
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 Новое значение enum или ошибка Добавлен код ошибки INVALID_VIDEO_LINEUP_ID.
Показатели слышимости на YouTube Новые показатели Добавлены показатели слышимости для аудиообъявлений на YouTube, позволяющие узнать, было ли объявление слышно и для какого количества показов можно было определить слышимость.

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

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