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

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

Основная версия 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 Новое значение enum / ошибка Добавлено в 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.

Ошибки проверки кампании Местных услуг Новые значения перечисления и ошибки Добавлены новые ошибки проверки для кампаний с местными услугами:
Проверка связи с аккаунтом Hotel Center Новое значение enum или ошибка В 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.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 требуется, если для любого критерия на уровне кампании в кампании (или для любого активного критерия на уровне группы объявлений в кампаниях DEMAND_GEN с улучшенным таргетингом) в этом поле указано значение true. Поля возвращают true, если поле negative критерия имеет значение false, а критерий – это местоположение в ЕС, область в радиусе (независимо от того, пересекается ли она с территорией ЕС) или группа адресов (независимо от того, пересекается ли она с территорией ЕС).
Конверсии
Единая конфигурация расширенного отслеживания конверсий Новые поля и перечисления Добавлены поля ConversionTrackingSetting.enablement_setting и ConversionTrackingSetting.effective_enablement_setting (в Customer.conversion_tracking_setting), чтобы показывать единую конфигурацию расширенного отслеживания конверсий для аккаунта, представленную с помощью нового перечисления EnhancedConversionsConfig.
ConversionActionCategory.MESSAGE_LEAD Новое значение enum Добавлен в 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.

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

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

Версия 25.2 (23.09.2026)

В Google Ads API версии 25.2 добавлены следующие новые функции и изменения: В промежуточных версиях, например 25.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 добавлены перечисленные ниже функции и обновления. Промежуточные версии, например 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 со следующими обновлениями:
Исследования роста конверсий Новые функции Добавлена поддержка показателей роста конверсий со следующими обновлениями:
  • Добавлен новый ресурс только для чтения 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
Отдельные поля перечисления: Переименование или удаление Вместо устаревших полей type используйте новые отдельные поля enum.
Необязательные поля 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 Ads API, чтобы отразить обновленную схему унифицированных целей:
Конверсии
Сторонняя атрибуция конверсий на YouTube Новые поля Добавлена поддержка проверки атрибуции конверсий на YouTube с помощью сторонних партнеров: Подробнее об этом рассказывается в статье Справочного центра.
Общие
ContactDetails.phone_number_extension Новое поле Добавлено в ресурс LocalServicesLead.
IncentiveError Новые значения перечисления и ошибки Добавлены новые коды ошибок, связанных с проблемами при использовании бонусов:
  • BILLING_COUNTRY_NOT_ELIGIBLE (страна нахождения платежного адреса клиента не соответствует условиям получения бонуса)
  • USER_IS_MCC_MANAGER (пользователь является управляющим аккаунтом и не может воспользоваться бонусом).
  • USER_SUSPENDED (аккаунт клиента заблокирован)
  • MAX_PENDING_INCENTIVES (клиент достиг максимального количества ожидающих бонусов)
  • ACCOUNT_HAD_RECENT_SPEND (в аккаунте недавно были расходы, поэтому он не соответствует требованиям)
  • MAX_INCENTIVES_REDEEMED_FROM_OFFER (клиент уже получил максимальное количество бонусов в рамках этого предложения).
  • MISMATCHING_BILLING_COUNTRY_CODE (код страны нахождения платежного адреса, указанный в запросе, не совпадает со страной аккаунта клиента)
Планирование
Информация о канале YouTube в статистике трендов Новые поля Добавлена поддержка более подробной информации о каналах YouTube, на которых размещены связанные видео, при поиске актуальной статистики. В YouTubeVideoAttributeMetadata добавлены новые поля channel_id, channel_name и channel_url.
YouTubeChannelInsights.data_sharing_consent_given Новое поле Добавлено в очередь экрана YouTubeChannelInsights. Это возможно, если автор дал согласие на передачу закрытых данных. Если да, то будут заполнены следующие поля:
Отчеты
ad_sub_format_type Новый сегмент Содержит разбивку объявлений 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 Новое перечисляемое значение Генерирует сгенерированный текст с целевой страницы, который будет показываться на панели взаимодействия для экземпляров 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 Новое значение enum / ошибка Возвращается при попытке удалить все сигналы из группы объектов.
Кампании
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings
Campaign.PmaxCampaignSettings.local_services_enabled
Новые поля Помощь в определении кампаний с максимальной эффективностью для местных услуг.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps Новое поле Google Карты включены в список каналов, которые можно выбрать для групп объявлений в кампаниях для создания спроса.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN Новое перечисляемое значение / ошибка Возвращается при попытке удалить все местоположения из кампании с максимальной эффективностью для местных услуг.
SmartCampaignErrorEnum.CREATION_FAILED Новое перечисляемое значение / ошибка Возвращается при попытке создать новую умную кампанию.
Конверсии
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS
Новые значения перечисления Конверсии, которые происходят, когда пользователь нажимает на объявление Местных услуг и звонит, отправляет сообщение или бронирует услуги рекламодателя.
Эксперименты
COMPARE_CAMPAIGNS
PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION
Новые значения перечисления Добавлена поддержка новых типов ExperimentType:
  • COMPARE_CAMPAIGNS – для экспериментов с миксами кампаний и собственных экспериментов в кампаниях с максимальной эффективностью, в которых сравниваются несколько кампаний одного или разных типов.
  • PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION – для экспериментов по оптимизации кампаний с максимальной эффективностью, связанных с оптимизацией текста и дополнением конечного URL.
Общие
Asset.synthetic_content_info
Ad.synthetic_content_info
Новые поля Содержат подтверждения того, что контент является синтетическим или создан искусственным интеллектом. Подтверждения делятся на advertiser_attestation (заявления, предоставленные непосредственно рекламодателем) и system_attestation (подтверждения, автоматически обнаруженные или предоставленные системой).

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

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

Если вы попытаетесь выполнить запрос mutate для одного из этих полей, будет возвращена одна из следующих ошибок:

"Поле, которое вы пытаетесь изменить, является неизменяемым" или "Не удалось задать значение поля".

Эти поля станут полностью изменяемыми начиная с версии 25. Мы рекомендуем использовать интерфейс сейчас, чтобы создать и протестировать внутреннюю логику. Тогда ваша система будет готова к полному доступу на запись, когда будет запущена версия 25.

Групповое одобрение Новые функции Добавлена поддержка групповой авторизации (MPA):
Эта функция была перенесена в версии 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 Новое перечисляемое значение / ошибка Возвращается, когда запрошенный уровень детализации времени (по дням, часам или неделям) не поддерживается для диапазонов дат запроса (доступно только за последние 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 Новое значение 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. Статус заметок и проблемы не поддерживаются.
Фильтрация товаров на основе тегов Новинка Добавлена динамическая фильтрация с использованием логических выражений: Эта функция доступна только для аккаунтов из белого списка.

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

В 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 Новое перечисляемое значение Добавлена платформа 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)

В версии 23.1 Google Ads API появились следующие новые функции и изменения. В промежуточных версиях, например 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 Новое значение enum Поддерживает отслеживание пользователей, которые посмотрели объявление, а затем видео на том же канале.
Общие
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED Новое значение enum или ошибка Возвращается при попытке настроить таргетинг только на категорию "Неопределено" в демографических параметрах.
Поощрительные программы
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 Новое значение enum Добавлено поле 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 Новое поле Добавлена поддержка сопутствующих баннеров в адаптивных видеообъявлениях для создания спроса.
Поощрительные программы
Добавлена поддержка бонусов "Выбери сам" (CYO).
  • Добавлен метод FetchIncentive для получения доступных персонализированных бонусов для пользователя.
  • Добавлен метод ApplyIncentive, позволяющий применить выбранный бонус к аккаунту клиента.
  • Добавлен ресурс AppliedIncentive (доступен для запросов с помощью Search и SearchStream), который предоставляет сведения о погашении.
  • Добавлены новые коды ошибок в IncentiveError и AuthenticationError.INVALID_EMAIL_ADDRESS.

Чтобы упростить программную обработку ошибок, в будущих выпусках мы добавим в IncentivesService дополнительные коды ошибок. Рекомендуем следить за объявлениями и примечаниями к выпускам, чтобы узнать, когда появятся новые коды ошибок, и убедиться, что ваши приложения могут обрабатывать новые режимы сбоев.

Планирование
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST Новое перечисляемое значение Позволяет создавать аудитории на основе событий в жизни в GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport и GenerateCreatorInsights.

События не поддерживаются для других методов AudienceInsightsService, таких как AudienceInsightsService.GenerateAudienceOverlap и AudienceInsightsService.GenerateTargetingSuggestionMetrics.

ReachPlanService.GenerateConversionRates Новые поля или варианты Теперь в ответе есть платформы, для которых можно получить рекомендации по коэффициенту конверсии на основе настроек платформ (например, Gmail, Shorts). Поддерживается только в кампаниях для создания спроса.
LanguageDistribution Новое поле или тип Добавлен в YouTubeChannelInsights, чтобы предоставлять информацию о распределении языков в контенте канала YouTube.
BenchmarksService Новый сервис Сравнение данных о рекламе на YouTube с отраслевыми показателями.
AudienceInsightsService.GenerateAudienceDefinition Новый метод Переводит описание целевой аудитории в виде свободного текста в соответствующие атрибуты аудитории с помощью генеративного искусственного интеллекта.
YouTubeChannelInsights.relevance_score Новое поле Оценивает, насколько автор соответствует теме, с учетом количества просмотров.
TrendInsightMetrics.trend_change_percent Новое поле Процентное изменение значения тренда за период сравнения.
Рекомендации
GenerateRecommendationsRequest Новое поле Добавлена функция is_new_customer. Если для рекомендаций CAMPAIGN_BUDGET задано значение true, используется модель, оптимизированная для новых клиентов (рекомендуется только для клиентов, у которых нет кампаний).
Отчеты
AdGroupAdAssetView Поддержка новых функций и показателей Теперь поддерживаются показатели показов, эффективности и конверсий для RESPONSIVE_DISPLAY_AD.
Сегмент ad_sub_network_type Новый сегмент Позволяет получить подробную разбивку данных об эффективности в рекламной сети. Сначала эта функция будет доступна для кампаний для создания спроса на YouTube (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
Новые поля и критерии В AdGroupCriterion и vertical_ads_item_group_ruleSharedCriterion добавлен тип критерия vertical_ads_item_group_rule_list, чтобы разрешить таргетинг на группы позиций в поисковых кампаниях с фидами туристических услуг.
Интеграция фида данных вертикальных объявлений Новинка Теперь вы можете подключить фид данных вертикальной рекламы к поисковой кампании, в которой используется 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, позволяющие узнать, было ли объявление слышно и для какого количества показов можно было определить слышимость.

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

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