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

На этой странице указаны даты прекращения поддержки и вывода из эксплуатации версий 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 , чтобы узнавать о предстоящих важных обновлениях и прекращении поддержки существующих функций.

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

Особенность Дата вступления в силу Описание
Управление порядком размещения рекламы и таргетингом кампаний в 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, см. наш архивный список устаревших функций .