✓ Google выпустил Google Ads API v26 14 октября 2026 года. Это новая основная версия, поэтому вместе с дополнительными возможностями она содержит несовместимые изменения. Для бизнеса это не означает, что рекламные кампании внезапно перестанут работать в интерфейсе Google Ads. Но интеграции, которые создают кампании, читают настройки конверсий, загружают видео или строят отчёты через API, нужно проверить до переключения на новый endpoint.
Релиз важен ещё по одной причине: Google объявил более частый ритм обновлений API — начиная с v26 новые версии планируется выпускать дважды в месяц. Основные версии могут менять поля и поведение, а промежуточные минорные релизы обычно остаются обратно совместимыми. Командам, которые раньше проверяли изменения раз в квартал, придётся сделать мониторинг релизов регулярной частью эксплуатации.
Кому нужно действовать, а кому — нет
Проверка нужна, если компания или агентство использует собственные скрипты, ETL-процессы, коннектор к CRM, сервис управления ставками, автоматическое создание кампаний, загрузку офлайн-конверсий или отчётность на базе Google Ads API. В зону риска попадают и готовые платформы, если их поставщик ещё не подтвердил поддержку v26.
Если специалист работает только в веб-интерфейсе Google Ads и не использует внешние интеграции, миграцию кода выполнять не нужно. Достаточно уточнить у подрядчиков, какие версии API используют их сервисы. Предыдущие доступные версии не отключаются в день релиза v26: Google указывает, что deprecated-версии продолжают отвечать до даты sunset. Поэтому экстренно менять production-код без тестов не следует.
Главное несовместимое изменение: Enhanced Conversions
В v26 удалено поле enhanced_conversions_for_leads_enabled из ConversionTrackingSetting. Вместо него Google предлагает читать ConversionTrackingSetting.enablement_setting, а фактическую конфигурацию — через effective_enablement_setting. Оба значения используют единый enum EnhancedConversionsConfig.
Это изменение особенно важно для интеграций, которые перед загрузкой лидов проверяют статус Enhanced Conversions. Старый запрос после перехода на v26 перестанет соответствовать схеме. Возможный результат — ошибка запроса либо ложное решение внутренней логики о том, что улучшенные конверсии отключены.
Перед миграцией стоит найти все обращения к удалённому полю, обновить модели данных и отдельно проверить три сценария: функция включена, выключена и наследует настройку. Если CRM передаёт лиды по расписанию, тест нужно провести на копии задания с безопасным набором данных, а не впервые в production.
Local Services Performance Max требует обязательные поля
При создании Local Services Performance Max поле country_code теперь обязательно. Одновременно обязательным стал listing_id — идентификатор связанного профиля компании Google Business Profile. В API также появились отдельные ошибки для неподдерживаемой категории, несовпадающего location asset и некорректного listing ID.
Изменение касается именно программного создания этого типа кампаний. Оно не означает, что любой рекламодатель должен добавлять страну во все Performance Max кампании. Команде следует проверить ветку кода, которая формирует LocalServicesPmaxCampaignSettings, и валидировать оба значения до отправки запроса.
Для Казахстана здесь нужна осторожная трактовка. Релиз API глобальный, но доступность Local Services и конкретных категорий зависит от рынка и аккаунта. Если формат не используется, это изменение не требует перестройки текущих кампаний. Если международная платформа создаёт такие кампании в нескольких странах, страну и профиль нельзя подставлять одним общим значением для всех клиентов.
Что изменилось для Demand Gen и бюджетов
В CurrencyConstant добавлено поле demand_gen_info.minimum_budget_per_day_micros. Оно показывает минимальный дневной бюджет Demand Gen в конкретной валюте и обновляется при изменении порога, который применяет API.
Практическое следствие: форму создания кампаний и внутренние валидаторы лучше привязать к значению из API, а не хранить фиксированный минимум в коде. Для аккаунтов с тенге это помогает избежать расхождения между интерфейсом, документацией и собственной системой. Однако поле сообщает технический минимум, а не рекомендуемый бюджет для результата. Рабочий бюджет всё равно рассчитывается от стоимости конверсии, объёма аудитории и длительности теста.
Новые данные по конверсиям и измерению
В v26 появилась категория конверсии MESSAGE_LEAD для сообщений или чатов, которые показывают интерес к предложению. Для бизнеса, принимающего заявки через мессенджеры, это позволяет точнее описывать цель вместо объединения всех обращений в более общую категорию.
Также Google добавил поддержку Search Lift в API: новый ресурс для наборов ключевых слов, сегменты и показатели инкрементального поискового интереса. Это инструмент измерения, а не автоматическое доказательство эффективности любой кампании. Он полезен только при корректном дизайне исследования и достаточном объёме данных.
Поле Campaign.lift_measurement_config теперь связывает кампанию с конфигурацией lift-измерения. Если отчётный коннектор уже собирает Brand Lift или Conversion Lift, новую связь стоит добавить в модель заранее, чтобы исследования не приходилось сопоставлять вручную.
Маркировка сгенерированного контента для YouTube
Для загрузки видео через API добавлены метаданные о генеративном контенте. В YouTubeVideoUpload.video_content_metadata появилась настройка generative_content_disclosure. Она позволяет передать disclosure вместе с загрузкой ролика.
Из релиза нельзя делать вывод, что каждое видео, обработанное AI-инструментом, автоматически запрещено или требует одинаковой маркировки. Правило зависит от характера материала и политики платформы. Технической команде важно другое: если интерфейс производства контента уже собирает декларацию автора, это значение теперь можно не терять при автоматической публикации.
Проверьте путь данных целиком: бриф → генерация или монтаж → согласование → экспорт → API-загрузка. Если информация хранится только в комментарии к задаче, а загрузчик о ней не знает, новое поле останется пустым независимо от решения команды.
Упрощение декларации по политической рекламе в ЕС
В некоторых сценариях поле contains_eu_political_advertising стало необязательным. Условие действует, когда кампания не содержит положительного геотаргетинга внутри ЕС, не использует proximity или location group и при этом содержит хотя бы одну положительную локацию за пределами ЕС. Для Demand Gen с upgraded targeting проверка выполняется по активным группам объявлений.
Это может сократить число обязательных параметров для кампаний, нацеленных только на Казахстан. Но просто убрать поле из всех запросов нельзя: близость, группы местоположений или смешанный таргетинг снова делают декларацию обязательной. Надёжнее читать новые признаки require_eu_political_advertising_declaration у геокритериев и формировать запрос по фактической структуре кампании.
Почему ускорение релизов меняет процесс работы
Google рекомендует использовать последнюю версию API, но одновременно допускает постепенную миграцию: разные сервисы могут временно обращаться к разным доступным версиям. Это удобнее, чем одномоментное переключение всей рекламной инфраструктуры.
Новый темп не означает две обязательные несовместимые миграции каждый месяц. Основные версии могут содержать breaking changes, а минорные — добавляют обратно совместимые функции. Тем не менее команда должна отслеживать release notes чаще, потому что новые поля и ограничения будут появляться быстрее.
Полезно назначить владельца API-жизненного цикла. Он проверяет анонсы, фиксирует используемые версии, связывает изменение со всеми сервисами и планирует тестирование. Без этого один коннектор может обновиться, а другой продолжит читать устаревшую схему, из-за чего расхождение обнаружится только в отчётах.
Чек-лист перехода на v26
1. Составьте карту интеграций
Запишите все системы, которые обращаются к Google Ads API: CRM, call tracking, BI, генераторы кампаний, загрузчики конверсий, скрипты аудита и сторонние платформы. Для каждой укажите владельца, язык клиентской библиотеки, текущую версию API и критичность.
2. Проверьте фактическое использование версий
Google советует открыть Google Cloud Console, раздел APIs & Services, выбрать Google Ads API и посмотреть методы в метриках. Версия присутствует в имени метода. Это помогает найти забытый скрипт, которого нет в документации команды.
3. Обновите клиентскую библиотеку и endpoint
Минимальные версии библиотек для v26 уже опубликованы: например, Python 34.0.0, Java 48.0.0, PHP 35.2.0 и .NET 27.5.0. Зафиксируйте зависимости, обновите окружение и убедитесь, что запросы действительно уходят на v26, а не продолжают использовать старый endpoint.
4. Найдите несовместимые поля
Поиск по коду должен включать удалённое поле Enhanced Conversions, настройки Local Services PMax и гостиничные критерии, которые в v26 заменены более универсальными полями бронирования. Обновите обработку новых ошибок и сериализацию ответов.
5. Прогоните контрактные тесты
Проверьте чтение аккаунта, создание тестовой кампании, загрузку конверсии, построение ключевых отчётов и обработку ошибок. Сравните не только HTTP-статус, но и количество строк, суммы расходов, валюту, часовой пояс и значения конверсий между старой и новой версиями.
6. Разделите миграцию и новые функции
Сначала добейтесь эквивалентной работы существующей интеграции на v26. Затем отдельными изменениями включайте новые категории конверсий, Search Lift, YouTube disclosure и динамический минимум Demand Gen. Так проще определить причину расхождения.
7. Подготовьте откат и мониторинг
На время переключения сохраните возможность вернуть предыдущую доступную версию, если это допускает архитектура. Настройте оповещения по росту API-ошибок, пропускам загрузок и резкому изменению объёма отчётных данных. Дата успешного ответа ещё не подтверждает полноту данных.
Что проверить бизнесу в Казахстане
Для большинства рекламодателей задача состоит не в самостоятельной правке API, а в контроле поставщиков. Запросите у агентства или разработчика четыре ответа: какая версия используется, кто отвечает за обновление, пройдены ли тесты Enhanced Conversions и когда будет проверена v26.
Если лиды из Google Ads поступают в CRM и возвращаются обратно как квалифицированные обращения или продажи, главный приоритет — непрерывность конверсионного контура. Проверьте тестовый лид от клика до импорта, совпадение идентификаторов и отсутствие дублей. Для международных аккаунтов отдельно протестируйте валюты, страну профиля и правила EU-декларации.
Сам релиз v26 не улучшит результат рекламы автоматически. Его ценность — в новых возможностях и более точной модели данных. Практический выигрыш появляется только тогда, когда интеграция обновлена без потери конверсий, а новые поля используются для конкретной задачи.
Если нужно проверить рекламную инфраструктуру, связать кампании с CRM и безопасно обновить автоматизацию, закажите Google Рекламу в Казахстане. Мы проведём аудит интеграций, настроим измерение и подготовим план миграции без разрыва отчётности.