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

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 .
  • Добавлен VERTICAL_ADS_DATA_FEED в SearchTermMatchSourceEnum для поддержки потоков данных по вертикальным рекламным объявлениям (например, таргетинг по сегментам туристической рекламы).

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 и AdGroupAdAssetCombinationView поддерживают метрики показов, эффективности и конверсии для 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 при повышении конверсии импорта лидов.

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

  • Добавлен код ошибки CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM . В будущем эта ошибка будет возвращаться при попытке установить очень низкий бюджет для кампании генерации спроса. Подробную информацию о требуемом минимальном бюджете можно найти в новом поле сведений об ошибке budgetDailyMinimumErrorDetails .

Изменения в политической рекламе в ЕС

Эти изменения в политике рекламы ЕС также были внесены в версии 19.2 и 20.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 для поисковых запросов.

  • Добавлено значение 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 .

  • В методе AudienceInsightsService.GenerateTargetingSuggestionMetrics обновлен тип ввода аудитории до InsightsAudience . Новый тип ввода аудитории позволяет комбинировать интересы пользователей с помощью операторов И-ИЛИ, что поддерживает потенциальные показатели охвата для более персонализированного определения аудитории.

  • В TrendInsightMetrics добавлена ​​функция отображения доли аудитории для тренда.

  • Добавлены новые связанные категории в KnowledgeGraphAttributeMetadata , позволяющие пользователям фильтровать атрибуты графа знаний по категориям.

Отчеты

  • Для AssetGroupAsset , ChannelAggregateAssetView и CampaignAggregateAssetView теперь доступен ряд новых метрик. Кроме того, для ChannelAggregateAssetView и CampaignAggregateAssetView impressions , которое ранее обнулялось для кампаний Performance Max, теперь будет отображать свое истинное значение.

  • Теперь ресурс 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 для сегментов, который можно выбрать в представлении ключевых слов.

  • Добавлена ​​поддержка метрик для уникальных кластеров намерений запросов с использованием:

  • В сегментацию click_view добавлен новый тип клика VEHICLE_ASSETS для отслеживания и составления отчетов о кликах, связанных с форматами объявлений, специфичными для транспортных средств.

Видео

v20.2 (2026-02-25)

В версии 20.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.