Как перейти с Display & Video 360 API версии 4 на версию 5

Последнее обновление: 22 октября 2026 г.

Перенос приложения

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

Обновите вызовы API с версии 4 до версии 5

Чтобы использовать версию 5 вместо версии 4, необходимо обновить запросы, указав новые конечные точки версии 5.

Например, чтобы вызвать метод advertisers.get с помощью v4, используйте следующий URL:

GET https://displayvideo.googleapis.com/v4/advertisers/advertiserId

Для версии 5 укажите следующий URL:

GET https://displayvideo.googleapis.com/v5/advertisers/advertiserId

Если вы используете клиентскую библиотеку для отправки запросов к API, используйте ее последнюю версию и обновите конфигурацию, чтобы использовать версию 5.

Внесение изменений

В Display & Video 360 API версии 5 есть ряд критических изменений. Ознакомьтесь с приведенными ниже инструкциями и внесите необходимые изменения в соответствии с тем, как вы используете Display & Video 360 API.

Полный список различий между версиями 4 и 5 Display & Video 360 API приведен в примечаниях к выпуску.

Обновите извлечение источников инвентаря и таргетинг на них, чтобы использовать новые идентификаторы и типы

В Display & Video 360 API v5 изменен способ получения и таргетинга сделок с источниками инвентаря и пакетов для аукционов.

В версии 4 ресурсы InventorySource, полученные с помощью сервиса inventorySources, представляют как сделки с источниками инвентаря, так и пакеты для аукционов. Таргетинг на сделки и пакеты для аукционов настраивается с помощью TARGETING_TYPE_INVENTORY_SOURCE.

В версии 5 сделки с источниками инвентаря и пакеты для аукционов обрабатываются отдельно:

  • Таргетинг на сделки с источниками инвентаря настраивается с помощью TARGETING_TYPE_INVENTORY_SOURCE_DEAL, извлекается с помощью сервисов advertisers.inventorySources и partners.inventorySources и настраивается с помощью поля AssignedTargetingOption inventorySourceDetails.
  • Таргетинг на пакеты для аукционов настраивается с помощью TARGETING_TYPE_AUCTION_PACKAGE, извлекается с помощью сервиса targetingTypes.targetingOptions и настраивается с помощью поля AssignedTargetingOption auctionPackageDetails.

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

Кроме того, в версии 5 удалена возможность создавать, обновлять и изменять методы доступа к источникам инвентаря.

Обновление логики выбора целевой аудитории для кампаний для создания спроса и материалов YouTube

В Дисплей и Видео 360 API версии 5 обновлена логика выбора целевой аудитории для ресурсов YouTube и кампаний для создания спроса. Теперь для каждого списка аудитории, на который настроен таргетинг, используются отдельные назначенные варианты.

В версии 4 для управления таргетингом на аудитории используется TARGETING_TYPE_AUDIENCE_GROUP.

В версии 5 выбор целевой аудитории, назначенный группам объявлений в кампаниях для создания спроса и рекламы на YouTube, управляется с помощью одного из следующих типов таргетинга и полей ресурса AssignedTargetingOption в зависимости от типа аудитории:

В позициях по-прежнему будет использоваться один TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption для управления таргетингом на аудиторию всех типов.

Перейдите на Data Manager API для управления аудиториями на основе списков электронных адресов

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

  • firstPartyAndPartnerAudiences.create
  • firstPartyAndPartnerAudiences.editCustomerMatchMembers
  • firstPartyAndPartnerAudiences.patch

Чтобы продолжить управлять аудиториями на основе списков электронных адресов, перейдите на Data Manager API.

Добавлена поддержка получения заказов на размещение цифровой наружной рекламы

В Display & Video 360 API версии 5 добавлена поддержка получения заказов на размещение цифровой наружной рекламы.

Если ваши рекламодатели используют цифровую наружную рекламу, обновите все интеграции, вызывающие advertisers.insertionOrders.list, чтобы включить ресурсы InsertionOrder со значением поля insertionOrderType, равным OUT_OF_HOME.

В версии 5 позиции в заказах на размещение цифровой наружной рекламы будут извлекаться так же, как и в версии 4.

Замена упоминаний Adloox на Peer39

В версии 5 поля и значения перечисления, относящиеся к интеграции Дисплея и Видео 360 со сторонним решением Adloox (также известным как Scope3) для обеспечения соответствия требованиям бренда, были заменены на Peer39:

Как обновить поля позиций, групп объявлений и объявлений YouTube

В версии 5 удалены или обновлены различные поля в ресурсах LineItem, AdGroup и AdGroupAd. Обновите логику получения ресурсов с учетом этих изменений.

В ресурсе LineItem:

В ресурсах LineItem и AdGroup:

  • Поля audienceExpansionSeedListExcluded и audienceExpansionLevel в TargetingExpansionConfig были удалены.

В ресурсе AdGroupAd:

  • Добавлено поле containsSyntheticMedia.
  • Поле trackingUrl в объектах AudioAd, CommonInStreamAttribute и VideoPerformanceAd разделено на два поля: trackingUrl и userSpecifiedTrackingUrl. Это позволяет различать URL, используемый для отслеживания, и URL отслеживания, указанный пользователем.

Удалите ссылки на устаревшие значения enum

В версии 5 полностью удалены значения перечисления, которые ранее были объявлены устаревшими. Использование этих значений в запросах к API приводило к ошибке в версии 4, а в версии 5 все ссылки на них удалены из клиентских библиотек. Если в вашем коде есть ссылки на эти устаревшие значения, при обновлении до версии 5 могут возникнуть ошибки.

К типам Enum, у которых есть затронутые значения, относятся ContentRatingTier, GoogleAudienceType, SdfVersion и SensitiveCategory. Полный список удаленных значений перечисления можно найти в примечаниях к выпуску.

Посмотрите новые функции

Помимо критических изменений, в версии 5 также представлены следующие новые функции:

  • Полное управление отрицательным таргетингом для видео и каналов YouTube на уровне рекламодателя с использованием типов таргетинга TARGETING_TYPE_YOUTUBE_VIDEO и TARGETING_TYPE_YOUTUBE_CHANNEL. В версии 4 этот таргетинг был доступен только для чтения.
  • Возможность создавать ресурсы цифровой наружной рекламы InsertionOrder.
  • Добавлена поддержка групп объявлений, в которых для создания объявлений используются назначенные креативы. Для этого в ресурс AdGroup добавлены поля adSource и creativeAssignments, а в ресурс AdGroupAd – поле parentCreativeId.
  • Возможность создавать и получать ресурсы LookalikeAudience.
  • Новое поле containsSyntheticMedia в ресурсе AdGroupAd.