Объявленное прекращение поддержки

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

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

Прекращение поддержки версий

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

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

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

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

В таблице ниже перечислены все объявленные прекращения поддержки функций, которые влияют на текущие версии. Также указаны даты вступления в силу, описания, рекомендуемые действия и ссылки на документацию.

Функция Дата вступления в силу Описание
В адаптивных объявлениях для YouTube теперь требуется указывать название и логотип компании

Дата вступления в силу обновлена

 Январь 2027 г.

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

В результате столбцы Business Name и Logo Asset IDs в SDF-файлах типа Объявление будут обязательными для объявлений типа "Адаптивное", если родительскому рекламодателю не назначены значения по умолчанию. Если значение по умолчанию задано, а столбец оставлен пустым, то при сохранении объявление унаследует значения по умолчанию, заданные на уровне рекламодателя.
Прекращение поддержки исключения деликатных категорий 1 октября 2026 г.

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

  • Следующие значения перечисления SensitiveCategory будут объявлены устаревшими и больше не будут приниматься в поле excludedSensitiveCategory объекта SensitiveCategoryAssignedTargetingOptionDetails при назначении таргетинга типа TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION:
    • SENSITIVE_CATEGORY_ADULT
    • SENSITIVE_CATEGORY_ALCOHOL
    • SENSITIVE_CATEGORY_DEROGATORY
    • SENSITIVE_CATEGORY_DOWNLOADS_SHARING
    • SENSITIVE_CATEGORY_DRUGS
    • SENSITIVE_CATEGORY_GAMBLING
    • SENSITIVE_CATEGORY_POLITICS
    • SENSITIVE_CATEGORY_PROFANITY
    • SENSITIVE_CATEGORY_RELIGION
    • SENSITIVE_CATEGORY_SENSITIVE_SOCIAL_ISSUES
    • SENSITIVE_CATEGORY_SHOCKING
    • SENSITIVE_CATEGORY_SUGGESTIVE
    • SENSITIVE_CATEGORY_TOBACCO
    • SENSITIVE_CATEGORY_TRAGEDY
    • SENSITIVE_CATEGORY_TRANSPORTATION_ACCIDENTS
    • SENSITIVE_CATEGORY_VIOLENCE
    • SENSITIVE_CATEGORY_WEAPONS
  • В столбце Brand Safety Sensitivity Setting в файлах структурированных данных для позиций больше не будет варианта "Использовать специальные настройки".
  • Столбец Brand Safety Custom Settings в файлах структурированных данных типа Позиция больше не будет поддерживаться и при скачивании будет заполняться пустым значением.
Прекращение поддержки исключения ярлыков цифрового контента 1 октября 2026 г.

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

  • Следующие значения перечисления ContentRatingTier будут объявлены устаревшими и больше не будут приниматься в поле excludedContentRatingTier объекта DigitalContentLabelAssignedTargetingOptionDetails при назначении таргетинга типа TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION:
    • CONTENT_RATING_TIER_FAMILIES
    • CONTENT_RATING_TIER_GENERAL
    • CONTENT_RATING_TIER_MATURE
    • CONTENT_RATING_TIER_PARENTAL_GUIDANCE
    • CONTENT_RATING_TIER_TEENS
    • CONTENT_RATING_TIER_UNSPECIFIED
  • В столбце Digital Content Labels - Exclude в SDF-файлах позиций можно указать только значение "?". В противном случае столбец должен быть пустым. Если вы попытаетесь назначить другое значение, при загрузке произойдет ошибка.
Nielsen как сторонний поставщик данных Brand Lift 13 июля 2026 г.

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

Nielsen больше не будет использоваться в качестве поставщика Brand Lift.

Чтобы избежать перебоев в работе сервиса, удалите из интеграции все назначения Nielsen в качестве поставщика Brand Lift.

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

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

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

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

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

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

При вызове следующих методов Display & Video 360 API будет возвращаться ошибка 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

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

  • 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 г. при создании новой позиции с помощью Дисплей и Видео 360 API или SDF вам потребуется сообщить, будет ли позиция содержать политическую рекламу для Европейского союза. Это можно сделать следующими способами:

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

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

  • Задайте поле containsEuPoliticalAds в новом ресурсе LineItem при выполнении запроса advertisers.lineItems.create.
  • Задайте поле 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 и партнерских видеоресурсов. Настройки категорий контента будут задаваться только на уровне рекламодателя. В связи с этим в Display & Video 360 API и файлах структурированных данных будут внесены следующие изменения:

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

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

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

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

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

С 1 мая 2025 г. при попытке создать или обновить ресурс путем загрузки файла структурированных данных, в котором в столбце "Мультипликаторы ставок" указаны записи для позиций, будет возникать ошибка.
Требовать источник инвентаря партнерских видеоресурсов для позиций кампаний для создания спроса в файлах структурированных данных 22 апреля 2025 г.

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

Чтобы избежать перебоев в работе сервиса:

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

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

Чтобы избежать перебоев в работе, обновите интеграцию и используйте кампании для создания спроса вместо кампаний Video Action.
Бесконечный срок хранения данных для собственных аудиторий. 7 апреля 2025 г.

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

Чтобы избежать перебоев в работе сервиса:

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

В версии 4 это изменение отражено в ресурсах FirstPartyAndPartnerAudience.
Несоответствие алгоритма специальных ставок и действий Floodlight 1 апреля 2025 г.

1 апреля 2025 г. произойдет следующее:

Чтобы избежать перебоев в работе сервиса, обновите интеграцию:

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

Прекращение поддержки функций в прошлом

Информацию о прекращении поддержки устаревших версий Display & Video 360 API можно найти в архиве.