Версии API Display & Video 360 регулярно выпускаются, объявляются устаревшими и прекращают поддержку. Эти шаги определены следующим образом:
Релиз : Данная версия выходит из стадии альфа- или бета-тестирования и считается стабильной. В версию могут быть выпущены новые функции.
Устаревание : Данная версия выводится из эксплуатации, и объявлена дата окончания поддержки. Пользователям необходимо перейти на более новую версию до этой даты. Новые функции для данной версии выпускаться не будут.
Завершение поддержки : Данная версия больше не поддерживается. Запросы к этой версии возвращают ошибку.
В этой таблице перечислены все существующие основные версии API Display & Video 360, даты их выпуска, а также даты прекращения поддержки и вывода из эксплуатации, если таковые были объявлены.
Следите за нашим блогом для разработчиков Google Ads , чтобы узнавать о предстоящих важных обновлениях и прекращении поддержки существующих функций.
В таблице ниже перечислены все объявленные случаи прекращения поддержки новых функций, указаны дата вступления в силу, описание прекращения поддержки с рекомендациями по дальнейшим действиям и ссылками на соответствующую документацию:
Особенность
Дата вступления в силу
Описание
Расширение таргетинга
25 марта 2023 г.
Замена функции расширения таргетинга на оптимизированный таргетинг , внедряемая постепенно с 25 марта 2023 года по начало мая 2023 года. Соответствующие изменения в поведении API Display & Video 360 и файлов структурированных данных, а также рекомендуемые действия были объявлены в сообщении в блоге .
Ручные триггеры
17 мая 2023 г.
Хронология:
17 мая 2023 г.: Показы позиций, использующих ручные триггеры, в Display & Video 360 прекратятся. Если вы активируете ручной триггер, связанный с активной позицией после этой даты, по этой позиции реклама показываться не будет.
Установленные приложения и новые мобильные устройства. Типы GoogleAudience
20 мая 2023 г.
Хронология:
20 мая 2023 г.: Вы больше не сможете назначать ресурсы GoogleAudience с типом GoogleAudienceTypeGOOGLE_AUDIENCE_TYPE_INSTALLED_APPS или GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES для таргетинга аудитории по позициям или заказам на добавление. Запросы, назначающие эти аудитории для таргетинга аудитории по позициям, будут возвращать ошибку. Это касается запросов advertisers.lineItems.duplicate и advertisers.lineItems.generateDefault , если создаваемая позиция включает устаревшие аудитории в свой таргетинг.
8 июня 2023 г.: Затронутые аудитории будут удалены из всех целевых групп по позициям и заказам на размещение рекламы, а также из всех объединенных аудиторий. Если по позициям не удается показывать рекламу после удаления этих аудиторий, их показ будет приостановлен. С этой даты эти аудитории также больше не будут доступны для получения через сервис googleAudiences .
Рекомендуемые задачи:
Мы рекомендуем вам немедленно прекратить использование затронутых аудиторий при внесении будущих изменений в таргетинг по отдельным позициям.
Удалите все затронутые аудитории из существующих настроек таргетинга по позициям и заказам на размещение рекламы. Подробнее об обновлении настроек таргетинга аудитории читайте в нашем руководстве по целевым аудиториям .
20 мая 2023 г.: Вы больше не сможете назначать ресурсы FirstAndThirdPartyAudience с AudienceTypeACTIVITY_BASED или FREQUENCY_CAP для таргетинга по позициям или заказам на добавление. Запросы, назначающие эти аудитории для таргетинга по позициям, будут возвращать ошибку. Это касается запросов advertisers.lineItems.duplicate и advertisers.lineItems.generateDefault , если создаваемая позиция будет включать устаревшие аудитории в свой таргетинг.
8 июня 2023 г.: Затронутые аудитории будут удалены из всех целевых групп по позициям и заказам на размещение рекламы, а также из всех объединенных аудиторий. Если по позициям не удается показывать рекламу после удаления этих аудиторий, их показ будет приостановлен. С этой даты эти аудитории также больше не будут доступны для получения с помощью сервиса firstAndThirdPartyAudiences .
Рекомендуемые задачи:
Мы рекомендуем вам немедленно прекратить использование затронутых аудиторий при внесении будущих изменений в таргетинг по отдельным позициям.
Удалите все затронутые аудитории из существующих настроек таргетинга по позициям и заказам на размещение рекламы. Подробнее об обновлении настроек таргетинга аудитории читайте в нашем руководстве по целевым аудиториям .
Существующие ограничения квот API
30 мая 2023 г.
30 мая 2023 года существующие ограничения на использование будут заменены гибридной квотной структурой, которая предусматривает следующее:
Устраняет квоту на количество запросов в день по каждому проекту.
Вводит квоту на количество запросов в минуту на одного рекламодателя на один проект для соответствующих методов.
Эти новые ограничения обеспечат большую гибкость в использовании API и позволят распараллеливать запросы между рекламодателями. Подробности об этом изменении содержатся в нашей существующей документации по ограничениям квот .
Использование оператора OR между ограничениями различных полей в фильтрах LIST
21 июня 2023 г.
С 21 июня 2023 года в параметрах filter запросов LIST больше не будет возможности использовать логические операторы OR между ограничениями разных полей.
Например, ресурсы, идентифицированные с помощью строки фильтра lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" , должны быть получены с помощью двух запросов LIST со следующими строками фильтра:
Перед 21 июня 2023 года проверьте параметры filter всех существующих вызовов LIST и убедитесь, что в них правильно используется логический оператор OR, чтобы избежать перебоев в обслуживании.
Чтобы избежать перебоев в обслуживании, удалите всю логику фильтрации, использующую эти четыре поля, до 21 июня 2023 года.
Покупка, ориентированная на результат
1 августа 2023 г.
С 1 августа 2023 года заказы на размещение рекламы, использующие систему оплаты на основе результатов, определяемую значением поля billableOutcome , равным BILLABLE_OUTCOME_PAY_PER_CLICK или BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION , и их дочерние позиции будут архивированы.
Это изменение затронет следующие запросы:
Попытка использовать advertisers.insertionOrders.create для создания заказа на вставку с использованием покупки на основе результатов приведет к ошибке 400
Параметры таргетинга с автоматическим прекращением действия будут удалены из существующих параметров таргетинга по отдельным позициям. Эти значения по-прежнему будут доступны для использования в таргетинге на уровне рекламодателя.
Во избежание перебоев в предоставлении услуг, удалите этот таргетинг из всех существующих позиций в разделе «YouTube и партнеры» до даты прекращения действия услуги.
Целевая аудитория Oracle (как собственная, так и сторонняя)
30 сентября 2024 г.
30 сентября 2024 года ресурсы FirstAndThirdPartyAudience от Oracle будут прекращены. После прекращения поддержки эти аудитории будут удалены из всех существующих целевых аудиторий и объединенных аудиторий. Если позиция в базе данных ориентирована только на аудитории, поддержка которых прекращена, или негативно влияет на любые аудитории, поддержка которых прекращена, это обновление автоматически приостановит действие данной позиции.
Во избежание перебоев в обслуживании, перед датой прекращения поддержки необходимо выявить и удалить все аудитории Oracle из существующих целевых аудиторий по позициям заказа и объединенных аудиторий.
Оптимизированное таргетирование по отдельным позициям для подмножества стратегий назначения ставок
Во избежание перебоев в работе сервиса обновите и проверьте, что для позиций, использующих эти стратегии назначения ставок, не включено оптимизированное таргетинговое нацеливание.
Отправка рейса как можно скорее. Pacing заказов на размещение рекламы.
5 ноября 2024 г.
С 5 ноября 2024 года PACING_TYPE_ASAP перестанет быть совместимым с PACING_PERIOD_FLIGHT при настройке поля « pacing заказа на вставку». pacingType для всех существующих заказов на вставку с такой конфигурацией будет обновлен до PACING_TYPE_AHEAD .
Во избежание перебоев в обслуживании обновите pacing существующих заказов на вставку, используя PACING_TYPE_ASAP и PACING_PERIOD_FLIGHT .
Ограничение частоты обновления более 30 дней
28 февраля 2025 г.
28 февраля 2025 года:
Запросы на создание или обновление ресурсов LineItem , InsertionOrder и Campaign с использованием объекта FrequencyCap , у которого поле timeUnit установлено в значение TIME_UNIT_LIFETIME или поле timeUnit установлено в значение TIME_UNIT_MONTH , а поле timeUnitCount установлено в значение 2, вернут ошибку 400 .
Записи в структурированных файлах данных «Позиция заказа», «Заказ на размещение» и «Кампания» , у которых значение столбца «Период частоты» равно «Весь срок», либо значение столбца «Период частоты» равно «Месяцы», а значение столбца «Количество случаев» равно «2», не будут созданы или обновлены при загрузке файла.
В существующих рекламных кампаниях, заказах на размещение рекламы и отдельных позициях будет установлен период ограничения частоты показов в 30 дней или менее.
Во избежание перебоев в обслуживании:
Обновите существующие ресурсы кампании, заказов на размещение рекламы и позиций, для которых период ограничения частоты показов превышает 30 дней, установив его значение равным 30 дням или менее.
Убедитесь, что ваша интеграция не устанавливает период ограничения частоты показов более 30 дней при создании или обновлении ресурсов кампании, заказа на размещение рекламы или позиций заказа с использованием API Display & Video 360 или структурированных файлов данных.
Оптимизированное таргетирование позиций с использованием фиксированных ставок.
Записи в структурированных файлах данных по позициям , у которых значение столбца «Тип стратегии ставок» равно «Фиксированное», а значение столбца «Оптимизированное таргетирование» равно «Истина», не будут создаваться или обновляться при загрузке файла.
В существующих позициях, использующих фиксированную ставку, будет отключен оптимизированный таргетинг.
Во избежание перебоев в обслуживании:
Обновите существующие ресурсы по позициям, использующие как фиксированные ставки, так и оптимизированный таргетинг.
Убедитесь, что ваша интеграция не устанавливает фиксированную стратегию назначения ставок и оптимизированный таргетинг при создании или обновлении позиций ресурсов с использованием API Display & Video 360 или структурированных файлов данных.
Обновите размер страницы по умолчанию для файла firstAndThirdPartyAudiences.list
Во избежание перебоев в работе сервиса обновите интеграцию, установив параметр запроса pageSize в запросах firstAndThirdPartyAudiences.list на желаемый размер страницы.
Новая ошибка несоответствия партнера/рекламодателя sdfdownloadtasks.create
Ограничения на количество пунктов в списке YouTube Reach в SDF
24 марта 2025 г.
С 24 марта 2025 года для создания или обновления позиций в документах, использующих структурированные файлы данных, потребуется применение более расширенных форматов рекламы. Это означает следующее:
В версиях SDF v6 и v7 больше не поддерживается создание новых записей в файле позиций с Subtype "Reach".
Новые записи в файлах позиций SDF со значением Subtype "Reach" должны использовать значение "Responsive" в столбце " TrueView Video Ad Formats ". Существующие записи со значением Subtype "Reach" не могут обновлять значение в столбце TrueView Video Ad Formats .
Для добавления новых записей в файлы позиций SDF со значением Subtype "Охват" необходимо заполнить столбец " TrueView Video Ad Inventory Control ".
Несоответствие алгоритма назначения пользовательских ставок и активности прожектора.
В файлах структурированных данных по позициям , где предпринимается попытка обновить столбец "Идентификаторы действий по преобразованию", если задан столбец "Идентификатор алгоритма", обновление при загрузке файла завершится неудачей.
Во избежание перебоев в работе сервиса обновите интеграцию следующим образом:
Убедитесь, что соответствующие действия по освещению назначены позиции до или одновременно с назначением пользовательского алгоритма назначения ставок.
Перед попыткой обновления существующие пользовательские алгоритмы назначения ставок отменяются для всех позиций заказа.
Бессрочная подписка для аудитории, использующей собственные сервисы.
7 апреля 2025 г.
7 апреля 2025 года ресурсы FirstAndThirdPartyAudience больше не будут допускать неограниченную продолжительность членства в аудитории. Запросы firstAndThirdPartyAudiences.create и firstAndThirdPartyAudiences.patch , устанавливающие значение поля membershipDurationDays равным 10 000, будут возвращать ошибку 400 Существующие аудитории со значением поля membershipDurationDays равным 10 000 будут обновлены до 540, и новая продолжительность членства будет применена задним числом к существующим подпискам. Это приведет к аннулированию всех подписок старше 540 дней.
Во избежание перебоев в обслуживании:
Убедитесь, что ваша интеграция не устанавливает значение поля membershipDurationDays для новых или существующих аудиторий равным 10 000.
С 22 апреля 2025 года создание позиций для видеокампаний с использованием структурированных файлов данных будет прекращено, поскольку система будет переведена на генерацию спроса . Попытки загрузки позиций со значением столбца «Действие» Subtype « Type » и значением столбца «TrueView» приведут к ошибке.
Во избежание перебоев в работе сервиса обновите интеграцию, чтобы использовать генерацию спроса вместо видеокампаний.
Для позиций в строке генерации спроса в структурированных файлах данных необходимо указать источник данных о партнерских видеоресурсах.
22 апреля 2025 г.
Начиная с 22 апреля 2025 года, вам потребуется указывать значение «Видеопартнеры» в столбце TrueView Inventory Source Targeting для позиций , у которых значение столбца Type » равно «Генерация спроса». После вступления в силу этого правила значение будет автоматически заполняться для существующих позиций и включаться при загрузке новых файлов структурированных данных.
Во избежание перебоев в обслуживании:
Обновите интеграцию, добавив значение "Видеопартнеры" во все позиции в списке запросов на генерацию спроса.
Обновите интеграцию, чтобы управлять источниками инвентаря для генерации спроса на уровне группы объявлений, используя столбцы группы объявлений SDF v8.1 «Demand Gen Inventory Source Strategy и Demand Gen Enabled Inventory Sources .
Столбец «Множители ставок» в структурированных файлах данных по позициям заказа.
1 мая 2025 г.
С 1 мая 2025 года записи в структурированных файлах данных позиций , пытающиеся установить значение столбца «Множители ставки», не смогут создать или обновить ресурс при загрузке файла.
Настройки категорий контента для YouTube и партнеров (по позициям)
12 июня 2025 г.
С 12 июня 2025 года настройки категорий контента для отдельных позиций YouTube и партнеров больше не будут доступны для изменения на уровне бренда в рамках обновления интерфейса соответствия бренду . Настройки категорий контента будут контролироваться исключительно на уровне рекламодателя. Для внесения этого изменения будут внесены следующие изменения в API Display & Video 360 и файлы структурированных данных:
Прекратите изменять столбец TrueView Content Filter при обновлении записей позиций SDF . Оставляйте столбец пустым при создании новых позиций.
Обновление бюджета по статьям расходов с оптимизацией заказов на размещение рекламы.
12 июня 2025 г.
Начиная с 12 июня 2025 года, вы больше не сможете обновлять настройки бюджета для позиций, в которых для родительских заказов на размещение заданий установлен режим оптимизации с использованием автоматизированных стратегий назначения ставок.
В SDF: проверьте, установлено ли значение TRUE в столбце Insertion Order Optimization для родительского заказа на вставку в записи SDF. Если да, не пытайтесь обновлять столбцы « Budget Type или Budget Amount для записи SDF в позиции .
Ограничения на использование структурированных файлов данных на разных сайтах
12 июня 2025 г.
Начиная с 12 июня 2025 года, мы снимем существующее ограничение для URL-адресов, указанных в записях SDF, которое не позволяло включать новые сайты. Вместо этого SDF будет учитывать поведение API и пользовательского интерфейса и позволит указывать URL-адреса при условии, что они имеют правильный формат.
Укажите, используются ли отдельные статьи расходов для размещения политической рекламы в ЕС.
8 сентября 2025 г.
Начиная с 8 сентября 2025 года, при создании новой позиции в рекламном блоке с использованием Display & Video 360 API или SDF-файлов вам потребуется указывать, будет ли в ней размещаться политическая реклама Европейского союза. Эти указания можно сделать следующими способами:
Использование столбца Contains EU Political Ads в файле типа «Позиция в файле» SDF v9.
Если ваш основной рекламодатель не будет содержать позиций, содержащих политическую рекламу ЕС, вы можете указать это на уровне рекламодателя, используя поле containsEuPoliticalAds в ресурсе Display & Video 360 API Advertiser . Если для этого поля установлено значение DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING , то всем новым позициям в рамках этого рекламодателя будет присвоено то же значение, если не указано иное, а все существующие позиции в рамках этого рекламодателя будут обновлены с использованием того же значения, если оно еще не задано. Объявление позиции можно обновить в любое время после создания с помощью пользовательского интерфейса, API или SDF.
Если вы не можете указать это на уровне рекламодателя или уже указали, что политическая реклама ЕС может показываться через вашего рекламодателя, обновите API Display & Video 360 и интеграцию SDF до 8 сентября 2025 года, чтобы избежать перебоев в работе сервиса:
Перейдите на использование структурированных файлов данных версии 9 и установите для столбца Contains EU Political Ads значение Yes или No для всех новых позиций при загрузке. Пошаговые инструкции см. в нашем руководстве по миграции на версию 9 .
Перед обновлением географических параметров для существующей позиции заказа с использованием Display & Video 360 API или SDF, обновите позицию заказа, добавив соответствующее объявление.
Управление порядком размещения рекламы и таргетингом кампаний в 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 :
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2026-01-21 UTC."],[],[]]