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

v24 (2026-04-22)

В версии 24 были добавлены следующие новые функции и обновления.

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

Реклама

Следующие поля теперь обязательны для заполнения:

Ресурсы

Кампании

  • Удалено поле Campaign.video_brand_safety_suitability . Этот параметр по-прежнему доступен на уровне клиента. См. Customer.video_brand_safety_suitability .
  • Добавлено поле Campaign.view_through_conversion_optimization_enabled , которое по умолчанию имеет false , позволяющее включать оптимизацию VTC (просмотр-конверсия) в кампаниях генерации спроса и кампаниях приложений.
  • Включена возможность исключения по полу для кампаний Performance Max. Эта опция теперь доступна для кампаний Performance Max во всех версиях Google Ads API.

Конверсии

  • Добавлена ​​поддержка типов конверсии для генерации лидов. В версии 24 это новые перечисления ConversionActionType :

    • GOOGLE_ANALYTICS_4_GENERATE_LEAD
    • GOOGLE_ANALYTICS_4_QUALIFY_LEAD
    • GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD
    • FIREBASE_ANDROID_GENERATE_LEAD
    • FIREBASE_ANDROID_QUALIFY_LEAD
    • FIREBASE_ANDROID_CLOSE_CONVERT_LEAD
    • FIREBASE_IOS_GENERATE_LEAD
    • FIREBASE_IOS_QUALIFY_LEAD
    • FIREBASE_IOS_CLOSE_CONVERT_LEAD

  • Удалена категория типа клиента из списка пользователей LOYALTY_SIGN_UPS .

Общий

  • Добавлена UserListErrorEnum.DUPLICATE_LOOKALIKE , которая возвращается при попытке создать похожий UserList , идентичный существующему.

Планирование

Отчеты

  • Удалён сегмент ad_sub_network_type для ресурса campaign_budget .
  • Удалён сегмент click_type из представлений AdGroupAsset , CampaignAsset и CustomerAsset .
  • Добавлен новый ресурс CartDataSalesView . Он позволяет сегментировать показатели конверсии не только по кликнутому товару, но и по проданному товару, используя сегменты, например, product_sold_brand .
  • Добавлены метрики, не требующие назначения ставок, — это метрики, которые также включают конверсии, на которые ваши кампании не ориентированы активно, например, all_cost_of_goods_sold_micros . Новые метрики добавляются ко всем ресурсам, поддерживающим соответствующие метрики, требующие назначения ставок.
  • Добавлен сегмент conversion_attribution_event_type в ресурс ShoppingPerformanceView .

Покупки

  • Добавлена ​​поддержка кампаний для приложений в ресурсе ShoppingProduct . Обратите внимание, что поля status и issues для кампаний для приложений не поддерживаются.
  • Внедрена фильтрация товаров по тегам с использованием логических выражений для торговых кампаний.
    • Добавлены типы критериев RETAIL_FILTER_BUNDLE и RETAIL_FILTER .
    • Добавлен тип SharedSetType RETAIL_FILTER .
    • Теперь AdGroupCriterion может использовать поле retail_filter_bundle для связи с SharedSet типа RETAIL_FILTER .
    • Теперь SharedCriterion может использовать поле retail_filter для определения отдельных правил или выражений тегов в рамках SharedSet .
    • Добавлено RETAIL в ListingGroupFilterListingSource .
    • Добавлен параметр RetailFilter в AssetGroupListingGroupFilter .
    • Добавлены новые коды ошибок в CriterionError и AssetGroupListingGroupFilterError для проверки данных.
    • Эта функция доступна только пользователям, включенным в список запрещенных.

Видео

v23.2 (2026-03-25)

В версии 23.2 были добавлены следующие новые функции и обновления.

Ресурсы

  • Добавлен ресурс VideoEnhancement , содержащий информацию о видеорекламе, специфичную для данного улучшения, например, сгенерирована ли она Google или предоставлена ​​рекламодателем. Подробнее см. в разделе «О видеоулучшениях» .
  • Добавлен ресурс AppTopCombinationView , доступный только для чтения, который предоставляет информацию о наиболее эффективных комбинациях элементов в кампаниях приложений.
  • Добавлена ​​поддержка получения 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 .
  • Теперь при попытке использовать упраздненную категорию типа клиента LOYALTY_SIGN_UPS в списке пользователей возникает ошибка.

Планирование

Отчеты

  • Добавлена ​​метрика biddable_indirect_install_first_in_app_conversion_micros в ресурсы Campaign , Customer и AdGroup .

Видео

  • Расширена поддержка предварительного просмотра в режиме реального времени на ShareablePreviewService путем установки preview_type в значение YOUTUBE_LIVE_PREVIEW . Добавлены UNSUPPORTED_AD_TYPE и TOO_MANY_RESOURCES_IN_REQUEST в класс ShareablePreviewError . Это поддерживается только для некоторых типов рекламы.

v23.1 (2026-02-25)

В версии 23.1 были добавлены следующие новые функции и обновления.

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

Управление учетными записями

  • Добавлен advertising_partner_properties.allowed_domain к ресурсам ProductLinkInvitation и ProductLink . Рекламный партнер сможет размещать рекламу только на этом домене.
  • В ресурс Customer добавлено поле contains_eu_political_advertising . Это поле извлекает статус объявления на уровне учетной записи, указывающий, содержит ли она политическую рекламу, ориентированную на ЕС, и возвращает объект EuPoliticalAdvertisingStatusEnum .

Кампании

  • Добавлена ​​поддержка текстовых направляющих, которые можно использовать с кампаниями Performance Max и Search для программного управления текстовыми элементами, генерируемыми ИИ.
  • Добавлены CampaignPrimaryStatusReason.CAMPAIGN_NOT_BOOKED , CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRING , CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRED и CampaignPrimaryStatusReason.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 года или позже.

Планирование

Отчеты

  • Добавлены новые метрики, показывающие, сколько пользователей видели вашу рекламу хотя бы два, три, четыре, пять или десять раз: unique_users_two_plus , unique_users_three_plus , unique_users_four_plus , unique_users_five_plus и unique_users_ten_plus .
  • В SearchTermMatchSourceEnum добавлен VERTICAL_ADS_DATA_FEED для поддержки потоков данных по вертикальным рекламным объявлениям, например, для таргетинга по категориям «Путешествия».

YouTubeVideoUpload

  • Добавлен сервис YouTubeVideoUpload для поддержки загрузки и управления видео на YouTube, а также ресурс YouTubeVideoUpload для поддержки получения статуса загрузки и метаданных. Эта функция поддерживается только для REST и клиентской библиотеки Python.

v23 (2026-01-28)

В версии 23 были добавлены следующие новые функции и обновления.

Реклама

  • В список AdGroupAdErrorEnum добавлена AD_SHARING_NOT_ALLOWED . Эта ошибка возвращается при попытке поделиться объявлением с несколькими группами объявлений, что больше не разрешено.
  • В AdFormatType добавлены новые типы форматирования: TEXT , VERTICAL_ADS_BOOKING_LINK , VERTICAL_ADS_PROMOTION .
  • В версии 23 удалена поддержка CallAd и CallAdInfo . Подробнее см. в разделе «О рекламных объявлениях» .

Ресурсы

Выставление счетов

  • Теперь InvoiceService.ListInvoices может возвращать более подробную информацию о счете Invoice включая разбивку затрат на уровне кампании, детализированные нормативные расходы и информацию о корректировках, установив include_granular_level_invoice_details в ListInvoicesRequest .
  • Добавлены RegulatoryFeeTypeEnum и UnitOfMeasureEnum .

Кампании

Конверсии

  • Добавлена ​​опция YOUTUBE_FOLLOW_ON_VIEWS в ConversionActionCategory для отслеживания пользователей, которые сначала смотрят рекламу, а затем видео с того же канала.

Генерация спроса

Стимулы

  • Добавлена ​​поддержка системы «Выбери сам» (Choose Your Own, CYO) , позволяющая партнерам программно получать и применять бонусы Google Ads для своих клиентов:

    • Добавлена IncentiveService :
      • Метод FetchIncentive позволяет получить список доступных бонусов для пользователя на основе страны, языка и, при необходимости, адреса электронной почты пользователя. Это может вернуть персонализированные варианты бонусов в формате «Выбери сам» (CYO).
      • Метод ApplyIncentive позволяет применять выбранное пользователем вознаграждение к конкретному аккаунту клиента Google Ads.
    • Добавлен ресурс только для чтения AppliedIncentive , доступный для поиска через GoogleAdsService.Search и GoogleAdsService.SearchStream . Он предоставляет подробную информацию об использованных бонусах, включая их статус, ход выполнения, суммы вознаграждений и соответствующие даты.
    • В IncentiveErrorEnum добавлены новые коды ошибок для обработки проблем, связанных с получением или применением вознаграждений.
    • Добавлено значение INVALID_EMAIL_ADDRESS в AuthenticationErrorEnum .

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

Планирование

Рекомендации

  • Добавлено поле is_new_customer в GenerateRecommendationsRequest . Если для рекомендаций типа CAMPAIGN_BUDGET установлено значение true , то генерируются рекомендации с использованием модели для новых клиентов. Это рекомендуется только для клиентов, у которых нет кампаний.

Отчеты

  • Метрики и сегментация

    • AdGroupAdAssetView теперь поддерживает метрики показов, эффективности и конверсии для RESPONSIVE_DISPLAY_AD .
    • Добавлен сегмент ad_sub_network_type для более детального анализа эффективности внутри рекламной сети. Первоначально он доступен для кампаний DemandGen на YouTube (в потоке, в ленте, короткие ролики). Этот сегмент необходимо выбрать вместе с ad_network_type .
    • Включена детализация по типам рекламных сетей для кампаний 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 .

  • Новые сегменты для вертикальной рекламы

  • Новые ракурсы:

    • Добавлена ​​возможность использования PerStoreView для запроса информации о местоположении магазина.
    • Добавлена MatchedLocationInterestView для кампаний AI Max, предоставляющая показатели эффективности с разбивкой по географическим местоположениям, в которых пользователи проявили интерес.

  • Максимальная производительность:

    • Включена детализация по типам рекламных сетей для кампаний Performance Max.

  • Перевозки:

    • Удалены агрегированные метрики производительности активов. Перечисление меток производительности больше не возвращается для поиска и отображения.

Покупки

  • Теперь ShoppingPerformanceView поддерживает следующие метрики, сегментированные по дате конверсии: 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 .
  • Теперь 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 .
  • Добавлен product_image_uri в ShoppingProduct .

Вертикальная реклама

  • Добавлен параметр vertical_ads_format_setting в AdGroup для поисковых кампаний, использующих туристические фиды, что позволяет контролировать, какие форматы объявлений могут отображаться.
  • Добавлен тип критерия vertical_ads_item_group_rule_list в AdGroupCriterion . Добавлен vertical_ads_item_group_rule в SharedCriterion . Эти критерии позволяют таргетировать группы товаров в поисковых кампаниях с туристическими фидами.
  • Теперь вы можете подключить фид данных вертикальной рекламы к поисковой кампании, работающей под управлением AI Max, чтобы она показывала рекламные объявления о недвижимости и ссылки на бронирование туристических услуг наряду с вашими текстовыми объявлениями. На уровне группы объявлений вы можете управлять форматами отображения с помощью параметра vertical_ads_format_setting и определять набор правил для групп элементов, чтобы ориентироваться на подмножество ваших объектов из фида данных вертикальной рекламы. Кроме того, отчеты теперь можно сегментировать как по AdFormatType , так и по параметрам из фида данных вертикальной рекламы.

Видео

v22.1 (2026-02-25)

В версии 22.1 добавлена ​​следующая новая функция.

Управление учетными записями

  • В ресурс Customer добавлено поле contains_eu_political_advertising . Это поле извлекает статус объявления на уровне учетной записи, указывающий, содержит ли она политическую рекламу, ориентированную на ЕС, и возвращает объект EuPoliticalAdvertisingStatusEnum .

Кампании

  • Добавлена Campaign.missing_eu_political_advertising_declaration для поддержки запросов и фильтрации кампаний, в которых отсутствуют заявления о наличии политической рекламы, ориентированной на ЕС.

v22 (15.10.2025)

В версии 22 были добавлены следующие новые функции и обновления.

Ресурсы

  • Добавлен новый тип поля для графических ресурсов — LANDING_PAGE_PREVIEW .
  • Представлен сервис AssetGenerationService (бета-версия):
    • Этот сервис позволяет создавать текстовые и графические материалы с использованием генеративного искусственного интеллекта. Первоначально этот сервис доступен только ограниченному числу участников закрытого бета-тестирования.
    • GenerateText : Генерирует текст на основе таких входных данных, как конечный URL-адрес, произвольные подсказки, ключевые слова и существующий контекст кампании.
    • GenerateImages : Генерирует изображения на основе таких входных данных, как конечный URL-адрес, произвольные подсказки, существующий контекст кампании или путем переосмысления существующих изображений товаров.
    • Ошибки, возникающие при генерации активов, возвращаются с кодами из AssetGenerationErrorEnum .

Кампании

Генерация спроса

  • Добавлена ​​стратегия назначения ставок TargetCPC для кампаний по генерации спроса. Эта стратегия устанавливает ставки для максимизации кликов при заданной целевой стоимости клика (CPC).
    • Установите целевую цену за клик (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 для кампаний Performance Max.
  • Функциональность удаленной функции Campaign.url_expansion_opt_out теперь управляется путем установки параметра AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION в AssetAutomationSetting .
  • Добавлены новые сегменты для кампаний Performance Max. Каждый из этих сегментов доступен только для кампаний Performance Max и не будет возвращать данные при выборе любого другого типа кампании.
    • ad_using_product_data : Указывает, использует ли объявление данные о товаре из фида Google Merchant Center.
    • ad_using_video : Указывает, использует ли реклама видеоматериал.

Планирование

Отчеты

Единые цели

  • Добавлена ​​поддержка целей по удержанию клиентов для оптимизации процесса повторного привлечения существующих клиентов.
    • Настройте таргетинг с помощью CampaignRetentionGoalSettings.target_option : * TARGET_SPECIFIC : Использует только пользователей из списков пользователей, связанных с кампанией. (В настоящее время только из разрешенных списков).
      • TARGET_ALL (По умолчанию): Нацеливает повторное взаимодействие со всеми пользователями.

Видео

v21.1 (2026-02-25)

В версии 21.1 добавлена ​​следующая новая функция.

Управление учетными записями

  • В ресурс Customer добавлено поле contains_eu_political_advertising . Это поле извлекает статус объявления на уровне учетной записи, указывающий, содержит ли она политическую рекламу, ориентированную на ЕС, и возвращает объект EuPoliticalAdvertisingStatusEnum .

Кампании

  • Добавлена Campaign.missing_eu_political_advertising_declaration для поддержки запросов и фильтрации кампаний, в которых отсутствуют заявления о наличии политической рекламы, ориентированной на ЕС.

v21 (06.08.2025)

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

AI Max для поисковых кампаний

  • Теперь вы можете использовать поле ai_max_setting.enable_ai_max в настройках Campaign , чтобы включить AI Max для поисковых кампаний. AI Max для поисковых кампаний расширяет охват поисковой кампании за счет сопоставления поисковых запросов и позволяет контролировать, будут ли отображаться настройки таргетинга и креативов, если они заданы. Автоматизация текстовых материалов и настройки списков брендов, заданные в предыдущих версиях, будут по-прежнему учитываться до тех пор, пока AI Max для поисковых кампаний не будет явно включен и выключен. Campaign.ai_max_setting.bundling_required можно использовать для определения того, должны ли быть включены кампании AI Max для поисковых кампаний, чтобы учитывать или изменять автоматизацию текстовых материалов и настройки списков брендов. AdGroup.ai_max_ad_group_setting.disable_search_term_matching можно использовать для отключения сопоставления поисковых запросов, если в родительской кампании включены кампании AI Max для поисковых кампаний. См. нашу статью в блоге «Раскройте потенциал нового уровня с помощью кампаний AI Max для поисковых кампаний» .

  • Добавлена 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 для отчета о производительности комбинаций поисковых запросов, заголовков и целевых страниц. Это представление показывает, какие поисковые запросы запускали ваши объявления и как показали себя эти конкретные комбинации. В будущих версиях будет добавлено дополнительное представление, которое также будет включать данные Performance Max. Если вы хотите избежать миграции вашей реализации для получения данных Performance Max, рассмотрите возможность ожидания этой версии.

  • Добавлено значение AI_MAX для сегмента search_term_match_type .

Ресурсы

  • В PromotionAsset добавлены поля terms_and_conditions_text , terms_and_conditions_uri , promotion_barcode_info и promotion_qr_code_info . Поля штрихкода и QR-кода находятся внутри свойства promotion_trigger . См. статью в Справочном центре «Об активах для продвижения» .

  • В AssetAutomationTypeEnum добавлен FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION . С помощью этого параметра можно управлять автоматической генерацией текстовых ресурсов и целевых страниц из конечного URL-адреса в поисковых кампаниях.

  • Добавлена ​​новая служба AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset для удаления автоматически созданных ресурсов из Campaign . Эта служба поддерживает удаление только ресурса, содержащего конечный URL-адрес.

  • Добавлен DESCRIPTION_PREFIX в перечисление ServedAssetFieldType . Это исправляет проблему, из-за которой параметр served_asset_field_type в ad_group_ad_asset_combination_view был UNKNOWN для активов, используемых в качестве префикса описания.

Кампании

  • В поле CampaignPrimaryStatusReason добавлено новое значение перечисления MISSING_LOCATION_TARGETING . Эта новая причина статуса будет возвращаться только для кампаний с ограничениями по местоположению, в которых не указан таргетинг по местоположению. Для кампаний с ограничениями по местоположению любая попытка добавить таргетинг по местоположению за пределами разрешенной области приведет к ошибке критерия LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN .

  • Добавлена ​​поддержка интеграции со сторонними партнерами на уровнях VideoCustomer.third_party_integration_partners и Campaign.third_party_integration_partners . См. статью в Справочном центре «Отслеживание конверсий приложения с помощью аналитики сторонних приложений» .

  • Теперь вы можете задать значение поля advertising_partner_ids для существующей Campaign . Ранее это поле можно было задать только для новой кампании при ее создании. После задания значение поля остается неизменяемым.

  • Используя общий список типа NEGATIVE_PLACEMENTS определенный на уровне учетной записи менеджера, рекламодатели теперь могут применять критерии 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 . Для запросов с включенной функцией частичного сбоя вместо INVALID_LISTING_GROUP_HIERARCHY будет возвращаться LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION .

  • Добавлен новый ресурс LocationInterestView , который суммирует показатели эффективности критериев интереса к местоположению в группах объявлений.

Конверсии

  • Добавлено значение ENGAGED_VIEW в качестве нового параметра для сегмента conversion_attribution_event_type .

  • Клиенты больше не будут иметь доступа к режиму debug_enabled в ConversionUploadService . Это поле, если оно установлено в TRUE , ранее использовалось для различения ошибки CLICK_NOT_FOUND от SUCCESS при повышении конверсии импорта лидов.

Генерация спроса

EU political advertising changes

These EU political advertising changes have also been made in the v19.2 and v20.1 releases.

  • Added Campaign.contains_eu_political_advertising . This field indicates whether your campaign contains political advertising content targeted towards the European Union. If this field is set to CONTAINS_EU_POLITICAL_ADVERTISING , the campaign will no longer serve in the EU starting September 22, 2025. API calls to create a new campaign will fail with a FieldError.REQUIRED error if this field is not set.

    For any existing campaigns, you should set the contains_eu_political_advertising field before attempting to change proximity, location, or location group targeting either at the campaign or ad group levels. The API calls to create or update these campaign or ad group criteria for existing campaigns will fail with a CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION error if the campaign hasn't completed the self-declaration.

    For versions v19.x and 20.x, the requirement to set this field is not yet enforced, but will be in the future. This change will be announced in advance.

  • Trials and Experiments will throw an ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION if the experiment's campaigns haven't self-declared whether they contain political advertising that targets the European Union.

Максимальная производительность

Планирование

Отчеты

Видео

v20.2 (2026-02-25)

The following new feature was added in v20.2.

Управление учетными записями

  • Added the contains_eu_political_advertising field to the Customer resource. This field retrieves the account-level declaration status of whether it contains political advertising targeted towards the EU, and returns an EuPoliticalAdvertisingStatusEnum .

Кампании

  • Added Campaign.missing_eu_political_advertising_declaration to support querying and filtering campaigns that are missing declarations about whether they contain political advertising targeted towards the EU.

v20.1 (2025-08-06)

These EU political advertising changes have also been made in the v19.2 and v21 releases.

EU political advertising changes

  • Added Campaign.contains_eu_political_advertising . This field indicates whether your campaign contains political advertising content targeted towards the European Union. If this field is set to CONTAINS_EU_POLITICAL_ADVERTISING , the campaign will no longer serve in the EU starting September 22, 2025.

    For any existing campaigns, you should set the contains_eu_political_advertising field before attempting to change proximity, location, or location group targeting either at the campaign or ad group levels. The API calls to create or update these campaign or ad group criteria for existing campaigns will fail with a CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION error if the campaign hasn't completed the self-declaration.

    For versions v19.x and 20.x, the requirement to set this field is not yet enforced, but will be in the future. This change will be announced in advance.

  • Trials and Experiments will throw an ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION if the experiment's campaigns haven't self-declared whether they contain political advertising that targets the European Union.

v20 (2025-06-04)

The following new features and updates were added in v20.

See Upgrade to the latest version for guidance.

Ресурсы

Added several new metrics and segment columns for the asset_group report.

Metrics columns

Segment columns

Кампании

Конверсии

  • You can now update the google_ads_conversion_customer field on an existing customer to opt in to cross-account conversion tracking, or to change its existing conversion tracking parent to a different manager account.

  • Added the ClickConversion.user_ip_address field. Google Ads does not support IP address matching for end users in the European Economic Area (EEA), United Kingdom (UK), or Switzerland (CH). Please add logic to conditionally exclude sharing IP addresses from users from these regions. Make sure that you provide users with clear and comprehensive information about the data you collect on your sites, apps, and other properties and get consent where required by law or any applicable Google policies. See the About offline conversion imports page for more details.

Генерация спроса

Рекомендации

  • Added support for ShoppingSetting during campaign construction when using GenerateRecommendationsRequest .
    • Added the merchant_center_account_id field to GenerateRecommendationsRequest to indicate when recommendations should be generated for retail, rather than the standard Performance Max campaigns.

Планирование

Видео

  • Added AdFormatType.PAUSE ads served on organic YouTube videos on TV screens, which is included in reporting. These ads are displayed directly next to the static video frame on the pause screen. This does not include Demand Gen video ads displayed on the ad panel below or on top of a paused organic video, which are reported under AdFormatType.INFEED .

Archived release notes

See Sunsetted versions for archived release notes.