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

На этой странице указаны даты прекращения поддержки и прекращения поддержки версий 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 г. существующие ограничения на использование будут заменены гибридной структурой квот, которая обеспечивает следующее:

  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 Поля 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 и партнерских партнеров:

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

Чтобы избежать перебоев в обслуживании, удалите этот таргетинг из всех существующих позиций 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 .