Google выпустил 23-ю версию Google Ads API, это крупный релиз с десятками обновлений. Обновления включают данные отчетов с максимальной эффективностью с разбивкой по типам рекламных сетей, дополнительные стимулы, отчеты и элементы управления конверсиями, а также многое другое.
Google написал«Сегодня мы объявляем о выпуске Google Ads API v23. Это первый выпуск 2026 года и начало нашего перехода к более быстрой частоте выпуска».
До этого выпуска была версия 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, выпущенная в августе. Этой новой версии предшествовала версия 13.1, выпущенная в апреле 2023 года. Версия 12.0 была выпущена в октябре 2022 года, версия 11.0 Google Ads API была выпущена в июне, а версия 11.1 — в августе. Также версия 10.1 была выпущена 27 апреля 2022 года, а версия 10.0 — 9 февраля 2022 года. А Google прекратил работу API AdWords 27 апреля, который полностью перестанет работать в конце июля.
Вот примечания к выпуску:
Объявления:
- Добавлен AD_SHARING_NOT_ALLOWED в AdGroupAdErrorEnum. Эта ошибка возвращается при попытке совместного использования объявления несколькими группами объявлений, что больше не разрешено.
- В AdFormatType добавлены новые типы форматов: TEXT, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION.
- Удалена поддержка CallAd и CallAdInfo в версии 23. Посмотрите, чтобы узнать больше.
Ресурсы:
- В отчет assets_group добавлены дополнительные метрики: metrics.engagements, metrics.engagement_rate, metrics.average_cpe.
- В отчет assets_group_asset добавлены дополнительные метрики: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views, metrics.interaction_event_types
- Добавлена ориентация полей, доступных только для чтения, для изображений и видео в Asset.
- Добавлена поддержка получения CampaignAsset с полем HEADLINE и DESCRIPTION.
- Добавлены HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE и DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO в ServedAssetFieldType для объектов, служащих дополнительными ссылками.
- Обновленные ресурсы бизнес-сообщений
Биллинг:
- InvoiceService.ListInvoices теперь может возвращать более подробную информацию в Invoice, включая разбивку затрат на уровне кампании, детализированные нормативные расходы и информацию о корректировках, установив include_granular_level_invoice_details в ListInvoicesRequest.
- Добавлены RegulatoryFeeTypeEnum и UnitOfMeasureEnum.
Кампании:
- Добавлены коды ошибок CampaignError.DURATION_TOO_LONG_FOR_TOTAL_BUDGET и CampaignError.END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
- Добавлены Campaign.start_date_time и Campaign.end_date_time вместо Campaign.start_date и Campaign.end_date, что позволяет указывать компоненты времени для определенных типов кампаний.
Конверсии:
- В ConversionActionCategory добавлен YOUTUBE_FOLLOW_ON_VIEWS для поддержки отслеживания пользователей, которые смотрят рекламу, а затем смотрят видео с того же канала.
Общий спрос:
- Добавлено поле DemandGenVideoResponsiveAdInfo.companion_banner.
- Удалено поле lead_form_only из DemandGenMultiAssetAdInfo.
Стимулы:
- Добавлена поддержка стимулов «Выбери свой собственный» (CYO), позволяющая партнерам программно получать и применять стимулы Google Рекламы для своих клиентов:
- Метод FetchIncentive позволяет получить доступные стимулы для пользователя на основе страны, языка и, при необходимости, адреса электронной почты пользователя. Это может вернуть персонализированные варианты поощрений «Выбери свой» (CYO).
- Метод ApplyIncentive позволяет применить выбранный пользователем стимул к определенной учетной записи клиента Google Рекламы.
- Добавлен ресурс AppliedIncentive, доступный только для чтения, доступный для запросов через GoogleAdsService.Search и GoogleAdsService.SearchStream. В нем представлена подробная информация об использованных поощрениях, включая их статус, ход выполнения, суммы вознаграждений и соответствующие даты.
- Добавлены новые коды ошибок в IncentiveErrorEnum для решения проблем, связанных с получением или применением поощрений.
- Добавлен INVALID_EMAIL_ADDRESS в AuthenticationErrorEnum.
- Чтобы облегчить более детальную программную обработку сбоев, мы добавим дополнительные коды ошибок в IncentivesService в будущих выпусках. Мы рекомендуем вам следить за предстоящими объявлениями и примечаниями к выпуску на предмет этих новых кодов ошибок, чтобы убедиться, что ваши приложения могут справиться с этими новыми режимами сбоев.
Планирование:
- Добавлен LIFE_EVENT_USER_INTEREST в AudienceInsightsDimension. Это новое измерение позволяет пользователям создавать аудитории, используя события из жизни, следующими методами:
- Ответ ReachPlanService.GenerateConversionRates теперь включает поверхности, что позволяет предлагать различные коэффициенты конверсии на основе элементов управления поверхностью (например, Gmail, Shorts). Это поддерживается только для кампаний по формированию спроса.
- В YouTubeChannelInsights добавлен LanguageDistribution, обеспечивающий распределение языков в контенте канала YouTube.
- Добавлен сервис BenchmarksService для сравнения данных о рекламе на YouTube с отраслевыми показателями.
- Добавлен AudienceInsightsService.GenerateAudienceDefinition для перевода произвольного текстового описания целевой аудитории в соответствующие атрибуты аудитории с помощью генеративного искусственного интеллекта.
- Добавлен YouTubeChannelInsights.relevance_score, который оценивает, насколько автор соответствует теме, взвешенной по просмотрам.
- Добавлен TrendInsightMetrics.trend_change_percent, который представляет процентное изменение значения тренда за период сравнения.
Рекомендации:
- Добавлено поле is_new_customer в GenerateRecommendationsRequest. Если для рекомендаций типа CAMPAIGN_BUDGET установлено значение true, рекомендации создаются с использованием модели для новых клиентов. Это рекомендуется только для клиентов, у которых нет кампаний.
Отчеты:
- Метрики и сегментация: AdGroupAdAssetView и AdGroupAdAssetCombinationView теперь поддерживают показатели показов, эффективности и конверсий для RESPONSIVE_DISPLAY_AD.
- Метрики и сегментация: добавлен сегмент ad_sub_network_type для более детальной разбивки эффективности в рекламной сети. Первоначально это доступно для кампаний DemandGen на YouTube (In-Stream, In-Feed, Shorts). Этот сегмент необходимо выбрать вместе с ad_network_type.
- Метрики и сегментация: включена разбивка по типам рекламных сетей для кампаний с максимальной эффективностью.
- Метрики и сегментация: UserLocationView и GeographicView теперь поддерживают метрики, сегментированные по дате конверсии:
- Новые сегменты для вертикальной рекламы
- Новые представления: добавлен PerStoreView для запроса сведений о местоположении магазина. Добавлен MatchedLocationInterestView для кампаний AI Max, предоставляющий показатели эффективности с разбивкой по географическим местоположениям, к которым пользователи проявили интерес.
- Максимальная эффективность: включена разбивка по типам рекламных сетей для кампаний с максимальной эффективностью.
- Удаления: удалены совокупные показатели эффективности активов. Перечисление меток производительности больше не возвращается для поиска и отображения.
Шоппинг:
- ShoppingPerformanceView теперь поддерживает следующие показатели, сегментированные по дате конверсии: конверсии_по_конверсии_дате, all_conversions_by_conversion_date, конверсии_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.
Вертикальные объявления:
- В кампании AdGroup для поиска с использованием фидов путешествий добавлен параметрвертикальный_ads_format_setting, позволяющий контролировать, какие форматы объявлений могут показываться.
- В AdGroupCriterion добавлен тип критериявертикальный_ads_item_group_rule_list. Добавленвертикальный_ads_item_group_rule в SharedCriterion. Эти критерии позволяют настраивать таргетинг на группы товаров в поисковых кампаниях с помощью фидов о путешествиях.
- Теперь вы можете подключить фид данных вертикальных объявлений к поисковой кампании, в которой используется AI Max, чтобы она показывала объявления о рекламе недвижимости и ссылках на бронирование наряду с вашими текстовыми объявлениями. На уровне группы объявлений вы можете контролировать, какие форматы показывать, с помощью вертикального_ads_format_setting и определить набор правил группы элементов для таргетинга на подмножество ваших объектов из фида данных вертикальных объявлений. Кроме того, теперь отчеты можно сегментировать как по AdFormatType, так и по параметрам из фида данных вертикальных объявлений.
Видео:
- Добавлено поле AdVideoAssetInfo.ad_video_asset_feature_control.
- Добавлен код ошибки CampaignCriterionError.INVALID_VIDEO_LINEUP_ID.
- Добавлены показатели слышимости аудиообъявлений на YouTube, показывающие, слышно ли объявление и сколько показов можно измерить слышимость.
Обсуждение на форуме LinkedIn.
