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

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

О прекращении поддержки и датах прекращения поддержки API также будет объявлено в блоге разработчиков Google Ads .

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

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

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

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

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

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

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

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

Особенность	Первоначальная дата вступления в силу	Описание
Расширение таргетинга	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 г. существующие ограничения на использование будут заменены гибридной структурой квот, которая обеспечивает следующее: Устраняет количество запросов в день по квоте проекта . Устанавливает количество запросов в минуту на каждого рекламодателя на квоту проекта для соответствующих методов. Эти новые ограничения обеспечат большую гибкость в использовании 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 Поля budget.budget_segments. date_range.end_date и flight.dateRange.endDate Первоначальная дата вступления в силу обновлена.	21 июня 2023 г.	21 июня 2023 г. budget.budget_segments. date_range.end_date и flight.dateRange.endDate больше не будут приниматься в качестве полей в filter advertisers.insertionOrders.list и advertisers.lineItems.list и параметрах запроса 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 , а также их дочерние позиции будут заархивированы. Это изменение повлияет на следующие запросы: Попытка использовать advertisers.insertionOrders.create для создания заказа на размещение с использованием покупок на основе результатов вернет ошибку 400 . Попытка использовать advertisers.lineItems.create , advertisers.lineItems.duplicate или advertisers.lineItems.generateDefault для создания позиции в заказе на размещение с использованием покупки на основе результатов приведет к ошибке 400 . Поскольку заархивированные ресурсы по умолчанию не включаются в запросы LIST , затронутые ресурсы больше не будут возвращаться методами advertisers.insertionOrders.list и advertisers.lineItems.list по умолчанию.