API Display & Video 360 v2 больше не используется. Вместо этого используйте Display & Video 360 API v3 . Инструкции по переходу с версии 2 на версию 3 см. в нашем руководстве по миграции .

Эта страница переведена с помощью Cloud Translation API.

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

На этой странице указаны даты прекращения поддержки и прекращения поддержки версий 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` по умолчанию.
`publisherReviewStatuses` в креативных ресурсах	26 июня 2024 г.	Начиная с 26 июня 2024 г. `publisherReviewStatuses` станет неактивным и станет пустым при получении ресурсов `Creative` .
Таргетинг на контент для позиций на YouTube и партнерских сайтах	30 сентября 2024 г.	30 сентября 2024 г. следующие значения для определенных типов таргетинга перестанут действовать для позиций YouTube и партнерских партнеров: `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION` : `CONTENT_RATING_TIER_UNRATED` `CONTENT_RATING_TIER_GENERAL` `CONTENT_RATING_TIER_PARENTAL_GUIDANCE` `CONTENT_RATING_TIER_TEENS` `CONTENT_RATING_TIER_MATURE` `CONTENT_RATING_TIER_FAMILIES` `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION` : `SENSITIVE_CATEGORY_EMBEDDED_VIDEO` `SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO` Параметры таргетинга на закате будут автоматически удалены из таргетинга существующей позиции. Эти значения по-прежнему будут доступны для использования при таргетинге на уровне рекламодателя. Чтобы избежать перебоев в обслуживании, удалите этот таргетинг из всех существующих позиций YouTube и партнеров до даты прекращения действия.
Собственная и сторонняя аудитории Oracle	30 сентября 2024 г.	30 сентября 2024 г. будет прекращена поддержка источников ресурсов `FirstAndThirdPartyAudience` от Oracle. После прекращения действия эти аудитории будут удалены из всех существующих таргетированных ресурсов и объединенных аудиторий. Если позиция ориентирована только на завершившуюся аудиторию или имеет отрицательный таргетинг на любую завершившуюся аудиторию, это обновление автоматически приостановит эту позицию. Во избежание перебоев в обслуживании определите и удалите все аудитории Oracle из существующих таргетированных аудиторий позиции и комбинированных аудиторий до даты прекращения действия.
Оптимизированный таргетинг позиции для определенного набора стратегий назначения ставок.	30 сентября 2024 г.	30 сентября 2024 г. ресурсы `LineItem` использующие подмножество стратегий назначения ставок, больше не будут совместимы с оптимизированным таргетингом. Благодаря этому изменению ресурсы `LineItem` , у которых для `targetingExpansion.enableOptimizedTargeting` задано значение `True` , а `bidStrategy.maximizeSpendAutoBid.performanceGoalType` . PerformanceGoalType установлено значение `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` , `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN` или `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` TYPE_AV_VIEWED или `bidStrategy.performanceGoalAutoBid.performanceGoalType` . PerformanceGoalType, для которого установлено значение `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` , будут обновлены, чтобы установить для `targetingExpansion.enableOptimizedTargeting` значение `False` . Чтобы избежать перебоев в обслуживании, обновите и убедитесь, что в ваших позициях, использующих эти стратегии назначения ставок, не включен оптимизированный таргетинг.
Выполните как можно скорее `Pacing` заказов на размещение	5 ноября 2024 г.	5 ноября 2024 г. `PACING_TYPE_ASAP` больше не будет совместим с `PACING_PERIOD_FLIGHT` при настройке поля `pacing` заказа на размещение. `pacingType` для всех существующих заказов на размещение с этой конфигурацией будет обновлен до `PACING_TYPE_AHEAD` . Чтобы избежать перебоев в обслуживании, обновите `pacing` всех существующих заказов на размещение с помощью `PACING_TYPE_ASAP` и `PACING_PERIOD_FLIGHT` .