v22 (15.10.2025)
В версии 22 были добавлены следующие новые функции и обновления.
Инструкции см. в разделе Обновление до последней версии .
Ресурсы
-  Добавлен LANDING_PAGE_PREVIEWкак новый тип поля актива изображения.
-  Представлен AssetGenerationService(бета-версия):- Этот сервис позволяет генерировать текстовые и графические ресурсы с помощью генеративного ИИ. Изначально сервис доступен только ограниченному кругу участников закрытого бета-тестирования.
-  GenerateText: генерирует текст на основе входных данных, таких как конечный URL, запросы свободной формы, ключевые слова и существующий контекст кампании.
-  GenerateImages: создает изображения на основе таких входных данных, как конечный URL, запросы свободной формы, существующий контекст кампании или путем реконтекстуализации существующих изображений продукта.
-  Ошибки во время генерации активов возвращаются с кодами из AssetGenerationErrorEnum.
 
Кампании
-  Добавлены новые цели ставок для кампаний приложений, ориентированных на установку (ACi), для оптимизации без указания цели. Это полезно для быстрого масштабирования или в случаях, когда сложно определить правильную цель. В AppCampaignBiddingStrategyGoalType:-  OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: использовать со стандартной функцией «Максимизировать конверсии» .
-  OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: использовать со стандартной функцией «Максимизировать ценность конверсии» .
 
-  
- Добавлена поддержка типа стратегии «Фиксированная доля голосовых ставок» .
-  Добавлен Campaign.feed_types, показывающий типы фидов, привязанных к кампании. Для кампаний с максимальной эффективностью это может указывать на вертикаль бизнеса, например,MERCHANT_CENTER_FEEDдля розничной торговли.
-  Разрешено прикреплять общие наборы NEGATIVE_KEYWORDSк кампаниямMULTI_CHANNEL(для кампаний приложений) иLOCAL.
Генерация спроса
-  Добавлена стратегия назначения ставок TargetCPC для кампаний Demand Gen. Эта стратегия устанавливает ставки для максимального количества кликов по заданной целевой цене за клик (CPC).-  Установите целевую цену за клик на уровне кампании с помощью Campaign.target_cpc.
-  Переопределить на уровне группы объявлений с помощью AdGroup.target_cpc_micros.
 
-  Установите целевую цену за клик на уровне кампании с помощью 
-  Добавлен новый AssetAutomationType:-  GENERATE_DESIGN_VERSIONS_FOR_IMAGES: доступно дляDemandGenMultiAssetAds. При включении добавляет элементы дизайна и встраивает текстовые ресурсы в изображения для создания новых изображений с различными соотношениями сторон. НовыеDemandGenMultiAssetAdsвключены по умолчанию.
 
-  
-  Добавлен новый AssetAutomationType:-  GENERATE_VIDEOS_FROM_OTHER_ASSETS: доступно дляDemandGenMultiAssetAds. При включении функция генерирует видео с использованием других ресурсов, таких как изображения и текст. Эти видео затем можно использовать для создания новыхDemandGenVideoResponsiveAds. НовыеDemandGenMultiAssetAdsвключены по умолчанию.
 
-  
-  Поле BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_microsпереименовано вminimum_budget_amount_micros.
Общий
-  Добавлен лимит в 10 000 операций на запрос AddBatchJobOperations.
-  Обновлена обработка поля page_sizeвListBatchJobResultsRequest:-  Если page_sizeне установлен или равен 0, теперь по умолчанию используется максимальное значение 1000 (ранее возвращалосьINVALID_PAGE_SIZE).
-  Если page_sizeпревышает 1000, API теперь возвращает ошибкуINVALID_PAGE_SIZE(ранее она была ограничена значением 1000).
 
-  Если 
-  Добавлен новый код ошибки: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED, указывающий на превышение лимита ставок активации платежного профиля.
Максимальная производительность
-  Добавлены новые значения AssetAutomationTypeдля кампаний Performance Max:-  GENERATE_IMAGE_ENHANCEMENT: включает автоматическое создание улучшенных изображений, например, с функцией автоматической обрезки. Включено по умолчанию.
-  GENERATE_IMAGE_EXTRACTION: включает автоматический поиск изображений по конечным URL-адресам. По умолчанию используется настройка расширения динамических изображений на уровне аккаунта.
 
-  
-  Удален AssetPerformanceLabelдля кампаний с максимальной эффективностью.
-  Функциональность удаленного Campaign.url_expansion_opt_outтеперь управляется настройкойAssetAutomationTypeFINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATIONвAssetAutomationSetting.
-  Добавлены новые сегменты для кампаний с максимальной эффективностью. Каждый из этих сегментов доступен только для кампаний с максимальной эффективностью и не будет возвращать данные при выборе любого другого типа кампании.-  ad_using_product_data: указывает, использует ли объявление данные о товарах из фида Google Merchant Center.
-  ad_using_video: Указывает, использует ли объявление видеоактив.
 
-  
Планирование
-  В UserListCrmDataSourceTypeдобавлено значениеTHIRD_PARTY_PARTNER_DATA.
-  Добавлены новые коды ошибок, связанные с партнерскими аудиториями:-  PARTNER_AUDIENCE_SOURCE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
-  PARTNER_AUDIENCE_TYPE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
-  COMMERCE_PARTNER_NOT_ALLOWED
-  PARTNER_AUDIENCE_INFO_NOT_SUPPORTED_FOR_USER_LIST_TYPE
-  PARTNER_MANAGER_ACCOUNT_DISALLOWED
-  PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
-  ADVERTISER_TOS_NOT_ACCEPTED
-  ADVERTISER_PARTNER_LINK_MISSING
-  ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
-  ACCOUNT_SETTING_TYPE_NOT_ALLOWED_FOR_USER_LIST_TYPE
-  INVALID_CAMPAIGN_TYPE_FOR_THIRD_PARTY_PARTNER_DATA_LIST
 
-  
-  Добавлен is_active_live_stream_creatorвYouTubeMetrics. Этот параметр возвращается функциейContentCreatorInsightsService.GenerateCreatorInsightsи указывает, публиковал ли создатель прямую трансляцию в течение последних 90 дней.
- Добавлено новое сообщение - PlannableUserListMetadata, содержащее- UserListCrmDataSourceTypeв- PlannableUserList. Это сообщение возвращается функцией ReachPlanService.ListPlannableUserLists, чтобы показать, является ли источник данных списка пользователей CRM- FIRST_PARTYили- THIRD_PARTY_PARTNER_DATA.
- В - ReachPlanServiceдобавлено поле- trueview_views, которое заменяет поле- views.
- В - TrendInsightдобавлена поддержка- related_videosи- related_creators. Также добавлены метаданные свойств видео и даты публикации в- YouTubeVideoAttributeMetadata.video_propertiesи- YouTubeVideoAttributeMetadata.publish_date.
- AudienceInsightsService.GenerateInsightsFinderReportтеперь поддерживает- parental_statusи- income_ranges, а также более сложные комбинации И/ИЛИ тем и аудиторий.
Отчеты
-  Добавлены два новых типа кликов: CLICK_TO_MESSAGE_THIRD_PARTY_CLICKиCLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
-  AssetGroupAssetтеперь можно сегментировать поdevice,conversion_action,conversion_action_nameиconversion_action_category.
-  AdGroupAdAssetViewиAdGroupAdAssetCombinationViewтеперь полностью поддерживают показатели эффективности и конверсии дляRESPONSIVE_SEARCH_AD. Ранее в этих представлениях для этого типа объявлений возвращались только показы.
-  Для упрощения исследования интеллектуальных ставок следующие показатели теперь можно сегментировать по полям даты ( date,month,quarter,week,year):
-  Добавлен новый ресурс: TargetingExpansionView, который предоставляет данные по метрикам расширений по сравнению с ручным таргетингом, например, по расширению без ключевых слов для AI Max for Search Campaigns.
- Добавлены новые сегменты для кампаний PMax. См. обновления Performance Max . - Покупки
- Исправлено определение области действия метрик кампании и группы объявлений в ресурсе - ShoppingProduct.
Единые цели
-  Добавлена поддержка целей удержания клиентов для оптимизации повторного привлечения существующих клиентов.-  Настройте таргетинг с помощью CampaignRetentionGoalSettings.target_option:-  TARGET_SPECIFIC: Использует только пользователей из списков пользователей, связанных с кампанией. (В настоящее время только из разрешенного списка).
-  TARGET_ALL(по умолчанию): нацелен на всех пользователей для повторного вовлечения.
 
-  
 
-  Настройте таргетинг с помощью 
Видео
-  Переименованы несколько метрик, связанных с просмотрами видео:-  average_cpvтеперьtrueview_average_cpv
-  video_view_rateтеперьvideo_trueview_view_rate
-  video_viewsтеперьvideo_trueview_views
-  video_view_rate_in_feedтеперьvideo_trueview_view_rate_in_feed
-  video_view_rate_in_streamтеперьvideo_trueview_view_rate_in_stream
-  video_view_rate_shortsтеперьvideo_trueview_view_rate_shorts
 
-  
-  Добавлены метрики для времени просмотра видеорекламы:-  video_watch_time_duration_millis: Общее время просмотра.
-  average_video_watch_time_duration_millis: Среднее время просмотра на показ.
 
-  
v21 (06.08.2025)
Инструкции см. в разделе Обновление до последней версии .
AI Max для поисковых кампаний
- Теперь вы можете использовать поле - ai_max_setting.enable_ai_maxв- Campaignдля включения AI Max for Search кампаний. AI Max for Search кампании расширяют охват поисковой кампании за счет сопоставления поисковых запросов и позволяют контролировать, будут ли отображаться элементы управления таргетингом и креативами при их установке. Элементы управления автоматизацией текстовых ресурсов и списком брендов, установленные в запросах предыдущей версии, будут по-прежнему учитываться до тех пор, пока AI Max for Search кампании не будут явно отключены.- Campaign.ai_max_setting.bundling_requiredможно использовать для определения того, нужно ли включать AI Max for Search кампании для соблюдения или изменения автоматизации текстовых ресурсов и элементов управления списком брендов.- AdGroup.ai_max_ad_group_setting.disable_search_term_matchingможно использовать для отключения сопоставления поисковых запросов, если в родительской кампании включены кампании AI Max for Search. См. публикацию в нашем блоге Откройте для себя новый уровень эффективности с помощью кампаний AI Max for Search .
- Добавлена - CampaignError.AI_MAX_MUST_BE_ENABLED, которая возникает для кампаний в поисковой сети, если вы выбираете- FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATIONбез включения AI Max для кампаний в поисковой сети.
- Добавлена поддержка применения настроек таргетинга на уровне группы объявлений в кампаниях AI Max for Search. Теперь вы можете добавлять следующие критерии к группам объявлений: - Списки брендов
- Места
- Веб-страницы (правила URL)
 
- Добавлено представление - ai_max_search_term_ad_combination_viewдля отчёта об эффективности комбинаций поисковых запросов, заголовков и целевых страниц. Это представление показывает, какие поисковые запросы запускали показ ваших объявлений и как эти комбинации были эффективны. В будущем выпуске будет добавлено дополнительное представление, которое также будет включать данные по максимальной эффективности. Если вы не хотите переносить свою реализацию для получения данных по максимальной эффективности, дождитесь этого выпуска.
- Добавлено - AI_MAXв качестве нового значения для сегмента- search_term_match_type.
Ресурсы
- Добавлены поля - terms_and_conditions_text,- terms_and_conditions_uri,- promotion_barcode_infoи- promotion_qr_code_infoв- PromotionAsset. Поля штрихкода и QR-кода находятся в атрибуте- promotion_triggeroneof . См. статью Справочного центра «Об активах для продвижения» .
- Добавлен - FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATIONв- AssetAutomationTypeEnum. С помощью этого параметра вы можете управлять автоматической генерацией текстовых ресурсов и целевых страниц из конечного URL в поисковых кампаниях.
- Добавлен новый сервис - AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAssetдля удаления автоматически созданных ресурсов из- Campaign. Этот сервис поддерживает удаление только ресурса расширения конечного URL.
- Добавлен - DESCRIPTION_PREFIXв перечисление- ServedAssetFieldType. Это устраняет проблему, из-за которой- served_asset_field_typeв- ad_group_ad_asset_combination_viewбыл- UNKNOWNдля активов, служивших префиксом описания.
Кампании
- Добавлено новое значение перечисления - MISSING_LOCATION_TARGETINGв- CampaignPrimaryStatusReason. Эта новая причина статуса будет возвращаться только для кампаний с ограничением по местоположению, в которых не указан таргетинг по местоположению. В кампаниях с ограничением по местоположению любая попытка добавить таргетинг по местоположению за пределами разрешенной области приведет к ошибке критерия- LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN.
- Добавлена поддержка сторонних интеграционных партнёров на уровнях - VideoCustomer.third_party_integration_partnersи Campaign.third_party_integration_partners . См. статью Справочного центра «Отслеживание конверсий в приложениях с помощью аналитики сторонних приложений» .
- Теперь вы можете задать поле - advertising_partner_idsдля существующей- Campaign. Ранее это поле можно было задать только для новой кампании при её создании. После настройки поле остаётся неизменяемым.
- Используя общий список типа - TYPE_PLACEMENT_LIST, определенный на уровне учетной записи менеджера, рекламодатели теперь могут использовать критерии- CustomerNegativeCriterionдля исключения списка мест размещения в учетных записях клиентов отдельных рекламодателей.
- Добавлено - DESCRIPTION_PREFIXв перечисление- ServedAssetFieldType. Это устраняет проблему, из-за которой- served_asset_field_typeв- ad_group_ad_asset_combination_viewбыл- UNKNOWNдля активов, служивших префиксом описания.
- Добавлена поддержка поля - target_roas_tolerance_percent_millisв стратегиях назначения ставок- MaximizeConversionValueи- TargetRoas.- TargetRoas.target_roas_tolerance_percent_millisдоступен только для портфельных стратегий, которые, в свою очередь, доступны только для поисковых кампаний.
- Изменён код ошибки - ProductGroup. Для запросов с включённым частичным сбоем будет возвращаться- LISTING_GROUP_ERROR_IN_ANOTHER_OPERATIONвместо- INVALID_LISTING_GROUP_HIERARCHY.
- Добавлен новый ресурс - LocationInterestView, который суммирует эффективность критериев интереса к местоположению группы объявлений.
Конверсии
- Добавлено - ENGAGED_VIEWкак новое значение для сегмента- conversion_attribution_event_type.
- Клиенты больше не будут иметь доступа к режиму - debug_enabledв- ConversionUploadService. Это поле, если установлено в- TRUE, ранее использовалось для различения ошибок- CLICK_NOT_FOUNDи- SUCCESSдля расширенного отслеживания конверсий при импорте лидов.
Генерация спроса
-  Добавлен код ошибки CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM. В будущем эта ошибка будет возвращаться при попытке установить очень низкий размер бюджета для кампании Demand Gen. Подробную информацию о требуемом минимальном бюджете можно найти в новом поле сведений об ошибкеbudgetDailyMinimumErrorDetails.
Изменения в политической рекламе в ЕС
Эти изменения в политической рекламе ЕС также были внесены в версии v19.2 и v20.1 .
- Добавлено поле - Campaign.contains_eu_political_advertising. Это поле указывает, содержит ли ваша кампания политическую рекламу, ориентированную на Европейский союз. Если для этого поля задано значение- CONTAINS_EU_POLITICAL_ADVERTISING, кампания больше не будет работать в ЕС с 22 сентября 2025 года. Вызовы API для создания новой кампании завершится ошибкой- FieldError.REQUIRED, если это поле не задано.- Для любых существующих кампаний необходимо задать поле - contains_eu_political_advertising, прежде чем пытаться изменить таргетинг по близости, местоположению или группе местоположений как на уровне кампании, так и на уровне группы объявлений. Вызовы API для создания или обновления этих критериев кампании или группы объявлений для существующих кампаний завершится ошибкой- CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION, если кампания не завершила самодекларацию.- В версиях v19.x и 20.x требование заполнять это поле пока не действует, но станет обязательным в будущем. Об этом изменении будет объявлено заранее. 
- Trials and Experiments выдаст ошибку - ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION, если кампании эксперимента не указали самостоятельно, содержат ли они политическую рекламу, нацеленную на Европейский союз.
Максимальная производительность
- Для новых кампаний PMax значение - Campaign.brand_guidelines_enabledпо умолчанию теперь- true.
- Добавлен отчёт - campaign_search_term_view. В этом представлении представлены агрегированные показатели поисковых запросов на уровне кампании. Также в нём реализована поддержка кампаний «Максимальная эффективность» для поисковых запросов.
- Добавлено - PERFORMANCE_MAXв качестве нового значения для сегмента- search_term_match_type.
Планирование
- Добавлен новый метод - ReachPlanService.ListPlannableUserInterests, который позволяет рекламодателям определять интересы пользователей (сродства и целевые рынки), поддерживаемые- ReachPlanService.GenerateReachForecast. Метод поддерживает поиск по определённым типам интересов пользователей и запросы имён и путей.
- Добавлено - AdditionalApplicationInfoв- ReachPlanService.ListPlannableUserListsкак необязательное поле ввода.
- Добавлена поддержка - AudienceInsightsService.ListAudienceInsightsAttributesдля извлечения доступных списков пользователей 1P для идентификатора клиента, сделавшего запрос.
- Добавлена поддержка списков пользователей 1P в - AudienceInsightsService.GenerateAudienceCompositionInsightsдля получения аналитики по аудиториям, ориентированным на список пользователей. Любой запрос, ориентированный на список пользователей, вернет только индекс аудитории и доступен только для следующих параметров- AudienceInsightsDimension:- AGE_RANGE,- GENDER,- AFFINITY_USER_INTEREST,- IN_MARKET_USER_INTEREST.
- Обновлён тип данных аудитории на - InsightsAudienceдля- AudienceInsightsService.GenerateTargetingSuggestionMetrics. Новый тип данных аудитории позволяет комбинировать интересы пользователей по принципу «И-ИЛИ», поддерживая потенциальные метрики охвата для более точного определения аудитории.
- В - TrendInsightMetricsдобавлен показатель доли аудитории для получения информации о доле аудитории, соответствующей тренду.
- Добавлены новые связанные категории в - KnowledgeGraphAttributeMetadata, чтобы пользователи могли фильтровать атрибуты Knowledge Graph по категориям.
Отчеты
- Теперь для - AssetGroupAsset,- ChannelAggregateAssetViewи- CampaignAggregateAssetViewдоступен ряд новых метрик. Кроме того, для- ChannelAggregateAssetViewи- CampaignAggregateAssetView- impressions, который ранее обнулялся для кампаний с максимальной эффективностью, теперь будет отображать своё истинное значение.
- Ресурс - AssetSetтеперь можно выбирать с помощью- ChangeStatusчтобы пользователи могли получить больше информации о ресурсе типа- AssetSetили- CampaignAssetSetв одном запросе.
- Ресурс - CampaignAssetSetтеперь можно выбирать с помощью- ChangeStatusчтобы пользователи могли получить дополнительную информацию о ресурсе типа- AssetSetили- CampaignAssetSetв одном запросе.
- Добавлен новый сегмент - search_term_targeting_status, который можно выбрать в представлении поисковых запросов кампании.
- Добавлен новый - final_url_expansion_asset_view.
- Добавлена поддержка метрик - value_adjustmentи- all_value_adjustmentв отчете- AssetGroup.
- Сделано - AssetGroupAssetсегментируемым по- ad_network_type.
- Добавлен новый сегмент - landing_page_source, который можно использовать с ресурсом- landing_page_view.
- Добавлен новый сегмент - search_term_match_source, который можно выбрать в представлениях поискового запроса и поискового запроса кампании.
- Добавлен новый сегмент - match_type, который можно выбрать в представлении ключевых слов.
- Добавлена поддержка метрик для уникальных кластеров намерений запроса с: 
- Добавлен новый тип клика - VEHICLE_ASSETSв сегментацию- click_viewдля отслеживания и составления отчетов по кликам, связанным с форматами объявлений, относящимися к активам транспортных средств.
Исследование интеллектуальных ставок для стратегий целевой рентабельности инвестиций в рекламу в поиске
- Теперь вы можете включить Smart Bidding Exploration в поисковых кампаниях, установив поле - target_roas_tolerance_percent_millisв стратегиях назначения ставок- MaximizeConversionValueи- TargetRoasна любое значение, кратное 1000, в диапазоне от 10 000 (10%) до 30 000 (30%) включительно. Для стратегий назначения ставок- MaximizeConversionValueтакже потребуется задать поле- target_roas.- TargetRoas.target_roas_tolerance_percent_millisдоступен только для портфельных стратегий. См. публикацию в нашем блоге об Smart Bidding Exploration и статью в справочном центре.
- Агрегированная отчётность по разнообразию теперь поддерживается для следующих показателей для кластеров уникальных запросов. В интерфейсе Google Рекламы доступен сегментированный по времени просмотр. 
Видео
- Добавлен - YouTubeVideoListAsset. Также добавлен- Asset#youtube_video_list_asset, который можно использовать для создания связи между- campaignи типом- YouTubeVideoListAsset. См. статью Справочного центра « Использование похожих видео» .
- Добавлены новые поля метаданных в - YouTubeChannelInsightsи- YouTubeVideoAttributeMetadata.
- Открыты новые типы кликов: - VIDEO_RELATED_VIDEOS_CLICK,- VIDEO_CHANNEL_CLICKи- PRODUCT_ASSETS.
- Добавлено поле - allow_non_skippable_in_streamв- VideoAdInventoryControl, позволяющее использовать адаптивные видеообъявления в качестве in-stream-объявлений без возможности пропуска. Эта опция доступна для кампаний, поддерживающих сочетание формата без возможности пропуска с другими форматами.
- Добавлены поля - Campaign.VideoCampaignSettings.video_ad_sequenceи- AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting(только для чтения). См. статью Справочного центра «О последовательном показе видеорекламы» .
- Добавлены новые поля метаданных в - YouTubeChannelInsightsи- YouTubeVideoAttributeMetadata.
- Добавлены тип критерия - VIDEO_LINEUPи поле- video_lineupв- CampaignCriterionи- AdGroupCriterion. Эта функция доступна только для аккаунтов из белого списка. За подробностями обращайтесь к своему представителю отдела развития бизнеса Google.
- Добавлен отчёт о пригодности контента как для детализации , так и для группового уровня. См. статью в Справочном центре «Об отчёте о пригодности контента» . 
v20.1 (06.08.2025)
Эти изменения в политической рекламе ЕС также были внесены в версии v19.2 и v21 .
Изменения в политической рекламе в ЕС
- Добавлено поле - Campaign.contains_eu_political_advertising. Это поле указывает, содержит ли ваша кампания политическую рекламу, ориентированную на Европейский союз. Если в этом поле указано значение- CONTAINS_EU_POLITICAL_ADVERTISING, кампания не будет работать в ЕС с 22 сентября 2025 года.- Для любых существующих кампаний необходимо задать поле - contains_eu_political_advertising, прежде чем пытаться изменить таргетинг по близости, местоположению или группе местоположений как на уровне кампании, так и на уровне группы объявлений. Вызовы API для создания или обновления этих критериев кампании или группы объявлений для существующих кампаний завершится ошибкой- CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION, если кампания не завершила самодекларацию.- В версиях v19.x и 20.x требование заполнять это поле пока не действует, но станет обязательным в будущем. Об этом изменении будет объявлено заранее. 
- Trials and Experiments выдаст ошибку - ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION, если кампании эксперимента не указали самостоятельно, содержат ли они политическую рекламу, нацеленную на Европейский союз.
v20 (04.06.2025)
В версии 20 были добавлены следующие новые функции и обновления.
Инструкции см. в разделе Обновление до последней версии .
Ресурсы
 Добавлено несколько новых показателей и столбцов сегментов для отчета asset_group .
Столбцы показателей
-  new_customer_lifetime_value
-  all_new_customer_lifetime_value
-  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
Сегментные столбцы
-  ad_network_type
-  conversion_action
-  conversion_action_name
-  conversion_action_category
-  external_conversion_source
-  conversion_attribution_event_type
-  conversion_adjustment
-  conversion_lag_bucket
-  conversion_or_adjustment_lag_bucket
-  new_versus_returning_customers
-  device
-  slot
Кампании
- Добавлена поддержка добавления и обновления минус-слов на уровне кампании для кампаний с максимальной эффективностью.
Конверсии
- Теперь вы можете обновить поле - google_ads_conversion_customerдля существующего клиента, чтобы включить отслеживание конверсий между аккаунтами или изменить его существующий родительский аккаунт отслеживания конверсий на другой управляющий аккаунт.
- Добавлено поле - ClickConversion.user_ip_address. Google Реклама не поддерживает сопоставление IP-адресов конечных пользователей в Европейской экономической зоне (ЕЭЗ), Великобритании (UK) и Швейцарии (CH). Добавьте логику, чтобы условно исключить предоставление IP-адресов пользователями из этих регионов. Обязательно предоставляйте пользователям чёткую и полную информацию о данных, которые вы собираете на своих сайтах, в приложениях и других ресурсах, и получайте их согласие, если это требуется законом или применимыми политиками Google. Подробнее см. на странице «Об импорте офлайн-конверсий» .
Генерация спроса
-  Добавлены новые значения в сегмент ad_network_type, которые позволяют сегментировать кампании Demand Gen по каналу:-  MAPS
-  GMAIL
-  DISCOVER
 
-  
-  Добавлены метрики для сопоставимых по платформам конверсий:-  platform_comparable_conversions_from_interactions_rate
-  platform_comparable_conversions
-  platform_comparable_conversions_value
-  platform_comparable_conversions_value_per_cost
-  platform_comparable_conversions_by_conversion_date
-  platform_comparable_conversions_value_by_conversion_date
-  platform_comparable_conversions_from_interactions_value_per_interaction
-  cost_per_platform_comparable_conversion
-  value_per_platform_comparable_conversion
-  value_per_platform_comparable_conversions_by_conversion_date
-  cost_converted_currency_per_platform_comparable_conversion
 
-  
Рекомендации
-  Добавлена поддержка ShoppingSettingво время построения кампании при использованииGenerateRecommendationsRequest.
-  Добавлено поле merchant_center_account_idвGenerateRecommendationsRequestчтобы указать, когда следует генерировать рекомендации для розничной торговли, а не для стандартных кампаний Performance Max.
Планирование
-  Добавлен AudienceInsightsDimension.YOUTUBE_LINEUPдля заменыAudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUPвAudienceInsightsServiceиContentCreatorInsightsService. Этот новый параметр позволяет получать статистику и метаданные для подборок YouTube Select (YTS). Заменены объекты, связанные сYOUTUBE_DYNAMIC_LINEUP, такие какDynamicLineupAttributeMetadataиAudienceInsightsDynamicLineup, в соответствии с более широким удалением динамических подборок в Google Рекламе. Эта функция доступна только для аккаунтов из белого списка.
-  Добавлены AdditionalApplicationInfoиApplicationInstanceвAudienceInsightsService,ContentCreatorInsightsServiceиReachPlanService. Эта функция доступна только для учётных записей из разрешённого списка.
-  AudienceInsightsServiceиContentCreatorInsightsServiceобновлены для предоставления более подробной аналитики. Теперь вы можете сегментировать данные о создателях контента по устройствам, используя новые параметрыAudienceInsightsDimension.DEVICEиAudienceInsightsAttribute.deviceв обоих сервисах. Эта функция доступна только для учётных записей из белого списка.
-  В GenerateCreatorInsightsResponseдобавлены дополнительные агрегированные метрики видео для более полного анализа создателей контента:engagement_rate,average_views_per_video,average_likes_per_video,average_shares_per_video,average_comments_per_video,shorts_views_count,shorts_video_countиis_brand_connect_creator. Эта функция доступна только для учётных записей из белого списка.
-  Добавлен sub_country_locationsвGenerateCreatorInsightsRequestдляContentCreatorInsightsService. Это позволяет указывать географические регионы для уточнения поиска информации об авторах. Полеsub_country_locationsподдерживается только при использовании параметраsearch_attributesoneof в полеcriteria. Еслиsub_country_locationsуказан с другими типами критериев, запрос будет недействительным. Это обеспечивает более детальный географический таргетинг и анализ информации об авторах. Эта функция доступна только для учетных записей из белого списка.
-  Добавлен ReachPlanService.ListPlannableUserLists, который возвращает списки собственных пользователей, принадлежащих клиенту, а также добавленUserListInfoк параметрам таргетинга аудитории вGenerateReachForecastRequest. Это позволяет получать списки планируемых пользователей для конкретного клиента, а затем генерировать прогнозы охвата для кампаний, ориентированных на эти аудитории. Эти улучшения улучшают индивидуальное планирование охвата, включая данные о собственных пользователях непосредственно в прогнозирование. Прогнозирование охвата доступно только для учетных записей из белого списка.
Видео
-  Добавлены объявления AdFormatType.PAUSE, показываемые в органических видеороликах YouTube на телевизорах, что учитывается в отчётности. Эти объявления отображаются непосредственно рядом со статическим видеокадром на экране паузы. Это не относится к видеорекламе Demand Gen, показываемой на рекламной панели ниже или поверх приостановленного органического видео, что учитывается в отчётностиAdFormatType.INFEED.
v19.2 (06.08.2025)
Эти изменения в политической рекламе ЕС также были внесены в версии v20.1 и v21 .
Изменения в политической рекламе в ЕС
- Добавлено поле - Campaign.contains_eu_political_advertising. Это поле указывает, содержит ли ваша кампания политическую рекламу, ориентированную на Европейский союз. Если в этом поле указано значение- CONTAINS_EU_POLITICAL_ADVERTISING, кампания не будет работать в ЕС с 22 сентября 2025 года.- Для любых существующих кампаний необходимо задать поле - contains_eu_political_advertising, прежде чем пытаться изменить таргетинг по близости, местоположению или группе местоположений как на уровне кампании, так и на уровне группы объявлений. Вызовы API для создания или обновления этих критериев кампании или группы объявлений для существующих кампаний завершится ошибкой- CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION, если кампания не завершила самодекларацию.- В версиях v19.x и 20.x требование заполнять это поле пока не действует, но будет действовать в будущем. Дождитесь объявления об этом изменении. 
- Trials and Experiments выдаст ошибку - ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION, если кампании эксперимента не указали самостоятельно, содержат ли они политическую рекламу, нацеленную на Европейский союз.
v19.1 (16.04.2025)
В версии 19.1 были добавлены следующие функции и изменения.
Ресурсы
-  Добавлено поле asset_coverageдляAssetGroup, которое возвращает информацию о пробелах в вашей группе активов .-  Содержит подполе ad_strength_action_items, которое возвращает список действий, которые рекламодатель может предпринять для повышения эффективности рекламы группы активов.
 
-  Содержит подполе 
Кампании
-  Теперь вы можете оценивать лиды в кампаниях местных услуг или оставлять отзывы. В рамках этого изменения, версия 19.1-  Добавлен новый сервис LocalServicesLeadService. Вы можете использовать методProvideLeadFeedbackдля загрузки рейтинга и отзывов о лидах.
-  Добавлено новое поле lead_feedback_submittedвLocalServicesLead, которое поможет определить, был ли отправлен отзыв лиду.
 
-  Добавлен новый сервис 
-  Добавлен новый столбец показателей biddable_cohort_app_post_install_conversionsдля кампаний приложений.
Генерация спроса
- В службы планирования были введены дополнительные методы для поддержки Demand Gen.
- Добавлена поддержка управления каналами на уровне AdGroup для кампаний Demand Gen. Вы можете выбрать предопределенную общую группу каналов или подмножество каналов с помощью поля - demand_gen_ad_group_settings. В текущей версии поддерживаются следующие каналы :- YouTube In-Stream
- YouTube In-Feed
- YouTube Shorts
- Обнаружить
- Gmail
- Отображать
 
- Добавлен новый тип актива для - TALL_PORTRAIT_MARKETING_IMAGE. Этот тип актива относится к полю- tall_portrait_marketing_imagesформата Demand Gen Multi Asset Ad .
История изменений
-  Добавлена поддержка еще трех типов ресурсов в ChangeStatusResourceType :-  CAMPAIGN_BUDGET
-  ASSET_SET
-  CAMPAIGN_ASSET_SET
 
-  
-  Эти три более детализированных типа можно получить из отчета change_status.
Конверсии
- Теперь вы можете задать поле - google_ads_conversion_customerпри создании нового клиента через API Google Ads. Ранее это поле было доступно только для чтения.- ПРИМЕЧАНИЕ: Эта функция находится в закрытом списке разрешенных. Чтобы воспользоваться ею, обратитесь к своему менеджеру аккаунта. 
- Теперь при загрузке офлайн-конверсий можно указать тип клиента, связанного с конверсией. 
- Для - ClickConversionвведено новое поле- session_attributes.
Реклама местных услуг
-  Добавлен новый RPC ProvideLeadFeedbackвLocalServicesLeadServiceдля предоставления отзывов о качествеLocalServicesLead.
-  Добавлено новое поле lead_feedback_submittedв ресурсLocalServicesLead, которое подтверждает, был ли предоставлен отзыв для определенного ресурса.
Планирование услуг
-  Добавлена поддержка ежемесячных прогнозов целевой частоты в ReachPlanService.GenerateReachForecast.-  Разработчики могут задать TargetFrequencyTimeUnit.MONTHLYвTargetFrequencySettingsпри использовании планируемого кода продуктаTARGET_FREQUENCYдля создания прогноза ежемесячного охвата целевой частоты.
 
-  Разработчики могут задать 
-  Добавлен новый метод ReachPlanService.GenerateConversionRates, который позволяет рекламодателям запрашивать рекомендуемые коэффициенты конверсии для поддерживаемых планируемых продуктов.
-  Прогнозирование спроса в ReachPlanService.GenerateReachForecast:-  Разработчики теперь могут запрашивать прогнозы охвата для кампаний Demand Gen. Разработчики могут использовать новый планируемый код продукта DEMAND_GEN_MAX_CONVERSIONSдля создания прогнозов охвата Demand Gen.
-  Добавлено новое поле conversion_rate, позволяющее разработчикам, запрашивающим прогнозы охвата Demand Gen, предоставлять коэффициент конверсии. Предлагаемые коэффициенты конверсии можно получить с помощью нового методаReachPlanService.GenerateConversionRates. Это поле обязательно для запросов прогнозирования Demand Gen. Оно не поддерживается для других планируемых продуктов.
-  Добавлено новое поле conversionsдля возвращаемых прогнозов. Это поле содержит количество конверсий в заданной точке кривой охвата. Конверсии поддерживаются только для планируемого продуктаDEMAND_GEN_MAX_CONVERSIONS.
 
-  Разработчики теперь могут запрашивать прогнозы охвата для кампаний Demand Gen. Разработчики могут использовать новый планируемый код продукта 
Рекомендации
- Новое поле - ad_strengthдоступно для- ImprovePerformanceMaxAdStrengthRecommendation, которое возвращает текущий показатель силы объявления группы активов, связанной с рекомендацией.- Покупки
- Теперь вы можете переопределять исключения брендов для товарных объявлений в кампаниях с максимальной эффективностью. Это реализовано через новое поле - pmax_campaign_settingsна уровне кампании и работает только для кампаний PMax для розничной торговли . При попытке установить это поле для несовместимого типа кампании возникнет новая ошибка- CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED
Видео
-  Добавлена поддержка аудиорекламы только для чтения. Подробнее об этой функции см. в Справочном центре Google Рекламы . Это изменение раскрывает:-  Новый AdvertisingChannelSubTypeс названиемYOUTUBE_AUDIO.
-  Новый AdGroupTypeс именемYOUTUBE_AUDIO.
-  Новое перечисление форматов рекламы с именем YOUTUBE_AUDIO_ADи соответствующие ему поляYouTubeAudioAdInfo.
 
-  Новый 
-  Добавлены новые метрики и сегменты для запроса метрик охвата с корректировкой демо-версии. В рамках этих изменений-  Были введены два новых столбца показателей: coviewed_impressionsиprimary_impressions.
-  Были введены два новых сегмента: adjusted_age_rangeиadjusted_gender.
-  Если какой-либо из двух новых сегментов выбран вместе с полем метрики охвата ( coviewed_impressions,primary_impressions,unique_usersилиaverage_impression_frequency_per_user), необходимо также выбрать другой сегмент, чтобы получить допустимую статистику для этих столбцов.
- В настоящее время эта функция доступна только для клиентов из разрешенного списка.
 
-  Были введены два новых столбца показателей: 
v19 (26.02.2025)
В версии 19 были добавлены следующие функции и изменения.
Инструкции см. в разделе Обновление до последней версии .
Управление счетами
-  Added the following values to CustomerErrorto account for upcoming changes:-  CREATION_DENIED_FOR_POLICY_VIOLATION
-  CREATION_DENIED_INELIGIBLE_MCC
 
-  
Реклама
-  Added DemandGenMultiAssetAdInfo.tall_portrait_marketing_imagesto support portrait image assets with aspect ratio 9:16 in Demand Gen ads.
Ресурсы
-  (For allowlisted accounts only) Added support for message assets through Asset.business_message_asset,BusinessMessageAssetand the following enums and errors.- Enums:
 
-  Added AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEWto support automatically generating a landing page preview.
-  AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOSis now opted-in by default for Demand Gen video responsive ads .
-  (For allowlisted accounts only; allowlist is currently closed) Added Asset.app_deep_link_assetandAppDeepLinkAsset.
Конверсии
-  Цели конверсии-  LifecycleGoalValueSettings.high_lifetime_valueis out of beta and now mutable.
-  Added CustomerLifecycleGoal.owner_customerto show the resource name of the customer which owns the customer lifecycle goal.
 
-  
-  Deprecated ConversionActionType.SALESFORCE.
Ленты
-  Removed all feed-related entities, such as Feed,FeedMapping,FeedService,AdGroupFeed,feed_placeholder_view, etc. Users should now useassetsto achieve the same purpose.
Отель и путешествия
-  Made min_daysandmax_daysofValueRuleItineraryAdvanceBookingWindowanoptionalfield to allow specifying 0 as a value. This supports targeting for travel searches that happen today.
Максимальная производительность
-  (For allowlisted accounts only) Brand guidelines-  Made Campaign.brand_guidelines_enabledmutable only when creating a Performance Max campaign.
- This is incompatible with Performance Max for travel goals .
-  To enable brand guidelines for existing Performance Max campaigns, use a newly added CampaignService.EnablePMaxBrandGuidelines. Disabling brand guidelines is not supported.
-  Added Campaign.brand_guidelinesandBrandGuidelinesto allow setting the brand's colors and font family.
-  New error values:-  BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
-  BrandGuidelinesMigrationError
-  BRAND_GUIDELINES_ALREADY_ENABLED
-  CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
-  BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
-  CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
-  AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
-  TOO_MANY_ENABLE_OPERATIONS
 
-  
-  CampaignError
-  BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
-  BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
-  BRAND_GUIDELINES_COLOR_INVALID_FORMAT
-  BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
-  BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
-  CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
-  CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
 
-  Made 
-  Added AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOSto support automatically generating enhanced video assets for Performance Max campaigns.
Планирование
-  (For allowlisted accounts only) Added ContentCreatorInsightsService.GenerateTrendingInsightswhich allows users to see trending content topics on YouTube for given audience definitions.
-  Added GenerateCreatorInsightsRequest.country_locations[]to specify countries to search for the given criteria
-  Added GenerateCreatorInsightsRequest.search_brandto specify a brand to search for creators
-  Added new fields to YouTubeChannelInsightsto provide additional channel information forsearch_channelsrequests:-  channel_url
-  channel_description
-  top_videos
 
-  
-  Added new metadata fields to AudienceInsightsAttributeMetadata:-  youtube_video_metadata
-  user_interest_attribute_metadata
-  knowledge_graph_attribute_metadata
 
-  
Видео
-  Following the release of DataLinkService.CreateDataLink, we added the following methods to allow for mutating previously created data links:-  RemoveDataLinkfor removing data links in a Google Ads account
-  UpdateDataLinkfor accepting, rejecting and revoking data links in a Google Ads account
 
-  
-  Removed support for VIDEO_OUTSTREAMfrom the following enums:
Archived release notes
See Sunsetted versions for archived release notes.