Актуальный список текущих и запланированных изменений приведен в разделе Прекращение поддержки функций.
Основная версия 26
В Google Ads API версии 26 добавлены следующие новые функции, изменения и критические изменения.
Версия 26 (14.10.2026)
В Google Ads API версии 26, которая является крупным релизом, добавлены следующие новые функции, обновления и критические изменения.
Подробнее о том, как перейти на последнюю версию…
Критические изменения
| Начальное состояние | Новое состояние | Тип изменения | Советы по размещению рекламы |
|---|---|---|---|
| Кампании | |||
Необязательное поле country_code в LocalServicesPmaxCampaignSettings |
Обязательное поле при создании кампании с максимальной эффективностью для Местных услуг (LocalServicesPmaxCampaignSettings.country_code). |
Изменение поведения | При создании кампаний с максимальной эффективностью для местных услуг обязательно указывайте country_code (вместе с новым обязательным полем listing_id). |
| Конверсии | |||
Поле enhanced_conversions_for_leads_enabled в ConversionTrackingSetting (Customer.conversion_tracking_setting) |
Нет | Рубка | Чтобы проверить настройки расширенного отслеживания конверсий на уровне аккаунта, используйте ConversionTrackingSetting.enablement_setting на странице Customer.conversion_tracking_setting. |
| Таргетинг | |||
Поля критериев, относящиеся к гостиницам, в AdGroupBidModifier:
|
Поля критериев, не зависящие от вертикали, в AdGroupBidModifier:
|
Переименование или удаление | Обновите ссылки, чтобы использовать поля критериев, не зависящие от вертикали. Это позволит настраивать таргетинг на разные вертикали в сфере туризма, а не только на гостиницы (например, на Things to do). Идентификаторы критериев, поведение таргетинга и существующие модификаторы ставок останутся прежними. Значения min_nights и max_nights переносятся в min_days и max_days без изменений. |
HotelDateSelectionType и тип segments.user_set_dates |
DateSelectionType |
Переименование или изменение типа | Используйте DateSelectionType вместо HotelDateSelectionType. |
Причины ошибок, связанных с гостиницами, в CriterionError:
|
Причины ошибок, не зависящие от отрасли, в CriterionError:
|
Переименовать | Обновите обработку ошибок, чтобы проверять новые причины ошибок, не связанные с определенной отраслью. |
Функции и обновления (некритические)
| Функции и обновления | Тип | Описание |
|---|---|---|
| Объекты | ||
| Поставщики сообщений для компаний в LINE и SMS | Новые поля и значения перечисления | Добавлена поддержка LINE и SMS в качестве поставщиков сообщений в BusinessMessageAsset, включая новые поля BusinessMessageAsset.line_info и BusinessMessageAsset.sms_info, а также BusinessMessageProvider.LINE и BusinessMessageProvider.SMS. |
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY |
Новое значение enum / ошибка | Добавлено в AssetGroupError, чтобы указывать, когда категория, заданная в GoogleLocalServicesInfo (AssetGroup.google_local_services_info), не поддерживается в кампаниях с максимальной эффективностью для местных услуг. |
| Кампании | ||
| Как создать кампанию с максимальной эффективностью для местных услуг | Новые функции, поля и ошибки |
Обновлено поле Также добавлено поле |
| Ошибки проверки кампании Местных услуг | Новые значения перечисления и ошибки | Добавлены новые ошибки проверки для кампаний с местными услугами: |
| Проверка связи с аккаунтом Hotel Center | Новое значение enum или ошибка | В CampaignError добавлен код ошибки CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED, который указывает, что для связывания набора объектов гостиницы (Campaign.hotel_property_asset_set) с кампанией с максимальной эффективностью для целей туризма требуется активная связь с аккаунтом Hotel Center. |
| Минимальный дневной бюджет для кампаний для создания спроса | Новое поле | В CurrencyConstant добавлено поле demand_gen_info.minimum_budget_per_day_micros, в котором указывается минимальный дневной бюджет для кампаний для создания спроса в этой валюте. Значение этого поля обновляется, когда меняется минимальный бюджет, заданный API. |
| Конфигурация измерения роста для кампаний | Новое поле | Добавлено поле Campaign.lift_measurement_config, которое позволяет получить название ресурса для конфигурации оценки роста, связанной с кампанией. |
| Проверка экспериментов AI Max | Новое перечисляемое значение / ошибка | Добавлен код ошибки ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED в ExperimentArmError при попытке создать эксперимент ADOPT_AI_MAX для кампании, в которой уже включены функции AI Max (или они были включены в том же запросе до создания экспериментальной группы). |
| Тип объявления в торговой кампании | Расширенная поддержка | Расширенная поддержка Campaign.listing_type для торговых кампаний. |
| Обновление правил в отношении самостоятельного декларирования политической рекламы в ЕС | Изменения в работе и новые поля |
|
| Конверсии | ||
| Единая конфигурация расширенного отслеживания конверсий | Новые поля и перечисления | Добавлены поля ConversionTrackingSetting.enablement_setting и ConversionTrackingSetting.effective_enablement_setting (в Customer.conversion_tracking_setting), чтобы показывать единую конфигурацию расширенного отслеживания конверсий для аккаунта, представленную с помощью нового перечисления EnhancedConversionsConfig. |
ConversionActionCategory.MESSAGE_LEAD |
Новое значение enum | Добавлен в ConversionActionCategory для поддержки взаимодействий в чате, указывающих на интерес к предложению рекламодателя. |
ConversionAttributionEventType.CLICK |
Новое значение enum | Добавлено в ConversionAttributionEventType для представления конверсий, связанных с кликом по объявлению, которые ранее были включены в значение перечисления UNKNOWN. |
| Общие | ||
| Обновления лидов в Местных услугах | Новое поле и значение enum |
|
| Рекомендации | ||
| Рекомендация по увеличению бюджета для поисковой сети | Новая рекомендация | Добавлены RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation и ApplyRecommendationOperation.raise_budget_performance_too_low, чтобы поддерживать увеличение бюджетов, когда дневные бюджеты слишком малы для поисковых кампаний. |
| Отчеты | ||
| Измерения эффективности на основе поисковых запросов | Новые функции, ресурсы, сегменты и показатели | Добавлена поддержка показателей эффективности на основе поисковых запросов:
|
| Представление объектов с дополнением конечного URL для торговых кампаний | Расширенная поддержка | В final_url_expansion_asset_view добавлена поддержка торговых кампаний (ad_group можно выбрать в качестве атрибутированного ресурса наряду с final_url_expansion_asset_view.ad_group). |
| Видео | ||
| Сообщения о контенте, созданном генеративным ИИ, на YouTube | Новые поля и перечисление | Добавлена поддержка раскрытия информации о контенте, созданном генеративным ИИ, для загрузок на YouTube. В YouTubeVideoUpload добавлено новое поле YouTubeVideoUpload.video_content_metadata типа VideoContentMetadata, содержащее настройки раскрытия информации в разделе VideoContentMetadata.generative_content_disclosure типа YouTubeVideoUploadGenerativeContentDisclosure. |
Основные и промежуточные версии 25
В Google Ads API версии 25 добавлены следующие новые функции, обновления и критические изменения.
Версия 25.2 (23.09.2026)
В Google Ads API версии 25.2 добавлены следующие новые функции и изменения: В промежуточных версиях, например 25.2, критических изменений нет.
| Функции и обновления | Тип | Описание |
|---|---|---|
| Объекты | ||
Параметры URL для аккаунта "AssetGroup" |
Новые поля | Добавлена поддержка настроек URL в AssetGroup, что позволяет рекламодателям указывать шаблоны отслеживания, специальные параметры и суффиксы конечных URL на уровне группы объектов:
|
| Кампании | ||
| Информация об автоматическом сканировании видео | Новые поля и перечисления | В Campaign.AssetAutomationSetting добавлен параметр AutomatedVideoCrawlSetting, а также AssetAutomationType.AUTOMATED_VIDEO_CRAWL, позволяющий задавать настройки автоматического сканирования видео для кампании с максимальной эффективностью. AutomatedVideoCrawlSetting.automated_video_crawl_infos содержит список записей AutomatedVideoCrawlInfo, каждая из которых настраивает url сканирования, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL или YOUTUBE) и статус согласия enabled. |
| Ошибки множителя ценности при оптимизации жизненного цикла клиентов | Новые значения перечисления и ошибки | Добавлены новые причины ошибок валидации при настройке множителей ценности (value_multiplier и high_lifetime_value_multiplier) для оптимизации жизненного цикла клиентов:
|
SmartCampaignSettingService.GeneratePMaxDraftCampaign |
Новинка | Добавлено поле SmartCampaignSettingService.GeneratePMaxDraftCampaign, которое позволяет создавать проект кампании с максимальной эффективностью на основе существующей умной кампании. Проект инициализируется со статусом CampaignStatus.PAUSED и статусом создания CampaignCreationStatus.INCOMPLETE (см. раздел Преобразование умных кампаний в кампании с максимальной эффективностью):
|
| Конверсии | ||
| Показы объявлений Firebase | Новые типы действий-конверсий и категории | Добавлены типы действий-конверсий FIREBASE_ANDROID_APP_AD_IMPRESSION и FIREBASE_IOS_APP_AD_IMPRESSION, позволяющие получать и изменять эти действия-конверсии. В ConversionActionCategory также добавлена категория IN_APP_AD_REVENUE, чтобы отслеживать доход от монетизации рекламы в приложении. |
| Общие | ||
BusinessProfileLocationSyncError |
Новые перечисления и ошибки | Добавлены причины ошибок синхронизации адресов из профиля компании при синхронизации адресов в AssetSet типа LOCATION_SYNC. Вместо общей ошибки UNKNOWN API теперь возвращает ошибку BusinessProfileLocationSyncError с указанием конкретных причин (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED и NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT). |
| Планирование | ||
Показатели процентилей BenchmarksService.GenerateBenchmarksMetrics |
Новые функции |
Обновлен ресурс Поле
Добавлена поддержка показателей процентиля для дат открытого квартала в Добавлена специальная ошибка |
| Псевдонимы каналов YouTube для статистики авторов | Новинка | ContentCreatorInsightsService.GenerateCreatorInsights теперь поддерживает поиск по псевдонимам каналов YouTube с помощью YouTubeChannels.youtube_channel_handles (действительные псевдонимы каналов должны начинаться с @, например @channel_handle). Этот вариант аналогичен поиску по идентификаторам каналов YouTube. В ответе содержится статистика по запрошенным авторам YouTube. |
| Рекомендации | ||
| Рекомендации по назначению ставок на основе цены за конверсию и рентабельности инвестиций в рекламу | Новые рекомендации | Добавлены Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) и Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW), а также ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low и ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low, чтобы повышать целевую цену за конверсию или снижать целевую рентабельность инвестиций в рекламу, когда ставки слишком низкие для участия поисковых кампаний в аукционах:
|
| Отчеты | ||
| Сегменты для параметров программ пребывания в гостинице | Новые сегменты | В Segments добавлены следующие сегменты параметров, связанные с бронированием отелей и путешествий (их можно выбрать с помощью campaign, ad_group и customer):
|
| Показатели вертикальных объявлений | Новые показатели | В отчеты по рекламе гостиниц и туризма в Metrics добавлены следующие показатели (их можно выбрать с помощью campaign, ad_group и customer):
|
| Сегменты вертикальных объявлений | Новые сегменты | В Segments добавлены следующие сегменты для отчетов об объявлениях в сфере гостиничного бизнеса и туризма (их можно выбрать с помощью campaign, ad_group и customer):
|
Версия 25.1 (19.08.2026)
В Google Ads API версии 25.1 добавлены перечисленные ниже функции и обновления. Промежуточные версии, например v25.1, не содержат критических изменений.
| Функции и обновления | Тип | Описание |
|---|---|---|
| Объекты | ||
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER |
Новые значения перечислений | Добавлена поддержка объектов текстовых отказов от обязательств. |
| Кампании | ||
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time |
Новые поля | Отслеживайте предстоящий автоматический перенос в AI Max. |
| Конверсии | ||
| Исследования Brand Lift | Новые функции | Добавлена поддержка показателей Brand Lift со следующими обновлениями:
|
| Исследования роста конверсий | Новые функции | Добавлена поддержка показателей роста конверсий со следующими обновлениями:
|
LiftMeasurementFlight |
Новый ресурс | Новый ресурс, доступный только для чтения, который содержит сведения о периоде трансляции рекламы для конфигурации измерения роста, включая даты начала и окончания периода (start_date и end_date). |
| Общие | ||
SmartCampaignError |
Новые значения перечислений | Добавлены новые коды ошибок для ограничений генерации в кампаниях с максимальной эффективностью: |
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION |
Новое перечисляемое значение / ошибка | Возвращается, когда проект Google Cloud с уровнем доступа TEST пытается выполнить запросы к аккаунту, который не является тестовым. |
| Планирование | ||
| Статистика отношения к бренду | Новые функции | Добавлена поддержка статистики по отношению к бренду в ContentCreatorInsightsService:
|
Улучшения BenchmarksService |
Новые функции | Добавлена поддержка категорий в качестве фильтров для анализа контрольных показателей. Также поддерживаются дополнительные критически важные для бизнеса показатели:
|
| Таргетинг на наличие детей | Новинка | Добавлена поддержка таргетинга на наличие детей при планировании охвата. Добавлено новое поле parental_statuses в Targeting для сервиса ReachPlanService.GenerateReachForecast и parental_statuses в PlannableTargeting для сервиса ReachPlanService.ListPlannableProducts. |
| Рекомендации | ||
Recommendation.campaign_specific_app_goal_recommendation |
Новая рекомендация | Предлагает добавить цель конверсии в приложении на уровне кампании. Для представления текущих целей в этой рекомендации используется новый ресурс EffectiveAutomaticGoal. |
| Отчеты | ||
Metrics.original_conversion_value |
Новое поле | Представляет исходную ценность конверсий с возможностью ставки. Это ценность конверсии до применения корректировок в отношении правил ценности или целей по жизненному циклу. |
| Статистика участия в программе лояльности | Новые функции | Добавлена поддержка сегментирования статистики по статусу участия в программе лояльности, а также основной параметр "Участие в программе лояльности" для правил ценности конверсий:
|
| Таргетинг | ||
vertical_ads_item_bid |
Новый тип критерия | В AdGroupCriterion.criterion добавлен новый тип критерия vertical_ads_item_bid. |
Версия 25 (22.07.2026)
В Google Рекламе API версии 25, которая является крупным релизом, появились следующие новые функции, обновления и критические изменения.
Подробнее о том, как перейти на последнюю версию…
Критические изменения
| Начальное состояние | Новое состояние | Тип изменения | Советы по размещению рекламы |
|---|---|---|---|
| Кампании | |||
Отдельные поля additional_value и additional_high_lifetime_value в CustomerLifecycleOptimizationValueSettings |
Часть полей value_adjustment и high_lifetime_value_adjustment, а также новые поля value_multiplier и high_lifetime_value_multiplier |
Структурные изменения | Обновите ссылки на эти поля, так как теперь они являются частью oneof. |
Устаревшие ресурсы CustomerLifecycleGoal и CampaignLifecycleGoal, соответствующие им сервисы CustomerLifecycleGoalService и CampaignLifecycleGoalService, а также устаревшие настройки и перечисления (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) |
Нет | Рубка | Используйте обновленную схему общих целей:
|
| Общие | |||
Вложенные поля перечисления в сообщениях запросов и ответов Incentive Service:
|
Отдельные поля перечисления: | Переименование или удаление | Вместо устаревших полей type используйте новые отдельные поля enum. |
Необязательные поля selected_incentive_id и customer_id в ApplyIncentiveRequest |
Обязательные поля | Изменение поведения | При вызове функции ApplyIncentive обязательно укажите оба поля. |
Поле адреса электронной почты клиента ContactDetails.email в ресурсе LocalServicesLead. |
Нет | Рубка | Удалите ссылки на это поле, так как оно больше не поддерживается. |
Необязательное поле allowed_domain в AdvertisingPartnerLinkInvitationProperties |
Обязательное поле при вызове CreateProductLinkInvitation для партнера по рекламе. |
Изменение поведения | При создании приглашения на связывание продуктов для партнера по рекламе укажите allowed_domain. |
| Планирование | |||
Поле search_brand в GenerateCreatorInsightsRequest |
Нет | Рубка | Используйте вместо него search_topics. |
Поле plannable_location_id в Targeting и поле cookie_frequency_cap в GenerateReachForecastRequest. |
Нет | Рубка | Перейдите на использование plannable_location_ids и cookie_frequency_cap_setting. |
| Отчеты | |||
Поле customer_metrics в GenerateBenchmarksMetricsResponse и BreakdownMetrics типа Metrics |
Поле типа CustomerMetrics |
Изменение типа или поведения | Обновите интеграции, чтобы использовать новый тип CustomerMetrics, который содержит только показатели, отражающие эффективность рекламы клиента. |
Функции и обновления (некритические)
| Функции и обновления | Тип | Описание |
|---|---|---|
| Реклама | ||
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS |
Новое значение / поведение перечисления | Доступно для DemandGenMultiAssetAds. Если эта функция включена, она создает анимированные изображения на основе обычных. Начиная с этой версии API новые DemandGenMultiAssetAds включены по умолчанию. |
| Изменяемость информации о синтетическом контенте | Изменение поведения | Asset.synthetic_content_info и Ad.synthetic_content_info теперь полностью изменяемы в версиях 25, 24 и 23. |
| Кампании | ||
| Цель "Удержание клиентов" | Новые функции и настройки | Добавлена поддержка цели удержания участников программы лояльности, которая позволяет рекламодателям оптимизировать кампании для удержания участников программы лояльности.
|
| Цель "Привлечение новых клиентов" | Новые функции и настройки | Обновлена поддержка цели "Привлечение новых клиентов" в Google Ads API, чтобы отразить обновленную схему унифицированных целей:
|
| Конверсии | ||
| Сторонняя атрибуция конверсий на YouTube | Новые поля | Добавлена поддержка проверки атрибуции конверсий на YouTube с помощью сторонних партнеров:
|
| Общие | ||
ContactDetails.phone_number_extension |
Новое поле | Добавлено в ресурс LocalServicesLead. |
IncentiveError |
Новые значения перечисления и ошибки | Добавлены новые коды ошибок, связанных с проблемами при использовании бонусов:
|
| Планирование | ||
| Информация о канале YouTube в статистике трендов | Новые поля | Добавлена поддержка более подробной информации о каналах YouTube, на которых размещены связанные видео, при поиске актуальной статистики. В YouTubeVideoAttributeMetadata добавлены новые поля channel_id, channel_name и channel_url. |
YouTubeChannelInsights.data_sharing_consent_given |
Новое поле | Добавлено в очередь экрана YouTubeChannelInsights. Это возможно, если автор дал согласие на передачу закрытых данных. Если да, то будут заполнены следующие поля:
|
| Отчеты | ||
ad_sub_format_type |
Новый сегмент | Содержит разбивку объявлений In-Stream без возможности пропуска на YouTube по продолжительности:
ad_format_type. Его можно выбрать с помощью AdGroup, AdGroupAd, Campaign, Customer, Video и VideoEnhancement.
|
| Показатели социальных сетей, связанные с видео | Новые поля и показатели | Добавлены социальные показатели для видео, которые помогают рекламодателям отслеживать вовлеченность пользователей (комментарии, лайки и репосты) для рекламы в Shorts на YouTube:
Они доступны в AdGroup, AdGroupAd, Asset, Campaign, Customer и Video.
|
Основные и промежуточные версии v24
В Google Ads API версии 24 добавлены новые функции, обновления и критические изменения.
Версия 24.2 (24.06.2026)
В Google Ads API версии 24.2 добавлены перечисленные ниже новые функции и обновления. Промежуточные версии, например v24.2, не содержат критических изменений.
| Функции и обновления | Тип | Описание |
|---|---|---|
| Реклама | ||
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT |
Новое перечисляемое значение | Генерирует сгенерированный текст с целевой страницы, который будет показываться на панели взаимодействия для экземпляров DemandGenVideoResponsiveAd (которые включены по умолчанию, начиная с этой версии API). |
| Объекты | ||
AssetGroup.google_local_services_info |
Новое поле | Добавлено для поддержки информации о Рекламе местных услуг (идентификатор категории и уточнения) в кампаниях с максимальной эффективностью. |
AssetGroupSignal.local_services_id |
Новое поле | Добавлена поддержка сигналов идентификаторов услуг Рекламы местных услуг в кампаниях с максимальной эффективностью. |
AssetGroupSignal.vertical_ads_item_group_rule_list |
Новое поле | Добавлены правила для групп объектов вертикальных объявлений, позволяющие выбирать объекты из прикрепленных вертикальных фидов в кампаниях с максимальной эффективностью. Эта функция доступна только для аккаунтов, добавленных в белый список. |
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN |
Новое значение enum или ошибка | Возвращается при попытке удалить все группы объектов из кампании. |
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS |
Новое значение enum / ошибка | Возвращается при попытке удалить все сигналы из группы объектов. |
| Кампании | ||
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled |
Новые поля | Помощь в определении кампаний с максимальной эффективностью для местных услуг. |
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps |
Новое поле | Google Карты включены в список каналов, которые можно выбрать для групп объявлений в кампаниях для создания спроса. |
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN |
Новое перечисляемое значение / ошибка | Возвращается при попытке удалить все местоположения из кампании с максимальной эффективностью для местных услуг. |
SmartCampaignErrorEnum.CREATION_FAILED |
Новое перечисляемое значение / ошибка | Возвращается при попытке создать новую умную кампанию. |
| Конверсии | ||
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS |
Новые значения перечисления | Конверсии, которые происходят, когда пользователь нажимает на объявление Местных услуг и звонит, отправляет сообщение или бронирует услуги рекламодателя. |
| Эксперименты | ||
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION |
Новые значения перечисления | Добавлена поддержка новых типов ExperimentType:
|
| Общие | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
Новые поля | Содержат подтверждения того, что контент является синтетическим или создан искусственным интеллектом. Подтверждения делятся на advertiser_attestation (заявления, предоставленные непосредственно рекламодателем) и system_attestation (подтверждения, автоматически обнаруженные или предоставленные системой).
Эта функция была перенесена в версии 23 и 22.
Чтобы вам было проще спланировать интеграцию с версией 25, мы добавили интерфейс для изменения полей подтверждения рекламодателя в версию 22 и более поздние. Интерфейс виден в этих версиях, но Если вы попытаетесь выполнить запрос mutate для одного из этих полей, будет возвращена одна из следующих ошибок: "Поле, которое вы пытаетесь изменить, является неизменяемым" или "Не удалось задать значение поля". Эти поля станут полностью изменяемыми начиная с версии 25. Мы рекомендуем использовать интерфейс сейчас, чтобы создать и протестировать внутреннюю логику. Тогда ваша система будет готова к полному доступу на запись, когда будет запущена версия 25. |
| Групповое одобрение | Новые функции |
Добавлена поддержка групповой авторизации (MPA):
Эта функция была перенесена в версии v23.3, v22.2 и v21.2. |
IncentiveService.FetchIncentive |
Изменение поведения | Если в запросе указан недействительный адрес электронной почты, метод теперь возвращает предложения по умолчанию, а не ошибку AuthenticationError.INVALID_EMAIL_ADDRESS. |
| Планирование | ||
GenerateCreatorInsightsRequest.search_topics |
Новое поле | Добавлено в сервис ContentCreatorInsightsService.GenerateCreatorInsights. Этот вариант позволяет искать авторов, которые говорят на определенную тему в стране, указанной в поле country_locations (поддерживается поиск только по одной стране). |
CREATOR_TOPIC_INSIGHTS |
Новое перечисляемое значение | Добавлено в InsightsKnowledgeGraphEntityCapabilities для обозначения объектов при поиске авторов, которые говорят на определенную тему. Эти объекты следует использовать в поле search_topics. Извлекается с помощью AudienceInsightsService.ListAudienceInsightsAttributes. |
KnowledgeGraphEntitySearchOptions |
Новый тип или варианты | Содержит дополнительные параметры поиска тем в ListAudienceInsightsAttributes, в том числе параметры для получения всех тем, поддерживаемых в качестве атрибутов авторов, и фильтрации по возможностям. |
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data |
Новые поля | Необязательные входные данные для методов ContentCreatorInsightsService. Если указать это поле, в ответе будут заполнены дополнительные местоположения или атрибуты автора. |
local_creator_insights related_local_creators |
Новые поля | Заполняется, когда supplemental_data содержит перечисление LOCAL_CREATOR_DATA. Показывает местных авторов, которые согласились делиться данными о местоположении и чьи видео были просмотрены в выбранной стране или были сняты в ней. |
GenerateTrendingInsightsRequest.sub_country_locations |
Новое поле | Добавлено в ContentCreatorInsightsService.GenerateTrendingInsights, что позволяет искать статистику тенденций по странам и регионам. |
| Отчеты | ||
PerformanceMaxPlacementView |
Расширение сегментов | Добавлена возможность сегментирования по параметру ad_network_type. |
| Покупки | ||
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads |
Новое поле | Если задано значение true, исключения брендов для товарных объявлений игнорируются. Поддерживается только для торговых кампаний. |
| Таргетинг | ||
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE |
Новое значение enum или ошибка | Возвращается при попытке настроить таргетинг на запрещенный язык. |
| Видео | ||
DataLink.youtube_link_metadata |
Новое поле | Содержит brand_channel_id, чтобы указать идентификатор связанного канала бренда на YouTube. |
Версия 24.1 (13.05.2026)
В Google Ads API версии 24.1 добавлены следующие новые функции и обновления. Промежуточные версии, например 24.1, не содержат критических изменений.
| Функции и обновления | Тип | Описание |
|---|---|---|
| Реклама | ||
DemandGenMultiAssetAdInfo.classic_display_images |
Новое поле | Загруженные пользователем медийные изображения показываются без дополнительных адаптивных объектов. |
| Эксперименты | ||
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING |
Новые значения перечисления | Добавлена поддержка новых типов ExperimentType:
|
Experiment.video_experiment |
Новое поле | Поддержка конфигурации для существующих экспериментов YOUTUBE_CUSTOM, состоящих из видеокампаний. |
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info |
Новые поля | Добавлены поля для поддержки тестирования объектов, групп объектов и настроек кампаний с максимальной эффективностью в группах эксперимента:
|
| Общие | ||
CustomerUserAccess.passkey_enabled |
Новое поле | Поле только для чтения, в котором указано, включен ли у пользователя ключ доступа. |
| Отчеты | ||
mobile_device_platform |
Новый сегмент | Позволяет сегментировать отчеты по платформе устройства пользователя (например, iOS или Android). |
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED |
Новое перечисляемое значение / ошибка | Возвращается, когда запрошенный уровень детализации времени (по дням, часам или неделям) не поддерживается для диапазонов дат запроса (доступно только за последние 37 месяцев). |
vertical_ads_listing_user_rating vertical_ads_listing_venue |
Новые сегменты | Новые сегменты для вертикальных объявлений. |
user_rating, venue, event_participant_display_name |
Новые критерии фильтрации | Поддерживается фильтрация в VerticalAdsItemGroupRuleInfo для ресурса SharedCriterion. |
| Показатели эксперимента с контрольной и экспериментальной группами | Новые поля | Добавленные значения контрольной группы (control_clicks и т. д.), экспериментальной группы (clicks и т. д.), точечные оценки (clicks_point_estimate и т. д.), погрешности (clicks_margin_of_error и т. д.) и p-значения (clicks_p_value и т. д.) для семи основных семейств показателей (клики, показы, стоимость, конверсии, цена за конверсию, ценность конверсий, ценность конверсий на единицу стоимости). |
| Показатели абсолютного изменения конверсий | Новые поля | Поддержка Conversions оценок абсолютной разницы с использованием полей точечной оценки, погрешности и p-значения. |
| Таргетинг | ||
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS |
Новое перечисляемое значение / ошибка | Возвращается при попытке исключить все целевые демографические группы. |
| Видео | ||
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR |
Новое значение enum | Добавлена интеграция с ZEFR как сторонним партнером по видимости. |
DataLink.youtube_video.channel_id |
Новое поле | Показывает идентификатор канала YouTube, связанного с данными. |
Версия 24 (22.04.2026)
В Google Ads API версии 24 добавлены перечисленные ниже новые функции, обновления и критические изменения.
Подробнее о том, как перейти на последнюю версию…
Критические изменения
| Начальное состояние | Новое состояние | Тип изменения | Советы по размещению рекламы |
|---|---|---|---|
| Реклама | |||
Необязательные videos и logo_images в DemandGenVideoResponsiveAdInfo |
Обязательные поля | Изменение поведения | Указывайте значения videos и logo_images при создании или изменении адаптивных видеообъявлений для создания спроса. |
Необязательные элементы videos, business_name и logo_images в VideoResponsiveAdInfo |
Обязательные поля | Изменение поведения | При создании или изменении адаптивных видеообъявлений укажите videos, business_name и logo_images. Обратите внимание, что теперь VideoResponsiveAdInfo можно изменять. |
| Кампании | |||
Campaign.video_brand_safety_suitability |
Нет | Рубка | Настройки соответствия требованиям бренда на уровне кампании удалены. Настройки безопасности бренда по-прежнему доступны на уровне клиента. Используйте вместо него Customer.video_brand_safety_suitability. |
| Конверсии | |||
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS |
Нет | Рубка | Категория пользователей, зарегистрировавшихся в программе лояльности, удалена. Удалите ссылки на него в коде. |
| Планирование | |||
Тип InsightsAudienceAttributeGroup для topic_audience_combinations |
Тип common.InsightsAudienceAttributeGroup |
Изменение поведения или типа | Интеграции типизированных клиентских библиотек необходимо обновить, чтобы использовать новые пространства имен ресурсов. |
Поле youtube_select_lineups в ReachPlanService.ListPlannableProducts |
Нет | Рубка | Перейдите на подборки из youtube_select_lineup_targeting. |
Поле is_brand_connect_creator в ContentCreatorInsightsService.GenerateCreatorInsights и GenerateTrendingInsights |
Нет | Рубка | Вместо этого проверьте, доступна ли автору функция CREATOR_PARTNERSHIPS в partnership_opportunities. |
geo_modifiers и biddable_keywords в KeywordPlanIdeaService.GenerateKeywordForecastMetrics |
geo_target_constants и keywords |
Переименование или удаление | Заменено на CampaignToForecast.geo_target_constants[] и ForecastAdGroup.keywords[]. |
Поля плана и прогноза ключевых слов, поддержка которых прекращена, в GenerateKeywordForecastMetrics |
Нет | Рубка | Удалены следующие поля и типы планов и прогнозов: Обновите интеграции. |
| Отчеты | |||
Сегмент ad_sub_network_type в campaign_budget |
Нет | Рубка | Удален сегмент ad_sub_network_type для ресурса campaign_budget. |
Сегмент click_type в представлениях объектов |
Нет | Рубка | Сегмент удален из представлений AdGroupAsset, CampaignAsset и CustomerAsset. |
| Видео | |||
Частичный сбой разрешен в ShareablePreviewService.GenerateShareablePreviews |
Частичный сбой не произошел | Изменение поведения | Если хотя бы один идентификатор не пройдет проверку, запрос не будет выполнен и появится сообщение об ошибке. |
Устаревшие коды ShareablePreviewError:
|
MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST |
Переименование / изменение поведения | Коды ошибок, возвращаемые для групп объектов, изменены в соответствии с ошибками объявлений в группах объявлений. Обновлена логика обработки ошибок при проверке. |
Функции и обновления (некритические)
| Функции и обновления | Тип | Описание |
|---|---|---|
| Реклама | ||
Изменяемость VideoResponsiveAdInfo |
Изменение поведения | Теперь объекты информации об адаптивных видеообъявлениях можно изменять. |
| Объекты | ||
travel_feed_data в зоне AssetSet |
Новое поле | Добавлены атрибуты для получения объектов фида путешествий (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type). |
| Кампании | ||
Campaign.view_through_conversion_optimization_enabled |
Новое поле | Позволяет включить оптимизацию конверсий по показам (по умолчанию false) в кампаниях для создания спроса и для приложений. |
CampaignCriterion.gender |
Новинка | Включено исключение по полу для кампаний с максимальной эффективностью во всех версиях Google Ads API. |
| Конверсии | ||
| Типы конверсий для лидогенерации | Новые значения перечислений | Добавлены новые перечисления типов действий-конверсий GA4/Firebase в ConversionActionType:
|
| Общие | ||
UserListErrorEnum.DUPLICATE_LOOKALIKE |
Новое перечисляемое значение / ошибка | Возвращается при попытке создать несколько одинаковых похожих списков. |
| Планирование | ||
ProductCoreAttributes полей в ListPlannableProductsResponse |
Новые поля | В раздел ProductCoreAttributes под заголовком ListPlannableProductsResponse добавлены описания продуктов для планирования, маркетинговых целей, моделей стоимости и методов покупки. |
| Отчеты | ||
CartDataSalesView |
Новый ресурс для отчетов | Отчеты, в которых показатели конверсий сегментируются по проданному товару (бренду и т. д.) в дополнение к товару, на который был нажат клик. |
| Показатели без назначения ставок | Новые поля | Добавлены показатели без назначения ставок (показатели, отражающие конверсии, для которых не оптимизируются кампании) для всех соответствующих ресурсов:
|
conversion_attribution_event_type |
Новый сегмент | Добавлено в очередь экрана ShoppingPerformanceView. |
| Покупки | ||
Кампании для приложений в ShoppingProduct |
Новинка | Поддерживаемые кампании для приложений в ресурсе ShoppingProduct. Статус заметок и проблемы не поддерживаются. |
| Фильтрация товаров на основе тегов | Новинка | Добавлена динамическая фильтрация с использованием логических выражений:
|
Основные и промежуточные версии 23
В Google Ads API версии 23 добавлены новые функции, обновления и критические изменения.
Версия 23.3 (24.06.2026)
В Google Ads API версии 23.3 добавлены перечисленные ниже новые функции и обновления. Промежуточные версии, например 23.3, не содержат критических изменений.
| Функции и обновления | Тип | Описание |
|---|---|---|
| Общие | ||
Asset.synthetic_content_info Ad.synthetic_content_info |
Новые поля | Содержат заявления о синтетическом контенте или контенте, созданном с помощью ИИ, разделенные на advertiser_attestation (заявления, предоставленные непосредственно рекламодателем) и system_attestation (заявления, автоматически обнаруженные или предоставленные системами Google).
Чтобы вам было проще спланировать интеграцию с версией 25, мы добавили интерфейс для изменения полей подтверждения рекламодателя в версию 22 и более поздние. Интерфейс виден в этих версиях, но Если вы попытаетесь выполнить запрос mutate для одного из этих полей, будет возвращена одна из следующих ошибок: "Поле, которое вы пытаетесь изменить, является неизменяемым" или "Не удалось задать значение поля". Эти поля станут полностью изменяемыми начиная с версии 25. Мы рекомендуем использовать интерфейс сейчас, чтобы создать и протестировать внутреннюю логику. Тогда ваша система будет готова к полному доступу на запись, когда будет запущена версия 25. |
| Групповое одобрение | Новые функции |
Добавлена поддержка проверок группового одобрения (MPA):
|
Версия 23.2 (25.03.2026)
В Google Ads API версии 23.2 добавлены перечисленные ниже новые функции и обновления. Промежуточные версии, например v23.2, не содержат критических изменений.
| Функции и обновления | Тип | Описание |
|---|---|---|
| Объекты | ||
VideoEnhancement |
Новый ресурс | Информация об улучшении видеообъявления, например о том, создано ли оно Google или предоставлено рекламодателем. Подробнее об оптимизации видео… |
AppTopCombinationView |
Новый ресурс | Ресурс только для чтения, который позволяет получать информацию о самых эффективных комбинациях объектов в кампаниях для приложений. |
CustomerAsset |
Новинка | Добавлена поддержка получения 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. |
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS |
Изменение поведения | При попытке использовать эту категорию типа клиента теперь возникает ошибка. |
| Планирование | ||
GenerateTrendingInsights GenerateCreatorInsights |
Новые функции | Добавлена поддержка пользовательских комбинаций И/ИЛИ объектов, тем и аудиторий. |
ReachPlanService.GenerateReachForecast |
Новые значения перечисления | Добавлены новые возрастные диапазоны для таргетинга, например AGE_RANGE_21_44 или AGE_RANGE_21_49. |
youtube_select_lineup_targeting |
Новое поле | Добавлено в ReachPlanService.ListPlannableProducts, который заменит youtube_select_lineups. В настоящее время оба поля заполнены. |
ReachPlanSurface |
Новое перечисляемое значение | Добавлена платформа IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS. |
Forecast |
Новое поле | Добавлена цена за клик clicks для кампаний для создания спроса с Макс. кликов в ReachPlanService.GenerateReachForecast. |
partnership_opportunities |
Новое поле | Добавлено в разделы ContentCreatorInsightsService.GenerateCreatorInsights и ContentCreatorInsightsService.GenerateTrendingInsights. |
| Отчеты | ||
biddable_indirect_install_first_in_app_conversion_micros |
Новое поле | Добавлено в ресурсы Campaign, Customer и AdGroup. |
| Видео | ||
ShareablePreviewService |
Новинка | Добавлена поддержка предпросмотра трансляций YouTube Live. Для этого нужно задать для параметра preview_type значение YOUTUBE_LIVE_PREVIEW. В ShareablePreviewError добавлены UNSUPPORTED_AD_TYPE и TOO_MANY_RESOURCES_IN_REQUEST. Эта функция поддерживается только для некоторых типов объявлений. |
Версия 23.1 (25.02.2026)
В версии 23.1 Google Ads API появились следующие новые функции и изменения. В промежуточных версиях, например 23.1, критических изменений нет.
| Функции и обновления | Тип | Описание |
|---|---|---|
| Управление аккаунтом | ||
advertising_partner_properties.allowed_domain |
Новое поле | Добавлено в ресурсы ProductLinkInvitation и ProductLink. Партнер по рекламе сможет размещать рекламу только в этом домене. |
Customer.contains_eu_political_advertising |
Новое поле | Получает статус заявления на уровне аккаунта о том, содержит ли он политическую рекламу, предназначенную для ЕС, и возвращает EuPoliticalAdvertisingStatus. |
| Кампании | ||
Campaign.text_guidelines |
Новое поле | Добавлена поддержка правил создания текстовых объектов, которые можно использовать в кампаниях с максимальной эффективностью и поисковых кампаниях для программного управления текстовыми объектами, созданными ИИ. Внутри text_guidelines можно определить term_exclusions и messaging_restrictions. |
CampaignPrimaryStatusReason |
Новые значения перечислений | Добавлены элементы CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED и 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 |
Новое значение enum | Поддерживает отслеживание пользователей, которые посмотрели объявление, а затем видео на том же канале. |
| Общие | ||
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED |
Новое значение enum или ошибка | Возвращается при попытке настроить таргетинг только на категорию "Неопределено" в демографических параметрах. |
| Поощрительные программы | ||
IncentiveErrorEnum |
Новые значения перечислений и ошибки | Добавлены два новых кода ошибки: MAX_INCENTIVES_REDEEMED и ACCOUNT_TOO_OLD. Эти ошибки могут возвращаться для запросов, сделанных 11 марта 2026 г. или позже. |
| Планирование | ||
GenerateBenchmarksMetrics |
Новинка | Добавлена поддержка разбивки по датам с помощью BreakdownDefinition. |
ReachPlanService.GenerateReachForecast |
Новое значение enum | Добавлена возможность выбирать GOOGLE_DISPLAY_NETWORK в качестве целевой платформы для кампаний для создания спроса с максимальным количеством конверсий. |
GenerateTrendingInsights |
Новые поля | При поиске по теме в TrendInsightDataPoint добавлена информация о линии тренда за прошлые периоды в TrendInsights. |
| Отчеты | ||
| Показатели частоты показов уникальным пользователям | Новые поля | Добавлены новые показатели, которые позволяют узнать, сколько пользователей видели ваше объявление не менее двух, трех, четырех, пяти или десяти раз: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus и unique_users_ten_plus. |
SearchTermMatchSource |
Новое значение enum | Добавлено поле VERTICAL_ADS_DATA_FEED для поддержки фидов данных вертикальной рекламы, например таргетинга на объекты в рекламе туризма. |
| YouTubeVideoUpload | ||
YouTubeVideoUpload |
Новый сервис или ресурс | Добавлен сервис YouTubeVideoUpload для загрузки видео на YouTube и управления ими, а также ресурс YouTubeVideoUpload для получения статуса загрузки и метаданных. Эта функция поддерживается только для REST и клиентской библиотеки Python. |
Версия 23 (28.01.2026)
В этой статье рассказывается о новых функциях, обновлениях и критических изменениях, добавленных в Google Ads API версии 23.
Подробнее о том, как перейти на последнюю версию…
Критические изменения
| Начальное состояние | Новое состояние | Тип изменения | Советы по размещению рекламы |
|---|---|---|---|
| Реклама | |||
| Разрешено делиться объявлением | AdGroupAdError.AD_SHARING_NOT_ALLOWED |
Изменение поведения | Объявления больше нельзя использовать в нескольких группах. При попытке поделиться объявлением будет возвращаться ошибка AD_SHARING_NOT_ALLOWED. |
Поддержка CallAd и CallAdInfo |
Нет | Рубка | Поддержка объявлений с номером телефона прекращена. Подробнее об объявлениях с номером телефона… |
| Кампании | |||
Campaign.start_date Campaign.end_date |
Campaign.start_date_time Campaign.end_date_time |
Переименование или замена | Используйте новые поля даты и времени, чтобы указать временные компоненты для кампаний. Исходные поля, содержащие только даты, будут удалены. |
| Создание спроса | |||
DemandGenMultiAssetAdInfo.lead_form_only |
Нет | Рубка | Поле lead_form_only удалено. Обновите ссылки в коде. |
| Отчеты | |||
| Агрегированные показатели эффективности и перечисления ярлыков объектов | Нет | Рубка | Удалены показатели ярлыков объектов с агрегированными данными об эффективности. Для поисковой и контекстно-медийной сетей больше не возвращается перечисление меток эффективности. |
Функции и обновления (некритические)
| Функции и обновления | Тип | Описание |
|---|---|---|
| Реклама | ||
AdFormatType |
Новые значения перечисления | Добавлены новые типы форматов: TEXT, VERTICAL_ADS_BOOKING_LINK и VERTICAL_ADS_PROMOTION. |
| Объекты | ||
asset_group просмотр |
Новые поля | Добавлены следующие показатели: metrics.engagements, metrics.engagement_rate и metrics.average_cpe. |
Просмотр: asset_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.orientation |
Новое поле | В объекты изображений и видео добавлено поле ориентации, доступное только для чтения. |
CampaignAsset |
Новинка | Добавлена поддержка для получения объектов кампании с параметром field_type, установленным на значение HEADLINE или DESCRIPTION. |
ServedAssetFieldType |
Новые значения перечисления | Добавлены поля HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE и DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO для объектов, которые показываются как дополнительные ссылки. |
BusinessMessageAsset |
Новые функции и поддержка | Обновленные объекты чатов:
|
| Оплата | ||
InvoiceService.ListInvoices |
Новые варианты | Теперь в Invoice можно возвращать более подробные сведения, включая разбивку расходов на уровне кампании, детализированные нормативные расходы и информацию о корректировках. Для этого нужно задать include_granular_level_invoice_details в ListInvoicesRequest. |
RegulatoryFeeType UnitOfMeasure |
Новые перечисления | Добавлены вспомогательные перечисления для государственных сборов и единиц измерения. |
| Кампании | ||
CampaignError |
Новые значения перечисления / ошибки | Добавлены коды ошибок DURATION_TOO_LONG_FOR_TOTAL_BUDGET и END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET. |
| Конверсии | ||
| ConversionActionCategory | Новое перечисляемое значение | Добавлен показатель YOUTUBE_FOLLOW_ON_VIEWS, который позволяет отслеживать пользователей, посмотревших объявление, а затем видео на том же канале. |
| Создание спроса | ||
DemandGenVideoResponsiveAdInfo.companion_banner |
Новое поле | Добавлена поддержка сопутствующих баннеров в адаптивных видеообъявлениях для создания спроса. |
| Поощрительные программы | ||
Добавлена поддержка бонусов "Выбери сам" (CYO).
Чтобы упростить программную обработку ошибок, в будущих выпусках мы добавим в |
||
| Планирование | ||
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST |
Новое перечисляемое значение | Позволяет создавать аудитории на основе событий в жизни в GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport и GenerateCreatorInsights.
События не поддерживаются для других методов |
ReachPlanService.GenerateConversionRates |
Новые поля или варианты | Теперь в ответе есть платформы, для которых можно получить рекомендации по коэффициенту конверсии на основе настроек платформ (например, Gmail, Shorts). Поддерживается только в кампаниях для создания спроса. |
LanguageDistribution |
Новое поле или тип | Добавлен в YouTubeChannelInsights, чтобы предоставлять информацию о распределении языков в контенте канала YouTube. |
BenchmarksService |
Новый сервис | Сравнение данных о рекламе на YouTube с отраслевыми показателями. |
AudienceInsightsService.GenerateAudienceDefinition |
Новый метод | Переводит описание целевой аудитории в виде свободного текста в соответствующие атрибуты аудитории с помощью генеративного искусственного интеллекта. |
YouTubeChannelInsights.relevance_score |
Новое поле | Оценивает, насколько автор соответствует теме, с учетом количества просмотров. |
TrendInsightMetrics.trend_change_percent |
Новое поле | Процентное изменение значения тренда за период сравнения. |
| Рекомендации | ||
GenerateRecommendationsRequest |
Новое поле | Добавлена функция is_new_customer. Если для рекомендаций CAMPAIGN_BUDGET задано значение true, используется модель, оптимизированная для новых клиентов (рекомендуется только для клиентов, у которых нет кампаний). |
| Отчеты | ||
AdGroupAdAssetView |
Поддержка новых функций и показателей | Теперь поддерживаются показатели показов, эффективности и конверсий для RESPONSIVE_DISPLAY_AD. |
Сегмент ad_sub_network_type |
Новый сегмент | Позволяет получить подробную разбивку данных об эффективности в рекламной сети. Сначала эта функция будет доступна для кампаний для создания спроса на YouTube (In-Stream, в фиде и Shorts). Необходимо выбрать вместе с параметром ad_network_type. |
| Отчеты о кампаниях с максимальной эффективностью | Новинка | Добавлена разбивка по типам рекламных сетей для кампаний с максимальной эффективностью. |
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. |
| Сегменты вертикальных объявлений | Новые сегменты | Добавлены следующие сегменты: vertical_ads_event_participant_display_names, vertical_ads_hotel_class, vertical_ads_listing, vertical_ads_listing_brand, vertical_ads_listing_city, vertical_ads_listing_country, vertical_ads_listing_region, vertical_ads_partner_account и vertical_ads_vertical. |
PerStoreView MatchedLocationInterestView |
Новые ресурсы для отчетов | Добавлен объект PerStoreView для запроса сведений об адресах магазинов и объект MatchedLocationInterestView (для кампаний AI Max) для получения показателей эффективности по интересующим географическим местоположениям. |
| Покупки | ||
ShoppingPerformanceView |
Поддержка новых показателей | Теперь поддерживаются следующие показатели, сегментированные по дате конверсии: conversions_by_conversion_date, all_conversions_by_conversion_date, 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. |
ShoppingProduct.product_image_uri |
Новое поле | Добавлено в очередь экрана ShoppingProduct. |
| Вертикальные объявления | ||
AdGroup.vertical_ads_format_setting |
Новое поле | Позволяет управлять тем, какие форматы объявлений могут показываться в поисковых кампаниях с фидами путешествий. |
AdGroupCriterion SharedCriterion |
Новые поля и критерии | В AdGroupCriterion и vertical_ads_item_group_ruleSharedCriterion добавлен тип критерия vertical_ads_item_group_rule_list, чтобы разрешить таргетинг на группы позиций в поисковых кампаниях с фидами туристических услуг. |
| Интеграция фида данных вертикальных объявлений | Новинка | Теперь вы можете подключить фид данных вертикальной рекламы к поисковой кампании, в которой используется AI Max, чтобы показывать рекламу объектов и ссылки для бронирования наряду с текстовыми объявлениями. Управляйте форматами с помощью vertical_ads_format_setting и задавайте правила с помощью vertical_ads_item_group_rule. Сегментируйте отчеты по AdFormatType и параметрам фида данных для объявлений в определенной отрасли. |
| Видео | ||
AdVideoAssetInfo.ad_video_asset_feature_control |
Новое поле | Добавлены параметры управления функциями для объектов видеообъявлений. |
CampaignCriterionError |
Новое значение enum или ошибка | Добавлен код ошибки INVALID_VIDEO_LINEUP_ID. |
| Показатели слышимости на YouTube | Новые показатели | Добавлены показатели слышимости для аудиообъявлений на YouTube, позволяющие узнать, было ли объявление слышно и для какого количества показов можно было определить слышимость. |
Архив примечаний к выпуску
Архивные примечания к выпускам можно найти в разделе Устаревшие версии.