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

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

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

Устаревание версий

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

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

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

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

Устаревание функций

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

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

Особенность Первоначальная дата вступления в силу Описание
Расширение таргетинга 25 марта 2023 г. Замена функции расширения таргетинга оптимизированным таргетингом постепенно внедрялась с 25 марта 2023 года по начало мая 2023 года. Соответствующие изменения в API Display & Video 360 и поведении структурированных файлов данных, а также рекомендуемые действия были объявлены в сообщении в блоге .
Ручные триггеры 17 мая 2023 г.

Хронология:

  • 17 мая 2023 г.: Позиции, использующие ручные триггеры, перестанут отображаться в Display & Video 360. Если вы активируете ручной триггер, связанный с активной позицией, после этой даты, эта позиция не будет показывать рекламу.
  • 1 августа 2023 г.: сервис advertisers.manualTriggers в DV360 API v1 и v2, значение перечисления LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER в DV360 API v1 и поле LineItemFlight.triggerId в DV360 API v1 прекратят работу. После этой даты запросы к этим сервисам или полям будут возвращать ошибку.

Рекомендуемые действия:

  • Немедленно прекратите использовать ручные триггеры для запуска и остановки показа позиций.
  • Прекратите отправлять запросы в службу advertisers.manualTriggers .
  • Обновите поля flight.flightDateType и flight.triggerId для всех позиций, используя ручные триггеры.
Типы GoogleAudience для установленных приложений и новых мобильных устройств 20 мая 2023 г.

Хронология:

  • 20 мая 2023 г.: Вы больше не сможете назначать ресурсы GoogleAudience с типом GoogleAudienceType , равным GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS или GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES , для таргетинга аудитории позиции или заказа на размещение. Запросы на назначение этих аудиторий для таргетинга аудитории позиции будут возвращать ошибку. Это относится и к запросам advertisers.lineItems.duplicate и advertisers.lineItems.generateDefault , если созданная позиция будет включать устаревшие аудитории в свой таргетинг аудитории.
  • 8 июня 2023 г.: затронутые аудитории будут удалены из всех таргетингов позиций и заказов на размещение, а также из всех комбинированных аудиторий. Если позиция не может показывать рекламу после удаления этих аудиторий, они будут приостановлены. С этой даты эти аудитории также больше не будут доступны для извлечения с помощью сервиса googleAudiences .

Рекомендуемые задачи:

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

Хронология:

  • 20 мая 2023 г.: Вы больше не сможете назначать ресурсы FirstAndThirdPartyAudience с AudienceType , равным ACTIVITY_BASED или FREQUENCY_CAP , таргетингу аудитории позиции или заказа на размещение. Запросы на назначение этих аудиторий таргетингу аудитории позиции будут возвращать ошибку. Это касается запросов advertisers.lineItems.duplicate и advertisers.lineItems.generateDefault , если созданная позиция будет включать устаревшие аудитории в свой таргетинг аудитории.
  • 8 июня 2023 г.: Затронутые аудитории будут удалены из всех таргетингов позиций и заказов на размещение, а также из всех комбинированных аудиторий. Если позиция не может показывать рекламу после удаления этих аудиторий, они будут приостановлены. С этой даты эти аудитории также больше не будут доступны для извлечения с помощью сервиса firstAndThirdPartyAudiences .

Рекомендуемые задачи:

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

30 мая 2023 года существующие лимиты использования будут заменены гибридной структурой квот, которая выполняет следующие функции:

  1. Устраняет квоту запросов в день на проект.
  2. Устанавливает квоту на количество запросов в минуту на рекламодателя на проект для квалификационных методов.

Эти новые ограничения обеспечат большую гибкость в использовании API и позволят распараллеливать запросы между рекламодателями. Подробная информация об этом изменении представлена ​​в нашей текущей документации по ограничениям квот .

Использование оператора OR между ограничениями различных полей в фильтрах LIST

21 июня 2023 г.

С 21 июня 2023 года параметры filter запроса LIST больше не позволят использовать логические операторы OR между ограничениями разных полей.

Например, ресурсы, идентифицированные с помощью строки фильтра lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" должны быть извлечены с помощью двух запросов LIST со следующими строками фильтра:

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

Более подробную информацию об ограничениях логических операторов см. в нашем руководстве по фильтрации запросов LIST

Проверьте параметры запроса filter всех существующих вызовов LIST и убедитесь, что они правильно используют логический оператор OR до 21 июня 2023 года, чтобы избежать перебоев в обслуживании.

Возможность фильтровать или упорядочивать запросы списков по полям budget.budget_segments. date_range.end_date и flight.dateRange.endDate

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

21 июня 2023 г.

С 21 июня 2023 года поля budget.budget_segments. date_range.end_date и flight.dateRange.endDate больше не будут приниматься в параметрах запроса advertisers.insertionOrders.list и advertisers.lineItems.list filter и orderBy соответственно. После этой даты запросы, использующие эти поля в параметрах запроса filter и orderBy будут возвращать ошибку.

Удалите все фильтры и логику заказа с использованием этих двух полей до 21 июня 2023 года, чтобы избежать перебоев в обслуживании.

Возможность фильтрации запросов advertisers.lineItems.list по четырем дополнительным полям 21 июня 2023 г.

С 21 июня 2023 года advertisers.lineItems.list больше не будет поддерживать фильтрацию по следующим полям:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

Удалите всю логику фильтрации с использованием этих четырех полей до 21 июня 2023 года, чтобы избежать перебоев в обслуживании.

Покупка, основанная на результате 1 августа 2023 г.

1 августа 2023 г. заказы на размещение с использованием покупки на основе результата, определяемые значением поля billableOutcome BILLABLE_OUTCOME_PAY_PER_CLICK или BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION , а также их дочерние позиции будут архивированы.

Это изменение повлияет на следующие запросы:

Поле publisherReviewStatuses в креативных ресурсах 26 июня 2024 г.

Начиная с 26 июня 2024 года поле publisherReviewStatuses перестанет действовать и будет пустым при извлечении Creative ресурсов.

Контент-таргетинг для позиций YouTube и партнеров 30 сентября 2024 г.

30 сентября 2024 г. следующие значения для определенных типов таргетинга перестанут действовать для позиций YouTube и партнерских сайтов:

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

Чтобы избежать перебоев в обслуживании, удалите этот таргетинг из всех существующих позиций YouTube и партнеров до даты истечения срока действия.

Собственная и сторонняя аудитория Oracle 30 сентября 2024 г.

30 сентября 2024 года ресурсы FirstAndThirdPartyAudience от Oracle прекратят своё существование. После этого эти аудитории будут удалены из всех существующих целевых аудиторий ресурсов и комбинированных аудиторий. Если позиция нацелена только на аудитории, на которые уже распространяется действие, или имеет отрицательный таргетинг на какие-либо аудитории, на которые уже распространяется действие, это обновление автоматически приостановит действие этой позиции.

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

Оптимизированный таргетинг позиций для подмножества стратегий ставок 30 сентября 2024 г.

С 30 сентября 2024 года ресурсы LineItem , использующие подмножество стратегий ставок, перестанут быть совместимыми с оптимизированным таргетингом. В связи с этим изменением ресурсы LineItem , для которых targetingExpansion.enableOptimizedTargeting установлено в значение True , а bidStrategy.maximizeSpendAutoBid.performanceGoalType — в значение BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA , BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN , BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED или bidStrategy.performanceGoalAutoBid.performanceGoalType — в значение BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM , будут обновлены, чтобы targetingExpansion.enableOptimizedTargeting было установлено в значение False .

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

Pacing заказов на размещение в Flight ASAP 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 или структурированных файлов данных.
Оптимизированный таргетинг для позиций с использованием фиксированных ставок 6 марта 2025 г.

6 марта 2025 года:

  • Запросы на создание или обновление ресурсов LineItem для установки поля BiddingStrategy fixedBid и поля TargetingExpansionConfig enableOptimizedTargeting в значение true вернут ошибку 400 .
  • Записи в файлах структурированных данных позиций со значением «Фиксированная» в столбце «Тип стратегии ставок» и значением «Истинно» в столбце «Оптимизированный таргетинг» не будут создаваться или обновляться при загрузке файла.
  • Существующие позиции, использующие фиксированные ставки, будут обновлены для отключения оптимизированного таргетинга.

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

  • Обновите существующие ресурсы позиций, которые используют как фиксированные ставки, так и оптимизированный таргетинг.
  • Убедитесь, что ваша интеграция не устанавливает фиксированную стратегию ставок и оптимизированный таргетинг при создании или обновлении ресурсов позиций с помощью Display & Video 360 API или структурированных файлов данных.
Обновить размер страницы firstAndThirdPartyAudiences.list до размера по умолчанию 6 марта 2025 г.

6 марта 2025 года размер страницы по умолчанию для запросов firstAndThirdPartyAudiences.list будет обновлен со 100 до 5000.

Чтобы избежать перебоев в обслуживании, обновите интеграцию, задав параметр запроса pageSize ваших запросов firstAndThirdPartyAudiences.list в соответствии с предпочитаемым вами размером страницы.

Новая ошибка несоответствия партнера/рекламодателя sdfdownloadtasks.create 6 марта 2025 г.

6 марта 2025 года запросы sdfdownloadtasks.create , использующие фильтр родительской сущности для фильтрации по рекламодателям, которые не являются дочерними элементами заданного partnerId начнут возвращать ошибку 400 .

Ограничения позиций YouTube Reach в SDF 24 марта 2025 г.

С 24 марта 2025 года при создании и обновлении позиций в файлах структурированных данных потребуется использовать более обширные форматы объявлений. Это означает следующее:

  • SDF v6 и v7 больше не поддерживают создание новых записей файла позиций со значением Subtype «Reach».
  • Новые записи в файлах SDF -позиций со значением Subtype «Охват» должны использовать значение «Адаптивный» в столбце TrueView Video Ad Formats . Существующие записи со значением Subtype «Охват» не могут обновлять значение столбца TrueView Video Ad Formats .
  • Для новых записей в файлах позиций SDF со значением Subtype «Охват» требуется заполнение столбца TrueView Video Ad Inventory Control .
Несоответствие алгоритма индивидуальных ставок и действий Floodlight 1 апреля 2025 г.

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

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

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

Неограниченный срок членства для собственной аудитории 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 .

Видеокампании действий в структурированных файлах данных 22 апреля 2025 г.

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

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

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

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

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

  • Обновите интеграцию, включив значение «Видеопартнеры» во все записи позиций Demand Gen.
  • Обновите интеграцию для управления источниками инвентаря Demand Gen на уровне группы объявлений с помощью столбцов группы объявлений 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 и файлы структурированных данных будут внесены следующие изменения:

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

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

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

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

Это относится к столбцам Site Targeting - Include и Site Targeting - Exclude в файлах заказа на вставку и позиции позиции .
Укажите, будут ли позиции содержать политическую рекламу ЕС 8 сентября 2025 г.

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

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

Если вы не можете сделать заявление на уровне рекламодателя или заявили, что политическая реклама ЕС может показываться от имени вашего рекламодателя, обновите API Display & Video 360 и интеграцию 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 обновите позицию, предоставив декларацию.