Объявленные устаревания

На этой странице указаны даты прекращения поддержки и вывода из эксплуатации версий API и отдельных функций в API Display & Video 360.

Информация об устаревании и прекращении поддержки API также будет опубликована в блоге разработчиков Google Ads .

Устаревшие версии

Версии API Display & Video 360 регулярно выпускаются, объявляются устаревшими и прекращают поддержку. Эти шаги определены следующим образом:

  • Релиз : Данная версия выходит из стадии альфа- или бета-тестирования и считается стабильной. В версию могут быть выпущены новые функции.
  • Устаревание : Данная версия выводится из эксплуатации, и объявлена ​​дата окончания поддержки. Пользователям необходимо перейти на более новую версию до этой даты. Новые функции для данной версии выпускаться не будут.
  • Завершение поддержки : Данная версия больше не поддерживается. Запросы к этой версии возвращают ошибку.

В этой таблице перечислены все существующие основные версии API Display & Video 360, даты их выпуска, а также даты прекращения поддержки и вывода из эксплуатации, если таковые были объявлены.

Версия API Дата выпуска Дата устаревания Дата заката Руководство по миграции
v4 27 марта 2025 г.
v3 31 октября 2023 г. 2 апреля 2025 г. 7 октября 2025 г. Переход с версии 3 на версию 4
v2 6 декабря 2022 г. 15 февраля 2024 г. 3 сентября 2024 г. Переход с версии 2 на версию 3
v1 9 марта 2020 г. 13 марта 2023 г. 14 сентября 2023 г. Переход с версии 1 на версию 2

Прекращение поддержки новых функций

Следите за нашим блогом для разработчиков Google Ads , чтобы узнавать о предстоящих важных обновлениях и прекращении поддержки существующих функций.

В этой таблице перечислены все объявленные устаревшие функции, затрагивающие работающие версии, с указанием даты вступления в силу, описания устаревания, рекомендуемых действий и ссылок на соответствующую документацию:

Особенность Дата вступления в силу Описание
Nielsen как сторонний поставщик услуг по измерению прироста узнаваемости бренда. 13 июля 2026 г.

Начиная с 13 июля 2026 года, Nielsen больше не сможет быть назначена сторонним поставщиком услуг по измерению роста узнаваемости бренда. В связи с этим в API Display & Video 360 и структурированные файлы данных будут внесены следующие изменения:

Использование услуг компании Nielsen в качестве поставщика услуг по повышению узнаваемости бренда будет прекращено.

Во избежание перебоев в работе сервиса удалите из вашей интеграции все назначения Nielsen в качестве поставщика услуг по повышению узнаваемости бренда.

Наследование названия компании и логотипа по умолчанию 13 июля 2026 г.

Начиная с 13 июля 2026 года, адаптивная реклама на YouTube начнет поддерживать названия компаний и логотипы, а вся реклама для генерации спроса и адаптивная реклама на YouTube с неуказанными названиями компаний и логотипами будет наследовать любые значения по умолчанию, установленные на уровне рекламодателя. Одновременно с этим, данное изменение повлечет за собой следующие изменения в поведении API Display & Video 360 и файлов структурированных данных:

  • Поля businessName , logo и logoImages в ресурсах ad_details Demand Gen AdGroupAd больше не будут обязательными, если родительскому рекламодателю присвоены значения по умолчанию. Если они не указаны, объявление унаследует значения по умолчанию на уровне рекламодателя.
  • В файлах Ad SDF для столбцов Business Name » и Logo Asset IDs можно будет задавать параметры для объявлений следующих типов: «Адаптивный», «Товар для генерации спроса», «Видео для генерации спроса», «Изображение для генерации спроса» и «Карусель для генерации спроса». Если для соответствующего объявления эти параметры не заданы, и родительскому рекламодателю присвоены значения по умолчанию, при сохранении объявления будут использованы значения по умолчанию на уровне рекламодателя.
  • В файлах Ad SDF столбцы Business Name и Logo Asset IDs больше не требуются для объявлений, генерирующих спрос, если родительский рекламодатель назначил значения по умолчанию.

Если на уровне рекламодателя заданы значения по умолчанию, всем объявлениям этого рекламодателя будут присвоены название компании и значение логотипа. Если вы хотите оставить значения названия компании и логотипа для адаптивных объявлений YouTube неустановленными, не устанавливайте значения по умолчанию для вашего рекламодателя .

Управление порядком размещения рекламы и таргетингом кампаний в Display & Video 360 API и структурированных файлах данных. 23 февраля 2026 г.

23 февраля 2026 года Display & Video 360 прекратит поддержку заказов на размещение рекламы и таргетинга кампаний. В связи с этим будут внесены изменения в API Display & Video 360 и файлы структурированных данных (SDF). В API Display & Video 360 будет прекращена поддержка части методов, которые при вызове будут возвращать ошибку. В файлах SDF столбцы таргетинга в файлах заказов на размещение рекламы и кампаний больше не будут заполняться при загрузке и должны оставаться пустыми при выгрузке. Рекомендуется назначать таргетинг непосредственно позициям заказа при их создании.

Следующие методы API Display & Video 360 при вызове вернут ошибку 404 :

При загрузке записей SDF кампании , в которых значениям присвоены следующие столбцы, произойдет ошибка:

  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Environment Targeting

При загрузке записей SDF в порядке вставки , в которых значения присвоены следующим столбцам, произойдет ошибка:

  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Proximity Targeting
  • Proximity Location List Targeting
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Device Targeting - Include
  • Device Targeting - Exclude
  • Browser Targeting - Include
  • Browser Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Channel Targeting - Include
  • Channel Targeting - Exclude
  • Site Targeting - Include
  • Site Targeting - Exclude
  • App Targeting - Include
  • App Targeting - Exclude
  • App Collection Targeting - Include
  • App Collection Targeting - Exclude
  • Category Targeting - Include
  • Category Targeting - Exclude
  • Content Genre Targeting - Include
  • Content Genre Targeting - Exclude
  • Keyword Targeting - Include
  • Keyword Targeting - Exclude
  • Keyword List Targeting - Exclude
  • Audience Targeting - Include
  • Audience Targeting - Exclude
  • Affinity & In Market Targeting - Include
  • Affinity & In Market Targeting - Exclude
  • Custom List Targeting
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Daypart Targeting
  • Daypart Targeting Time Zone
  • Environment Targeting
  • Viewability Omid Targeting Enabled
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Position Targeting - Audio Position In Content
  • Video Player Size Targeting
  • Content Duration Targeting
  • Content Stream Type Targeting
  • Audio Content Type Targeting
  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Connection Speed Targeting
  • Carrier Targeting - Include
  • Carrier Targeting - Exclude
Укажите, используются ли отдельные статьи расходов для размещения политической рекламы в ЕС. 8 сентября 2025 г.

Начиная с 8 сентября 2025 года, при создании новой позиции в рекламном блоке с использованием Display & Video 360 API или SDF-файлов вам потребуется указывать, будет ли в ней размещаться политическая реклама Европейского союза. Эти указания можно сделать следующими способами:

Если ваш основной рекламодатель не будет содержать позиций, содержащих политическую рекламу ЕС, вы можете указать это на уровне рекламодателя, используя поле containsEuPoliticalAds в ресурсе Display & Video 360 API Advertiser . Если для этого поля установлено значение DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING , то всем новым позициям в рамках этого рекламодателя будет присвоено то же значение, если не указано иное, а все существующие позиции в рамках этого рекламодателя будут обновлены с использованием того же значения, если оно еще не задано. Объявление позиции можно обновить в любое время после создания с помощью пользовательского интерфейса, API или SDF.

Если вы не можете указать это на уровне рекламодателя или уже указали, что политическая реклама ЕС может показываться через вашего рекламодателя, обновите API Display & Video 360 и интеграцию SDF до 8 сентября 2025 года, чтобы избежать перебоев в работе сервиса:

  • При выполнении запроса advertisers.lineItems.create установите поле containsEuPoliticalAds в новом ресурсе LineItem .
  • Установите поле containsEuPoliticalAds в теле запроса для всех запросов advertisers.lineItems.duplicate и advertisers.lineItems.generateDefault .
  • Перейдите на использование структурированных файлов данных версии 9 и установите для столбца Contains EU Political Ads значение Yes или No для всех новых позиций при загрузке. Пошаговые инструкции см. в нашем руководстве по миграции на версию 9 .
  • Перед обновлением географических параметров для существующей позиции заказа с использованием Display & Video 360 API или SDF, обновите позицию заказа, добавив соответствующее объявление.
Настройки категорий контента для YouTube и партнеров (по позициям) 12 июня 2025 г.

С 12 июня 2025 года настройки категорий контента для отдельных позиций YouTube и партнеров больше не будут доступны для изменения на уровне бренда в рамках обновления интерфейса соответствия бренду . Настройки категорий контента будут контролироваться исключительно на уровне рекламодателя. Для внесения этого изменения будут внесены следующие изменения в API Display & Video 360 и файлы структурированных данных:

  • Поле contentCategory в объектах YoutubeAndPartnersSettings ресурсов LineItem YouTube & Partners больше не будет обновляться. Оно будет полностью удалено позднее.
  • Столбец TrueView Content Filter в файлах SDF позиций больше не будет доступен для записи.
Во избежание перебоев в обслуживании:
  • При просмотре позиций, относящихся к YouTube и партнерам, в API, вместо поля contentCategory следует использовать поле effectiveContentCategory .
  • Прекратите изменять столбец TrueView Content Filter при обновлении записей позиций SDF . Оставляйте столбец пустым при создании новых позиций.
Обновление бюджета по статьям расходов с оптимизацией заказов на размещение рекламы. 12 июня 2025 г.

Начиная с 12 июня 2025 года, вы больше не сможете обновлять настройки бюджета для позиций, в которых для родительских заказов на размещение заданий установлен режим оптимизации с использованием автоматизированных стратегий назначения ставок.

Во избежание перебоев в обслуживании:
Ограничения на использование структурированных файлов данных на разных сайтах 12 июня 2025 г.

Начиная с 12 июня 2025 года, мы снимем существующее ограничение для URL-адресов, указанных в записях SDF, которое не позволяло включать новые сайты. Вместо этого SDF будет учитывать поведение API и пользовательского интерфейса и позволит указывать URL-адреса при условии, что они имеют правильный формат.

Это относится к Site Targeting - Include и Site Targeting - Exclude столбцов в файлах заказов на вставку и позиций заказа .
Столбец «Множители ставок» в структурированных файлах данных по позициям заказа. 1 мая 2025 г.

С 1 мая 2025 года записи в структурированных файлах данных позиций , пытающиеся установить значение столбца «Множители ставки», не смогут создать или обновить ресурс при загрузке файла.

Для позиций в строке генерации спроса в структурированных файлах данных необходимо указать источник данных о партнерских видеоресурсах. 22 апреля 2025 г.

Начиная с 22 апреля 2025 года, вам потребуется указывать значение «Видеопартнеры» в столбце TrueView Inventory Source Targeting для позиций , у которых значение столбца Type » равно «Генерация спроса». После вступления в силу этого правила значение будет автоматически заполняться для существующих позиций и включаться при загрузке новых файлов структурированных данных.

Во избежание перебоев в обслуживании:

  • Обновите интеграцию, добавив значение "Видеопартнеры" во все позиции в списке запросов на генерацию спроса.
  • Обновите интеграцию, чтобы управлять источниками инвентаря для генерации спроса на уровне группы объявлений, используя столбцы группы объявлений SDF v8.1 « Demand Gen Inventory Source Strategy и Demand Gen Enabled Inventory Sources .
Видеокампании в структурированных файлах данных 22 апреля 2025 г.

С 22 апреля 2025 года создание позиций для видеокампаний с использованием структурированных файлов данных будет прекращено, поскольку система будет переведена на генерацию спроса . Попытки загрузки позиций со значением столбца «Действие» Subtype « Type » и значением столбца «TrueView» приведут к ошибке.

Во избежание перебоев в работе сервиса обновите интеграцию, чтобы использовать генерацию спроса вместо видеокампаний.

Бессрочная подписка для аудитории, использующей собственные сервисы. 7 апреля 2025 г.

7 апреля 2025 года ресурсы FirstAndThirdPartyAudience больше не будут допускать неограниченную продолжительность членства в аудитории. Запросы firstAndThirdPartyAudiences.create и firstAndThirdPartyAudiences.patch , устанавливающие значение поля membershipDurationDays равным 10 000, будут возвращать ошибку 400 Существующие аудитории со значением поля membershipDurationDays равным 10 000 будут обновлены до 540, и новая продолжительность членства будет применена задним числом к ​​существующим подпискам. Это приведет к аннулированию всех подписок старше 540 дней.

Во избежание перебоев в обслуживании:

  • Убедитесь, что ваша интеграция не устанавливает значение поля membershipDurationDays для новых или существующих аудиторий равным 10 000.
  • Обновите состав существующих аудиторий Customer Match, используя команду firstAndThirdPartyAudiences.editCustomerMatchMembers .
  • Регулярно обновляйте данные о членстве в группах Customer Match, чтобы размер списка ваших аудиторий не уменьшался непреднамеренно.

В версии 4 это изменение отражено в ресурсах FirstPartyAndPartnerAudience .

Несоответствие алгоритма назначения пользовательских ставок и активности прожектора. 1 апреля 2025 г.

1 апреля 2025 года:

Во избежание перебоев в работе сервиса обновите интеграцию следующим образом:

  • Убедитесь, что соответствующие действия по освещению назначены позиции до или одновременно с назначением пользовательского алгоритма назначения ставок.
  • Перед попыткой обновления существующие пользовательские алгоритмы назначения ставок отменяются для всех позиций заказа.

Предыдущие устаревшие функции

Чтобы узнать о заявленных изменениях, затрагивающих устаревающие версии API Display & Video 360, см. наш архивный список устаревших функций .