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

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

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

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

v25.2 (2026-09-23)

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

v25.1 (19.08.2026)

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

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

v25 (2026-07-22)

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

См. раздел «Обновление до последней версии» для получения инструкций.

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

Начальное состояние	Новый штат	Изменить тип	Руководство по внедрению
Кампании
Автономные поля additional_value и additional_high_lifetime_value в CustomerLifecycleOptimizationValueSettings	Часть объектов value_adjustment и high_lifetime_value_adjustment соответственно, наряду с новыми полями value_multiplier и high_lifetime_value_multiplier	Структурные изменения	Обновите ссылки на эти поля, так как теперь они являются частью объектов типа oneof.
Устаревшие ресурсы CustomerLifecycleGoal и CampaignLifecycleGoal , соответствующие им сервисы CustomerLifecycleGoalService и CampaignLifecycleGoalService , а также устаревшие настройки/перечисления ( CustomerAcquisitionGoalSettings , CustomerAcquisitionOptimizationModeEnum , LifecycleGoalValueSettings ).	Никто	Удаление	Используйте обновленную схему единых целей: Используйте поле new_customer_acquisition_goal_settings в ресурсе Goal . Используйте поле campaign_new_customer_acquisition_settings в ресурсе CampaignGoalConfig для настройки переопределений, специфичных для конкретной кампании.
Общий
Вложенные поля перечисления в сообщениях запроса и ответа службы стимулирования: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	Автономные поля перечисления: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	Переименовать / удалить	Вместо устаревших полей type используйте новые автономные поля перечисления.
В ApplyIncentiveRequest необязательными являются поля selected_incentive_id и customer_id	Обязательные поля	Изменение поведения	При вызове функции ApplyIncentive обязательно укажите оба поля.
Поле адреса электронной почты потребителя ContactDetails.email в ресурсе LocalServicesLead	Никто	Удаление	Удалите ссылки на это поле, поскольку оно больше не поддерживается.
Необязательное поле allowed_domain в AdvertisingPartnerLinkInvitationProperties	Обязательное поле при вызове функции CreateProductLinkInvitation для рекламного партнера.	Изменение поведения	При создании приглашения по ссылке на продукт для рекламного партнера обязательно укажите allowed_domain .
Планирование
Поле search_brand в GenerateCreatorInsightsRequest	Никто	Удаление	Вместо этого используйте search_topics .
Поле plannable_location_id в Targeting и поле cookie_frequency_cap в GenerateReachForecastRequest	Никто	Удаление	Переключитесь на использование plannable_location_ids и cookie_frequency_cap_setting .
Отчеты
Поле customer_metrics в GenerateBenchmarksMetricsResponse и BreakdownMetrics типа Metrics	Поле типа CustomerMetrics	Изменение типа личности / сдвиг в поведении	Обновите свои интеграции, чтобы использовать новый тип CustomerMetrics , который содержит только метрики, отражающие эффективность рекламы клиента.

Новые функции и обновления (не нарушающие критическую совместимость)

Функции и обновления	Тип	Описание
Реклама
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	Новое значение перечисления / поведение	Доступно для DemandGenMultiAssetAds . Если включено, генерируются анимированные изображения, используя в качестве входных данных неанимированные изображения. Новые DemandGenMultiAssetAds по умолчанию включены, начиная с этой версии API.
Изменчивость информации о синтетическом контенте	Изменение поведения	В версиях v25, v24 и v23 Asset.synthetic_content_info и Ad.synthetic_content_info теперь полностью изменяемы.
Кампании
Цель по удержанию лояльности	Новые функции / настройки	Добавлена ​​поддержка цели по удержанию лояльных клиентов, которая позволяет рекламодателям оптимизировать кампании для сохранения участников программы лояльности. В перечисление GoalType добавлено значение LOYALTY_RETENTION . Добавлена CampaignGoalConfig.campaign_loyalty_retention_settings для настройки параметров удержания лояльности для конкретных кампаний, включая корректировку ставок и отображение преимуществ для участников в формате PLA. Добавлена Goal.loyalty_retention_goal_settings для настройки целевых показателей удержания лояльности на уровне учетной записи. Добавлены новые коды ошибок: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
Цель по привлечению новых клиентов	Новые функции / настройки	В API Google Ads обновлена ​​поддержка целей по привлечению новых клиентов в соответствии с обновленной унифицированной схемой целей: Ресурс Goal расширен для поддержки настроек привлечения новых клиентов с использованием поля new_customer_acquisition_goal_settings . Ресурс CampaignGoalConfig расширен для поддержки переопределения параметров привлечения новых клиентов в зависимости от конкретной кампании с помощью поля campaign_new_customer_acquisition_settings . Добавлено новое перечисление CustomerLifecycleOptimizationGoalSubType для определения поддерживаемых подтипов целей. В перечисление GoalType добавлено значение NEW_CUSTOMER_ACQUISITION . В GoalError добавлены новые причины ошибок валидации: NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS В CampaignGoalConfigError добавлены новые причины ошибок валидации: CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE CANNOT_USE_INCOMPATIBLE_CLO_GOALS Добавлена ​​структура ErrorDetails.incompatible_clo_goal_error_details для отображения новой структуры IncompatibleCloGoalsErrorDetails для ошибок валидации.
Конверсии
Атрибуция конверсий сторонними сервисами YouTube	Новые поля	Добавлена ​​поддержка проверки атрибуции конверсий на YouTube с использованием сторонних партнеров: Добавлена ​​переменная CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners , позволяющая настраивать партнеров по интеграции на уровне клиента. Добавлена ​​функция CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners , позволяющая настраивать партнеров по интеграции на уровне кампании. Подробнее можно узнать в статье Справочного центра .
Общий
ContactDetails.phone_number_extension	Новое поле	Добавлено в ресурс LocalServicesLead .
IncentiveError	Новые значения перечислений и ошибки	Добавлены новые специальные коды ошибок для случаев неудачного использования бонусных баллов: BILLING_COUNTRY_NOT_ELIGIBLE не имеет права на получение бонуса (страна выставления счетов клиента не имеет права на получение бонуса) USER_IS_MCC_MANAGER (пользователь является менеджером и не может использовать бонус) USER_SUSPENDED (учетная запись клиента приостановлена) MAX_PENDING_INCENTIVES (клиент достиг максимального количества ожидающих начисления бонусов) ACCOUNT_HAD_RECENT_SPEND (на этом счете недавно были траты, и он не соответствует условиям) MAX_INCENTIVES_REDEEMED_FROM_OFFER (клиент уже использовал максимальное количество бонусов по этому предложению) MISMATCHING_BILLING_COUNTRY_CODE (код страны, указанный в запросе, не соответствует стране учетной записи клиента)
Планирование
Подробная информация о YouTube-канале в разделе «Аналитика трендов».	Новые поля	Добавлена ​​поддержка отображения более подробной информации о YouTube-канале для связанных видео при поиске в разделе "Анализ трендов". В поле "Таблица YouTubeVideoAttributeMetadata " добавлены новые поля channel_id , channel_name и channel_url .
YouTubeChannelInsights.data_sharing_consent_given	Новое поле	Добавлено в YouTubeChannelInsights . Это справедливо, если автор дал согласие на предоставление непубличных данных. В этом случае заполняются следующие поля: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
Отчеты
ad_sub_format_type	Новый сегмент	Предоставляет разбивку по продолжительности неотключаемых рекламных объявлений в видеопотоке YouTube: INSTREAM_NON_SKIPPABLE_STANDARD (стандартная продолжительность не пропускаемой рекламы в потоке) INSTREAM_NON_SKIPPABLE_MAX30_SEC (непропускаемая реклама в потоке длительностью не более 30,99 секунд) INSTREAM_NON_SKIPPABLE_MAX60_SEC (непропускаемая реклама в потоке длительностью не более 60,99 секунд) Этот сегмент всегда должен быть выбран вместе с ad_format_type . Он может быть выбран вместе с AdGroup , AdGroupAd , Campaign , Customer , Video и VideoEnhancement .
Социальные метрики, специфичные для видео	Новые поля / метрики	Добавлены специальные социальные метрики для видео, которые помогут рекламодателям отслеживать вовлеченность пользователей (комментарии, лайки и репосты) в рекламных объявлениях Shorts на YouTube: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares Они доступны в AdGroup , AdGroupAd , Asset , Campaign , Customer и Video .

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

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

v24.2 (2026-06-24)

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

Функции и обновления	Тип	Описание
Реклама
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	Новое значение перечисления	Генерирует текстовую информацию с целевой страницы для отображения в панели взаимодействия для экземпляров DemandGenVideoResponsiveAd (которые по умолчанию включены начиная с этой версии API).
Ресурсы
AssetGroup.google_local_services_info	Новое поле	Добавлено для поддержки информации в объявлениях о местных услугах (идентификатор категории и выноски) в кампаниях Performance Max.
AssetGroupSignal.local_services_id	Новое поле	Добавлено для поддержки сигналов идентификатора сервиса Local Services Ads в кампаниях Performance Max.
AssetGroupSignal.vertical_ads_item_group_rule_list	Новое поле	Добавлена ​​поддержка правил группировки элементов вертикальных объявлений для выбора элементов из прикрепленных вертикальных фидов в кампаниях Performance Max. Эта функция доступна только для учетных записей, включенных в список разрешенных.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN	Новое значение перечисления / ошибка	Возвращается при попытке удалить все группы активов из кампании.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS	Новое значение перечисления / ошибка	Возвращается при попытке удалить все сигналы из группы активов.
Кампании
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled	Новые поля	Оказание поддержки в определении кампаний, обеспечивающих максимальную эффективность локальных сервисов.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	Новое поле	Включает Google Maps в список каналов, доступных для выбора в группах объявлений для генерации спроса.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	Новое значение перечисления / ошибка	Возвращается при попытке удалить все местоположения из кампании Performance Max для локальных служб.
SmartCampaignErrorEnum.CREATION_FAILED	Новое значение перечисления / ошибка	Ошибка возникает при попытке создания новых интеллектуальных кампаний.
Конверсии
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	Новые значения перечисления	Отображает конверсии, которые происходят, когда пользователь кликает на объявление о предоставлении местных услуг и звонит, пишет сообщение или бронирует услугу у рекламодателя.
Эксперименты
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	Новые значения перечисления	Добавлена ​​поддержка новых типов ExperimentType : COMPARE_CAMPAIGNS : Для экспериментов по комбинированию кампаний и пользовательских экспериментов Performance Max, которые сравнивают несколько кампаний одного или разных типов в одном эксперименте. PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION : Для экспериментов по оптимизации производительности при настройке текста и расширении конечного URL-адреса.
Общий
Asset.synthetic_content_info Ad.synthetic_content_info	Новые поля	Содержит подтверждения для синтетического/сгенерированного ИИ контента, разделенные на advertiser_attestation (заявления, предоставленные непосредственно рекламодателем) и system_attestation (подтверждения, автоматически обнаруженные или предоставленные системой). Эта функция была перенесена в версии 23 и 22. Чтобы помочь вам спланировать предстоящую работу по интеграции для версии 25, интерфейс для изменения полей подтверждения рекламодателя будет представлен заранее для версий 22 и выше. Интерфейс доступен в этих версиях, но поля synthetic_content_info.advertiser_attestation.status и synthetic_content_info.advertiser_attestation.source останутся неизменяемыми для этих версий. При попытке изменить значение любого из этих полей будет возвращена одна из следующих ошибок: «Поле, которое пытались изменить, неизменяемо» или «Поле не может быть установлено». Начиная с версии 25, эти поля станут полностью изменяемыми. Мы рекомендуем использовать интерфейс уже сейчас для создания и тестирования вашей внутренней логики, чтобы ваша система была готова к полноценной записи данных после запуска версии 25.
Многосторонняя авторизация	Новые функции	Бета-версия: Эта функция в настоящее время находится в стадии бета-тестирования и может быть изменена в будущих релизах. Добавлена ​​поддержка многосторонних проверок авторизации (MPA): Добавлен ресурс MultiPartyAuthReview и соответствующий MultiPartyAuthReviewService . Добавлено перечисление MultiPartyAuthReviewStatus для отслеживания статуса проверки. Добавлена CustomerUserAccess.pending_multi_party_auth_review для ссылки на ожидающую проверки. Добавлены MutateCustomerUserAccessResult.multi_party_auth_review и MutateCustomerUserAccessInvitationResult.multi_party_auth_review для возврата соответствующего имени ресурса для проверки. Добавлена MultiPartyAuthReviewError для обработки ошибок валидации. Эта функция была перенесена в версии 23.3 , 22.2 и 21.2 .
IncentiveService.FetchIncentive	Изменение поведения	В случае предоставления в запросе недействительного адреса электронной почты, метод теперь корректно возвращает стандартные предложения по поощрениям вместо того, чтобы выдавать ошибку AuthenticationError.INVALID_EMAIL_ADDRESS .
Планирование
GenerateCreatorInsightsRequest.search_topics	Новое поле	Добавлено в сервис ContentCreatorInsightsService.GenerateCreatorInsights . Эта опция ищет авторов, обсуждающих тему в стране, указанной в country_locations (поддерживает поиск только по одной стране).
CREATOR_TOPIC_INSIGHTS	Новое значение перечисления	Добавлено в InsightsKnowledgeGraphEntityCapabilities для обозначения сущностей, используемых для поиска авторов, обсуждающих определенную тему. Эти сущности следует использовать в поле search_topics . Получено с помощью AudienceInsightsService.ListAudienceInsightsAttributes .
KnowledgeGraphEntitySearchOptions	Новый тип / параметры	Содержит дополнительные параметры поиска по темам в ListAudienceInsightsAttributes , включая возможность получения всех тем, поддерживаемых в качестве атрибутов создателя, и фильтрацию по возможностям.
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data	Новые поля	Необязательные входные данные для методов ContentCreatorInsightsService . Указание этого поля позволяет добавить в ответ дополнительные данные о местоположении или атрибуты создателя контента.
local_creator_insights related_local_creators	Новые поля	Заполняется, если в поле supplemental_data содержится перечисление LOCAL_CREATOR_DATA . Отображает информацию о местных авторах, чьи профили просматриваются или которые находятся в выбранной стране и дали согласие на предоставление данных о местоположении.
GenerateTrendingInsightsRequest.sub_country_locations	Новое поле	Добавлена ​​функция ContentCreatorInsightsService.GenerateTrendingInsights , позволяющая осуществлять поиск трендовых данных по стране и регионам.
Отчеты
PerformanceMaxPlacementView	Расширение сегментов	Сегментация осуществляется с помощью ad_network_type .
Покупки
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	Новое поле	Если это так, исключения по брендам игнорируются для товарных объявлений. Поддерживается только для товарных кампаний.
Целенаправленное воздействие
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	Новое значение перечисления / ошибка	Возвращается при попытке указать язык, который не разрешен.
Видео
DataLink.youtube_link_metadata	Новое поле	Содержит параметр brand_channel_id , указывающий идентификатор связанного канала бренда на YouTube.

v24.1 (13.05.2026)

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

Функции и обновления	Тип	Описание
Реклама
DemandGenMultiAssetAdInfo.classic_display_images	Новое поле	Изображения, загруженные пользователем, отображаются без необходимости использования дополнительных адаптивных ресурсов.
Эксперименты
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	Новые значения перечисления	Добавлена ​​поддержка новых типов ExperimentType : ADOPT_AI_MAX : Для экспериментов, проверяющих, как AI Max может помочь вам привлечь больше клиентов с помощью Google AI и ключевых слов с широким соответствием. ADOPT_BROAD_MATCH_KEYWORDS : Для экспериментов, проверяющих, как ключевые слова с широким соответствием могут влиять на количество поисковых запросов, в которых отображаются ваши объявления. OPTIMIZE_ASSETS : Для проведения пользовательских экспериментов по оптимизации ресурсов. PMAX_REPLACEMENT_SHOPPING : Для экспериментов, проверяющих, как ваши торговые кампании работают по сравнению с Performance Max.
Experiment.video_experiment	Новое поле	Поддержка настройки существующих экспериментов YOUTUBE_CUSTOM , состоящих из видеокампаний.
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	Новые поля	Предоставляет доступ к полям для поддержки тестирования активов, групп активов и настроек максимальной производительности в экспериментальных группах: asset_testing_info : Подробная информация об активах, связанных с экспериментальными копиями рекламы. asset_groups : Список групп активов в экспериментальной группе для экспериментов по оптимизации активов. performance_max_experiment_arm_info : Настройки для кампаний Performance Max в экспериментах PMAX_REPLACEMENT_SHOPPING .
Общий
CustomerUserAccess.passkey_enabled	Новое поле	Поле только для чтения, указывающее, включен ли у пользователя пароль.
Отчеты
mobile_device_platform	Новый сегмент	Позволяет сегментировать отчеты по платформе устройства пользователя (например, iOS или Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	Новое значение перечисления / ошибка	Возвращается, если запрошенная дневная, почасовая или еженедельная детализация времени не поддерживается для диапазонов дат запроса (доступно только за последние 37 месяцев).
vertical_ads_listing_user_rating vertical_ads_listing_venue	Новые сегменты	Новые сегменты будут использоваться для вертикальной рекламы.
user_rating , venue , event_participant_display_name	Новые критерии фильтрации	Поддерживается фильтрация в VerticalAdsItemGroupRuleInfo для ресурса SharedCriterion .
Показатели контрольного/экспериментального эксперимента	Новые поля	Добавлены контрольные значения ( control_clicks и т. д.), значения обработки ( clicks и т. д.), точечные оценки ( clicks_point_estimate и т. д.), погрешности ( clicks_margin_of_error и т. д.) и p-значения ( clicks_p_value и т. д.) для семи основных групп метрик (Клики, Показы, Стоимость, Конверсии, Стоимость конверсии, Ценность конверсии, Ценность конверсии в расчете на стоимость).
Показатели абсолютного изменения конверсий	Новые поля	Поддержка оценки абсолютной разницы Conversions с использованием полей точечной оценки, погрешности и p-значения.
Целенаправленное воздействие
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS	Новое значение перечисления / ошибка	Результат возвращается при попытке исключить все целевые демографические группы.
Видео
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR	Новое значение перечисления	Компания ZEFR выступает в качестве стороннего партнера по интеграции функций повышения видимости контента.
DataLink.youtube_video.channel_id	Новое поле	Предоставляет доступ к идентификатору канала YouTube, связанному с каналом передачи данных.

v24 (2026-04-22)

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

См. раздел «Обновление до последней версии» для получения инструкций.

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

Начальное состояние	Новый штат	Изменить тип	Руководство по внедрению
Реклама
Дополнительные videos и logo_images в DemandGenVideoResponsiveAdInfo	Обязательные поля	Изменение поведения	При создании или изменении адаптивных видеообъявлений для генерации спроса указывайте videos и logo_images .
Дополнительные параметры: videos , business_name и logo_images в VideoResponsiveAdInfo	Обязательные поля	Изменение поведения	При создании или изменении адаптивных видеообъявлений указывайте videos , business_name и logo_images . Обратите внимание, что VideoResponsiveAdInfo теперь можно изменять.
Кампании
Campaign.video_brand_safety_suitability	Никто	Удаление	Контроль соответствия на уровне кампании удален. Проверка соответствия на уровне клиента по-прежнему доступна для обеспечения безопасности бренда. Используйте вместо этого Customer.video_brand_safety_suitability .
Конверсии
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Никто	Удаление	Категория пользователей, регистрирующихся в программе лояльности, удалена. Удалите ссылки на неё из кода.
Планирование
InsightsAudienceAttributeGroup — тип для topic_audience_combinations	common. InsightsAudienceAttributeGroup тип	Изменение поведения / смена типа поведения	Интеграцию типизированных клиентских библиотек необходимо обновить, чтобы использовать новые пространства имен ресурсов.
Поле youtube_select_lineups в ReachPlanService.ListPlannableProducts	Никто	Удаление	Переключитесь на использование составов команд из youtube_select_lineup_targeting .
Поле is_brand_connect_creator в ContentCreatorInsightsService.GenerateCreatorInsights и GenerateTrendingInsights	Никто	Удаление	Вместо этого проверьте, есть ли у создателя доступ CREATOR_PARTNERSHIPS в partnership_opportunities .
geo_modifiers и biddable_keywords в KeywordPlanIdeaService.GenerateKeywordForecastMetrics	geo_target_constants и keywords	Переименовать / удалить	Заменено на CampaignToForecast.geo_target_constants[] и ForecastAdGroup.keywords[] .
Устаревшие поля планирования/прогнозирования ключевых слов в GenerateKeywordForecastMetrics	Никто	Удаление	Удалены следующие поля и типы плана/прогноза: CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords и ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate Обновите интеграции соответствующим образом.
Отчеты
сегмент ad_sub_network_type в campaign_budget	Никто	Удаление	Удалён сегмент ad_sub_network_type для ресурса campaign_budget .
Сегмент click_type в представлениях активов	Никто	Удаление	Удалён сегмент из представлений AdGroupAsset , CampaignAsset и CustomerAsset .
Видео
В ShareablePreviewService.GenerateShareablePreviews допускается частичная ошибка.	Частичный сбой отсутствует	Изменение поведения	Если какой-либо идентификатор в запросе не пройдет проверку, он завершится с ошибкой.
Устаревшие коды ShareablePreviewError : ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST	Переименование / изменение поведения	Коды ошибок, возвращаемые для групп ресурсов, изменяются в соответствии с ошибками в объявлениях групп. Обновите логику обработки ошибок проверки.

Новые функции и обновления (не нарушающие критическую совместимость)

Функции и обновления	Тип	Описание
Реклама
Изменяемость VideoResponsiveAdInfo	Изменение поведения	Теперь информационные объекты в адаптивных видеорекламах могут быть изменяемыми.
Ресурсы
travel_feed_data в AssetSet	Новое поле	Добавлена ​​возможность получения атрибутов ресурсов из ленты новостей о путешествиях ( hotel_center_account_id , merchant_center_id , partner_center_id , subset_id , travel_feed_vertical_type ).
Кампании
Campaign.view_through_conversion_optimization_enabled	Новое поле	Позволяет включить оптимизацию конверсии по показателю «Просмотр через» (VTC) (по умолчанию false ) в кампаниях по генерации спроса и кампаниях для приложений.
CampaignCriterion.gender	Новая функция	Включена возможность исключения по полу для кампаний Performance Max во всех версиях Google Ads API.
Конверсии
Типы конверсии для генерации лидов	Новые значения перечисления	В ConversionActionType добавлены новые перечисления типов действий преобразования GA4/Firebase: GOOGLE_ANALYTICS_4_GENERATE_LEAD GOOGLE_ANALYTICS_4_QUALIFY_LEAD GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD FIREBASE_ANDROID_GENERATE_LEAD FIREBASE_ANDROID_QUALIFY_LEAD FIREBASE_ANDROID_CLOSE_CONVERT_LEAD FIREBASE_IOS_GENERATE_LEAD FIREBASE_IOS_QUALIFY_LEAD FIREBASE_IOS_CLOSE_CONVERT_LEAD
Общий
UserListErrorEnum.DUPLICATE_LOOKALIKE	Новое значение перечисления / ошибка	Возвращается при попытке создать несколько идентичных списков похожих элементов.
Планирование
Поля ProductCoreAttributes в ListPlannableProductsResponse	Новые поля	В раздел ListPlannableProductsResponse добавлены планируемое описание продукта, маркетинговая цель, модель затрат и способ закупки в поле ProductCoreAttributes .
Отчеты
CartDataSalesView	Новый ресурс для составления отчетов	Предоставляет отчеты, сегментирующие показатели конверсии по конкретному продаваемому товару (бренду и т. д.), а также по товару, на который был совершен клик.
Показатели, не подлежащие торгам	Новые поля	Добавлены показатели, не зависящие от назначения ставок (показатели конверсий, которые не оптимизируются в рамках кампаний), ко всем соответствующим ресурсам: all_average_cart_size all_average_order_value_micros all_cost_of_goods_sold_micros all_cross_sell_cost_of_goods_sold_micros all_cross_sell_gross_profit_micros all_cross_sell_revenue_micros all_cross_sell_units_sold all_gross_profit_margin all_gross_profit_micros all_lead_cost_of_goods_sold_micros all_lead_gross_profit_micros all_lead_revenue_micros all_lead_units_sold all_orders all_revenue_micros all_units_sold
conversion_attribution_event_type	Новый сегмент	Добавлено в ShoppingPerformanceView .
Покупки
Рекламные кампании приложений в ShoppingProduct	Новая функция	Поддерживаются кампании приложений внутри ресурса ShoppingProduct . Обратите внимание, что статусы и проблемы не поддерживаются.
Фильтрация товаров по тегам	Новая функция	Введена функция фильтрации с использованием динамических выражений логических множеств: Добавлены типы критериев RETAIL_FILTER_BUNDLE и RETAIL_FILTER . Добавлен общий тип набора RETAIL_FILTER . В AdGroupCriterion добавлено поле retail_filter_bundle . В SharedCriterion добавлено поле retail_filter . Добавлено RETAIL в ListingGroupFilterListingSource . Добавлен параметр RetailFilter в AssetGroupListingGroupFilter . Добавлены новые ошибки проверки в разделах CriterionError и AssetGroupListingGroupFilterError . Эта функция доступна только для учетных записей, включенных в список разрешенных.

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

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

v23.3 (24.06.2026)

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

Функции и обновления	Тип	Описание
Общий
Asset.synthetic_content_info Ad.synthetic_content_info	Новые поля	Содержит подтверждения для синтетического/сгенерированного ИИ контента, разделенные на advertiser_attestation (заявления, предоставленные непосредственно рекламодателем) и system_attestation (подтверждения, автоматически обнаруженные или предоставленные системами Google). Чтобы помочь вам спланировать предстоящую работу по интеграции для версии 25, интерфейс для изменения полей подтверждения рекламодателя будет представлен заранее для версий 22 и выше. Интерфейс доступен в этих версиях, но поля synthetic_content_info.advertiser_attestation.status и synthetic_content_info.advertiser_attestation.source останутся неизменяемыми для этих версий. При попытке изменить значение любого из этих полей будет возвращена одна из следующих ошибок: «Поле, которое пытались изменить, неизменяемо» или «Поле не может быть установлено». Начиная с версии 25, эти поля станут полностью изменяемыми. Мы рекомендуем использовать интерфейс уже сейчас для создания и тестирования вашей внутренней логики, чтобы ваша система была готова к полноценной записи данных после запуска версии 25.
Согласования от нескольких сторон	Новые функции	Бета-версия: Эта функция в настоящее время находится в стадии бета-тестирования и может быть изменена в будущих релизах. Добавлена ​​поддержка многосторонних согласований (MPA): Добавлен ресурс MultiPartyAuthReview и соответствующий MultiPartyAuthReviewService . Добавлено перечисление MultiPartyAuthReviewStatus для отслеживания статуса проверки. Добавлена CustomerUserAccess.pending_multi_party_auth_review для ссылки на ожидающую проверки. Добавлены MutateCustomerUserAccessResult.multi_party_auth_review и MutateCustomerUserAccessInvitationResult.multi_party_auth_review для возврата соответствующего имени ресурса для проверки. Добавлена MultiPartyAuthReviewError для обработки ошибок валидации.

v23.2 (2026-03-25)

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

Функции и обновления	Тип	Описание
Ресурсы
VideoEnhancement	Новый ресурс	Содержит информацию о видеорекламе, специфичную для данной функции, например, сгенерирована ли она Google или предоставлена ​​рекламодателем. Подробнее см. в разделе «Об улучшениях видеорекламы» .
AppTopCombinationView	Новый ресурс	Ресурс только для чтения, предоставляющий информацию о наиболее эффективных сочетаниях рекламных материалов в кампаниях мобильных приложений.
CustomerAsset	Новая функция	Добавлена ​​поддержка получения данных CustomerAsset с field_type , установленным в значение BUSINESS_LOGO .
Кампании
AdGroupAd.start_date_time AdGroupAd.end_date_time	Новые поля	Предоставьте более детальные ограничения по расписанию на даты кампании. Эта функция поддерживается только для некоторых типов групп объявлений.
HotelSettingInfo.disable_hotel_setting	Новое поле	Позволяет отключить отображение информации об отелях в кампаниях по генерации спроса.
Общий
CustomerClientLinkError	Новые значения перечисления / ошибки	Добавлены два новых кода ошибок: MAX_CUSTOMER_LIMIT_REACHED и ACCOUNT_CREATION_POLICY_VIOLATION .
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Изменение поведения	Теперь при попытке использовать эту устаревшую категорию типа клиента из списка пользователей возникает ошибка.
Планирование
GenerateTrendingInsights GenerateCreatorInsights	Новые функции	Добавлена ​​поддержка пользовательских комбинаций И/ИЛИ для сущностей, тем и аудиторий.
ReachPlanService.GenerateReachForecast	Новые значения перечисления	Добавлены новые целевые возрастные диапазоны, такие как AGE_RANGE_21_44 или AGE_RANGE_21_49 .
youtube_select_lineup_targeting	Новое поле	Добавлено в ReachPlanService.ListPlannableProducts , которое заменит youtube_select_lineups . Оба поля в настоящее время заполнены.
ReachPlanSurface	Новое значение перечисления	Добавлен IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS в качестве опции для отображения потока.
Forecast	Новое поле	Добавлены clicks для функции Demand Gen Max Clicks (CPC) в ReachPlanService.GenerateReachForecast .
partnership_opportunities	Новое поле	Добавлено в ContentCreatorInsightsService.GenerateCreatorInsights и ContentCreatorInsightsService.GenerateTrendingInsights .
Отчеты
biddable_indirect_install_first_in_app_conversion_micros	Новое поле	Добавлено в ресурсы Campaign , Customer и AdGroup .
Видео
ShareablePreviewService	Новая функция	Расширена поддержка предварительного просмотра прямых трансляций YouTube путем установки preview_type в значение YOUTUBE_LIVE_PREVIEW . Добавлены UNSUPPORTED_AD_TYPE и TOO_MANY_RESOURCES_IN_REQUEST в ShareablePreviewError . Это поддерживается только для некоторых типов рекламы.

v23.1 (2026-02-25)

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

Функции и обновления	Тип	Описание
Управление учетными записями
advertising_partner_properties.allowed_domain	Новое поле	Добавлено в ресурсы ProductLinkInvitation и ProductLink . Рекламный партнер сможет размещать рекламу только на этом домене.
Customer.contains_eu_political_advertising	Новое поле	Получает информацию о статусе объявления на уровне учетной записи, указывающую, содержит ли она политическую рекламу, ориентированную на ЕС, и возвращает объект EuPoliticalAdvertisingStatus .
Кампании
Campaign.text_guidelines	Новое поле	Добавлена ​​поддержка текстовых рекомендаций, которые можно использовать с кампаниями Performance Max и Search для программного управления текстовыми материалами, генерируемыми ИИ. В параметре text_guidelines можно определить term_exclusions и messaging_restrictions .
CampaignPrimaryStatusReason	Новые значения перечисления	Добавлены CAMPAIGN_NOT_BOOKED , BOOKING_HOLD_EXPIRING , BOOKING_HOLD_EXPIRED и BOOKING_CANCELLED для указания основных причин статуса кампаний со стратегией назначения ставок FIXED_CPM .
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details	Новые поля	Добавлена ​​поддержка самораскрытия категории объявления о бронировании и отображения сведений о бронировании только для чтения.
Campaign.missing_eu_political_advertising_declaration	Новое поле	Поддерживает запросы и фильтрацию кампаний, в которых отсутствует информация о наличии политической рекламы, ориентированной на ЕС.
Конверсии
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS	Новое значение перечисления	Поддерживает отслеживание пользователей, которые смотрят рекламу, а затем просматривают видео с того же канала.
Общий
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED	Новое значение перечисления / ошибка	Результат возвращается при попытке выбрать только неопределенную категорию в демографических параметрах.
Стимулы
IncentiveErrorEnum	Новые значения перечисления / ошибки	Добавлены два новых кода ошибок: MAX_INCENTIVES_REDEEMED и ACCOUNT_TOO_OLD . Эти ошибки могут возникать при запросах, сделанных 11 марта 2026 года или позже.
Планирование
GenerateBenchmarksMetrics	Новая функция	Добавлена ​​поддержка разбивки по датам с использованием BreakdownDefinition .
ReachPlanService.GenerateReachForecast	Новое значение перечисления	Добавлена GOOGLE_DISPLAY_NETWORK в качестве целевой площадки для генерации спроса и повышения конверсии.
GenerateTrendingInsights	Новые поля	Добавлена ​​информация TrendInsights исторических линиях тренда в TrendInsightDataPoint при поиске по теме.
Отчеты
Уникальные показатели частоты использования пользователей	Новые поля	Добавлены новые метрики, показывающие, сколько пользователей видели вашу рекламу хотя бы два, три, четыре, пять или десять раз: unique_users_two_plus , unique_users_three_plus , unique_users_four_plus , unique_users_five_plus и unique_users_ten_plus .
SearchTermMatchSource	Новое значение перечисления	Добавлена VERTICAL_ADS_DATA_FEED для поддержки потоков данных по вертикальным рекламным кампаниям, например, для таргетинга по категориям туристической рекламы.
YouTubeVideoUpload
YouTubeVideoUpload	Новая услуга / ресурс	Добавлен сервис YouTubeVideoUpload для поддержки загрузки и управления видео на YouTube, а также ресурс YouTubeVideoUpload для поддержки получения статуса загрузки и метаданных. Эта функция поддерживается только для REST и клиентской библиотеки Python.

v23 (2026-01-28)

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

См. раздел «Обновление до последней версии» для получения инструкций.

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

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

Новые функции и обновления (не нарушающие критическую совместимость)

Функции и обновления	Тип	Описание
Реклама
AdFormatType	Новые значения перечисления	Добавлены новые типы форматирования: TEXT , VERTICAL_ADS_BOOKING_LINK и VERTICAL_ADS_PROMOTION .
Ресурсы
представление asset_group	Новые поля	Добавлены следующие метрики: metrics.engagements , metrics.engagement_rate и metrics.average_cpe .
представление asset_group_asset	Новые поля	Добавлены следующие метрики: metrics.average_cpe , metrics.average_cpm , metrics.trueview_average_cpv , metrics.video_trueview_view_rate , metrics.video_trueview_views и metrics.interaction_event_types .
Asset.orientation	Новое поле	К изображениям и видеофайлам добавлено поле ориентации только для чтения.
CampaignAsset	Новая функция	Добавлена ​​поддержка получения ресурсов кампании с field_type , установленным в значения HEADLINE и DESCRIPTION .
ServedAssetFieldType	Новые значения перечисления	Добавлены HEADLINE_AS_SITELINK_POSITION_ONE , HEADLINE_AS_SITELINK_POSITION_TWO , DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE и DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO для ресурсов, используемых в качестве ссылок на сайт.
BusinessMessageAsset	Новые функции / поддержка	Обновлены материалы для деловых сообщений: Добавлена ​​поддержка Facebook Messenger и Zalo в качестве провайдеров. Добавлены FACEBOOK_MESSENGER и ZALO в BusinessMessageProvider . Добавлены поля facebook_messenger_info и zalo_info . Добавлено CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS в AssetError .
Выставление счетов
InvoiceService.ListInvoices	Новые возможности	Теперь можно получать более подробную информацию в Invoice , включая разбивку затрат на уровне кампании, детализированные нормативные расходы и информацию о корректировках, установив параметр include_granular_level_invoice_details в ListInvoicesRequest .
RegulatoryFeeType UnitOfMeasure	Новые перечисления	Добавлены вспомогательные перечисления для обозначения регулирующих сборов и единиц измерения.
Кампании
CampaignError	Новые значения перечисления / ошибки	Добавлены коды ошибок DURATION_TOO_LONG_FOR_TOTAL_BUDGET и END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET .
Конверсии
Категория конверсииДействия	Новое значение перечисления	Добавлена ​​опция 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 (в потоке, в ленте, короткие ролики). Необходимо выбрать вместе с ad_network_type .
Отчетность Performance Max	Новая функция	Включена детализация по типам рекламных сетей для кампаний Performance Max.
UserLocationView GeographicView	Поддержка новых сегментов	Поддерживаются метрики, сегментированные по дате конверсии: conversions_by_conversion_date , all_conversions_by_conversion_date , conversions_value_by_conversion_date , all_conversions_value_by_conversion_date , value_per_conversions_by_conversion_date , value_per_all_conversions_by_conversion_date , cross_device_conversions_by_conversion_date и cross_device_conversions_value_by_conversion_date .
Вертикальные сегменты рекламы	Новые сегменты	Добавлены следующие сегменты: vertical_ads_event_participant_display_names , vertical_ads_hotel_class , vertical_ads_listing , vertical_ads_listing_brand , vertical_ads_listing_city , vertical_ads_listing_country , vertical_ads_listing_region , vertical_ads_partner_account и vertical_ads_vertical .
PerStoreView MatchedLocationInterestView	Новые ресурсы для составления отчетов	Добавлена PerStoreView для запроса информации о местоположении магазинов, а также MatchedLocationInterestView (для кампаний AI Max) для предоставления показателей эффективности по интересующим географическим местоположениям.
Покупки
ShoppingPerformanceView	Поддержка новых метрик	Теперь поддерживаются следующие метрики, сегментированные по дате конверсии: conversions_by_conversion_date , all_conversions_by_conversion_date , conversions_value_by_conversion_date , value_per_conversions_by_conversion_date и value_per_all_conversions_by_conversion_date .
ShoppingPerformanceView	Поддержка новых метрик	Добавлена ​​поддержка следующих параметров: search_budget_lost_impression_share , search_rank_lost_impression_share , search_budget_lost_absolute_top_impression_share и search_rank_lost_absolute_top_impression_share .
ShoppingProduct.product_image_uri	Новое поле	Добавлено в раздел ShoppingProduct .
Вертикальная реклама
AdGroup.vertical_ads_format_setting	Новое поле	Позволяет контролировать, какие форматы рекламы могут отображаться в поисковых кампаниях с использованием туристических фидов.
AdGroupCriterion SharedCriterion	Новые поля / критерии	Добавлен тип критерия vertical_ads_item_group_rule_list в AdGroupCriterion и vertical_ads_item_group_rule в SharedCriterion , что позволяет таргетировать группы товаров в поисковых кампаниях с туристическими фидами.
Интеграция потока данных вертикальной рекламы	Новая функция	Теперь можно подключить фид данных вертикальной рекламы к поисковой кампании, работающей под управлением AI Max, чтобы показывать рекламные объявления о недвижимости и ссылки на бронирование туристических услуг наряду с текстовыми объявлениями. Форматы можно контролировать с помощью параметра vertical_ads_format_setting , а правила — с помощью vertical_ads_item_group_rule . Доступна сегментация отчетов по AdFormatType и параметрам фида данных вертикальной рекламы.
Видео
AdVideoAssetInfo.ad_video_asset_feature_control	Новое поле	Добавлены параметры управления функциями для видеорекламы.
CampaignCriterionError	Новое значение перечисления / ошибка	Добавлен код ошибки INVALID_VIDEO_LINEUP_ID .
Показатели слышимости на YouTube	Новые показатели	Добавлены метрики слышимости для аудиорекламы на YouTube, позволяющие определить, была ли реклама слышимой и на каком количестве показов можно измерить слышимость.

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

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

v22.2 (24.06.2026)

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

Функции и обновления	Тип	Описание
Общий
Asset.synthetic_content_info Ad.synthetic_content_info	Новые поля	Содержит подтверждения для синтетического/сгенерированного ИИ контента, разделенные на advertiser_attestation (заявления, предоставленные непосредственно рекламодателем) и system_attestation (подтверждения, автоматически обнаруженные или предоставленные системами Google). Чтобы помочь вам спланировать предстоящую работу по интеграции для версии 25, интерфейс для изменения полей подтверждения рекламодателя будет представлен заранее для версий 22 и выше. Интерфейс доступен в этих версиях, но поля synthetic_content_info.advertiser_attestation.status и synthetic_content_info.advertiser_attestation.source останутся неизменяемыми для этих версий. При попытке изменить значение любого из этих полей будет возвращена одна из следующих ошибок: «Поле, которое пытались изменить, неизменяемо» или «Поле не может быть установлено». Начиная с версии 25, эти поля станут полностью изменяемыми. Мы рекомендуем использовать интерфейс уже сейчас для создания и тестирования вашей внутренней логики, чтобы ваша система была готова к полноценной записи данных после запуска версии 25.
Согласования от нескольких сторон	Новые функции	Бета-версия: Эта функция в настоящее время находится в стадии бета-тестирования и может быть изменена в будущих релизах. Добавлена ​​поддержка многосторонних согласований (MPA): Добавлен ресурс MultiPartyAuthReview и соответствующий MultiPartyAuthReviewService . Добавлено перечисление MultiPartyAuthReviewStatus для отслеживания статуса проверки. Добавлена CustomerUserAccess.pending_multi_party_auth_review для ссылки на ожидающую проверки. Добавлены MutateCustomerUserAccessResult.multi_party_auth_review и MutateCustomerUserAccessInvitationResult.multi_party_auth_review для возврата соответствующего имени ресурса для проверки. Добавлена MultiPartyAuthReviewError для обработки ошибок валидации.

v22.1 (2026-02-25)

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

Функции и обновления	Тип	Описание
Управление учетными записями
Customer.contains_eu_political_advertising	Новое поле	Получает информацию о статусе объявления на уровне учетной записи, указывающую, содержит ли она политическую рекламу, ориентированную на ЕС, и возвращает объект EuPoliticalAdvertisingStatus .
Кампании
Campaign.missing_eu_political_advertising_declaration	Новое поле	Поддерживает запросы и фильтрацию кампаний, в которых отсутствует информация о наличии политической рекламы, ориентированной на ЕС.

v22 (15.10.2025)

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

См. раздел «Обновление до последней версии» для получения инструкций.

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

Начальное состояние	Новый штат	Изменить тип	Руководство по внедрению
Генерация спроса
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros	minimum_budget_amount_micros	Переименование / исправление орфографических ошибок	Переименуйте ссылки, используя исправленное имя поля.
Общий
В AddBatchJobOperations нет ограничений на количество операций.	Ограничение на 10 000 операций на один запрос.	Изменение поведения	Убедитесь, что ни один запрос AddBatchJobOperations не содержит более 10 000 операций.
В запросе ListBatchJobResultsRequest размер страницы ограничен 1000 строками (без уведомления).	Возвращает ошибку INVALID_PAGE_SIZE	Изменение поведения	Убедитесь, что для ListBatchJobResultsRequest.page_size установлено значение 1000 или меньше, поскольку запрос страницы большего размера теперь приведет к ошибке.
Максимальная производительность
Метки показателей эффективности активов	Никто	Удаление	Поддержка меток эффективности активов и связанное с ними перечисление меток эффективности были удалены для кампаний Performance Max. Обновите интеграции соответствующим образом.
Campaign.url_expansion_opt_out	Флаг FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION в AssetAutomationSetting	Демонтаж / замена	Используйте окончательную настройку автоматизации текстовых ресурсов для расширения URL-адресов. Поле отказа от расширения URL-адресов на уровне кампании удалено.
Планирование
views	trueview_views	Демонтаж / замена	Замените ссылки на views новым полем trueview_views в ReachPlanService .
Видео
average_cpv video_view_rate video_views video_view_rate_in_feed video_view_rate_in_stream video_view_rate_shorts	trueview_average_cpv video_trueview_view_rate video_trueview_views video_trueview_view_rate_in_feed video_trueview_view_rate_in_stream video_trueview_view_rate_shorts	Переименования	Обновите строки запросов и интеграции, чтобы использовать новые названия метрик, представляющие просмотры видео в TrueView.

Новые функции и обновления (не нарушающие критическую совместимость)

Функции и обновления	Тип	Описание
Ресурсы
AssetFieldType.LANDING_PAGE_PREVIEW	Новое значение перечисления	Добавлено в качестве нового типа поля для графических ресурсов.
AssetGenerationService	Новый сервис (бета-версия)	Позволяет создавать текстовые и графические ресурсы с использованием генеративного искусственного интеллекта: GenerateText : Генерирует текст на основе конечного URL-адреса, подсказок, ключевых слов и т. д. GenerateImages : Генерирует изображения на основе конечного URL-адреса, подсказок или путем реконтекстуализации изображений товаров. В результате выполнения операции возвращаются коды ошибок из AssetGenerationError . Изначально эта функция была доступна только ограниченному числу участников закрытого бета-тестирования.
Кампании
AppCampaignBiddingStrategyGoalType	Новые значения перечисления	Добавлены новые цели для кампаний приложений по установке (ACi) для оптимизации без указания целевого показателя: OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA : Использовать со стандартной функцией «Максимизировать конверсии». OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS : Использовать со стандартной функцией «Максимизировать значение конверсии».
BiddingStrategyType	Новая функция	Добавлена ​​поддержка стратегии назначения ставок с фиксированной долей.
Campaign.feed_types	Новое поле	Отображает типы фидов, прикрепленных к кампании. Для кампаний Performance Max это может указывать на отрасль бизнеса, например, MERCHANT_CENTER_FEED для розничной торговли.
Нацеливание на общий набор	Новая функция	Разрешено прикреплять общие наборы минус-слов к многоканальным (для кампаний в приложениях) и локальным кампаниям.
Генерация спроса
Торги TargetCPC	Новая функция	Добавлена ​​стратегия назначения ставок для максимизации кликов по целевой цене за клик: целевая цена за клик устанавливается на уровне кампании с помощью Campaign.target_cpc , а переопределяется на уровне группы объявлений с помощью AdGroup.target_cpc_micros .
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES	Новое значение перечисления	Если эта опция включена для DemandGenMultiAssetAdInfo , она добавляет элементы дизайна и встраивает текстовые ресурсы в графические ресурсы для создания новых графических ресурсов с различными соотношениями сторон (включено по умолчанию).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS	Новое значение перечисления	Если параметр DemandGenMultiAssetAdInfo включен, он генерирует видеоролики с использованием других ресурсов, таких как изображения и текст, которые затем можно использовать для создания новых экземпляров DemandGenVideoResponsiveAdInfo (включено по умолчанию).
Общий
ListBatchJobResultsRequest размер страницы резервный	Изменение поведения	Если page_size не задан или равен 0, теперь по умолчанию устанавливается максимальное значение 1000 (ранее возвращалось INVALID_PAGE_SIZE ).
QuotaError	Новое значение перечисления / ошибка	Добавлена PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED , указывающая на превышение лимита скорости активации платежных профилей.
Максимальная производительность
Настройки автоматизации активов	Новые значения перечисления	Добавлены новые параметры автоматизации управления активами в PMax: GENERATE_IMAGE_ENHANCEMENT : Включает автоматическое создание улучшенных изображений (автоматическую обрезку). Включено по умолчанию. GENERATE_IMAGE_EXTRACTION : Изображения берутся из конечных URL-адресов. По умолчанию используется значение, заданное в настройках динамического расширения изображений учетной записи.
Сегменты отчетности PMax	Новые сегменты	Добавлены новые сегменты, уникальные для кампаний Performance Max: ad_using_product_data : Указывает, использует ли объявление данные о товарах из Google Merchant Center. ad_using_video : Указывает, использует ли реклама видеоматериал.
Планирование
Списки данных партнеров CRM	Новая функция / значение перечисления	Added THIRD_PARTY_PARTNER_DATA to CRM data sources, along with partner audience validation error codes (such as tos acceptance, Link missing, etc.).
Livestream creator metrics	Новое поле	Added YouTubeMetrics.is_active_live_stream_creator , returned by creator insights to indicate if a creator published a livestream in the past 90 days.
Plannable CRM source metadata	Новое сообщение	Added PlannableUserListMetadata inside PlannableUserList , returned by ReachPlanService.ListPlannableUserLists , to show CRM data source types.
Support for related videos and creators in TrendInsight	Новые поля	Added support for related_videos and related_creators on TrendInsight , and watch properties in video_properties and publish_date .
InsightsFinder improvements	Новая функция	GenerateInsightsFinderReport now supports parental_status , income_ranges , and more complex AND/OR targeting combinations.
Отчеты
New click types	Новые значения перечисления	Added CLICK_TO_MESSAGE_THIRD_PARTY_CLICK and CLICK_TO_MESSAGE_LANDING_PAGE_CLICK .
AssetGroupAsset segmentation	New segments support	AssetGroupAsset is now segmentable by device , conversion_action , conversion_action_name , and conversion_action_category .
RSAs in AdGroupAdAssetView	New feature / metrics support	AdGroupAdAssetView now fully supports performance and conversion metrics for RESPONSIVE_SEARCH_AD (previously only impressions were returned).
Exploration query cluster metric segmentations	New segments support	Metrics clicks_unique_query_clusters , conversions_unique_query_clusters , and impressions_unique_query_clusters are now segmentable by date fields.
TargetingExpansionView	New reporting resource	Added TargetingExpansionView to report metrics for expansions over manual targeting, such as keywordless expansion for AI Max for Search Campaigns.
Покупки
Shopping scope fix	Исправлена ​​ошибка	Fixed the campaign and ad group scoping of metrics in the ShoppingProduct resource.
Unified goals
Retention goals	Новая функция	Added support for customer retention goals to optimize for re-engaging existing customers (eg, using target_option with TARGET_SPECIFIC or TARGET_ALL ).
Видео
Video watch time metrics	Новые поля	Added watch time duration metrics: video_watch_time_duration_millis (total duration) and average_video_watch_time_duration_millis (average duration per impression).

Archived release notes

See Sunsetted versions for archived release notes.