Google Ads API Version 23.1 Теперь Доступна

от

Google недавно обновил Google Ads API до версии 23.1. Это небольшое обновление включает улучшения в управлении аккаунтами, кампаниями, конверсиями, стимулами, планированием и отчётностью.

Купил акции на все деньги, а они упали? А Илон Маск снова написал твит? Знакомо. У нас тут клуб тех, кто пытается понять этот цирк и не сойти с ума.

Купить на падении (нет)

Чтобы воспользоваться новейшими функциями в версии 23.1, вам необходимо обновить клиентские библиотеки и код Google Ads API. Мы уже опубликовали все обновленные ресурсы, включая примеры кода. Кроме того, мы выпускаем версии 20.2, 21.1 и 22.1 для дальнейшей поддержки Регламента ЕС о политической рекламе.

Вот история релизов Google Ads API. Текущая версия – 23, выпущенная в конце января. Предыдущие релизы включают версию 22 (15 октября 2025 г.), 21 (6 августа 2025 г.), 20 (5 июня 2025 г.), 19.1 (апрель 2025 г.), 19 (февраль 2025 г.), 18 (октябрь 2024 г.), 17.1 (август 2024 г.), 17.0 (июнь 2024 г.), 16.1 и 16 (февраль 2024 г.), 15 (октябрь 2023 г.), 14.1 (август 2023 г.), 13.1 и 13 (апрель и февраль 2023 г. соответственно), 12.0 (октябрь 2022 г.) и версии 11.1 и 11.0 (август и июнь 2022 г.). Версия 10.1 была выпущена 27 апреля 2022 г., а версия 10.0 – 9 февраля 2022 г. Наконец, старый AdWords API был прекращен и полностью перестанет функционировать в конце июля.

Вот примечания к выпуску:

Управление аккаунтом

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

Кампании

  • Добавлена поддержка текстовых инструкций, которые можно использовать с кампаниями Performance Max и Search для программного управления генерируемыми ИИ текстовыми активами.
  • Добавлено поле Campaign.text_guidelines в ресурс Campaign.
  • В text_guidelines можно определить term_exclusions и messaging_restrictions.
  • Добавлены 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 для поддержки запроса и фильтрации кампаний, в которых отсутствуют заявления о том, содержат ли они политическую рекламу, нацеленную на EU.

Преобразования

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

Общее

  • Добавлено CANNOT_TARGET_ONLY_UNDETERMINED в CriterionErrorEnum. Эта ошибка возвращается при попытке таргетировать только неопределенную категорию в демографических измерениях.

Стимулы

  • Добавлены два новых кода ошибок в IncentiveErrorEnum: MAX_INCENTIVES_REDEEMED и ACCOUNT_TOO_OLD. Эти ошибки могут быть возвращены для запросов, сделанных 11 марта 2026 года или после этой даты.

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

  • Добавлена поддержка разбивки по датам в GenerateBenchmarksMetrics с использованием BreakdownDefinition.
  • Добавлена GOOGLE_DISPLAY_NETWORK в качестве целевой поверхности для Demand Gen Max Conversions в ReachPlanService.GenerateReachForecast.
  • Добавлена информация о исторических трендах в TrendInsightDataPoint для TrendInsights в GenerateTrendingInsights при поиске по теме.

Отчёты

  • Добавлены новые метрики, которые показывают, сколько пользователей увидели вашу рекламу как минимум два, три, четыре, пять или десять раз: 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 для поддержки вертикальных рекламных каналов данных (например, таргетинг на сущность Travel Ads).

YouTubeVideoUpload

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

Смотрите также

2026-02-26 16:16