Миграция с версии 2 на версию 3

Последнее обновление: 31.10.2023

Перенесите свое приложение

Для перехода с версии 2 на версию 3 необходимо обновить URL-адреса конечных точек для вызова версии 3, а также обновить приложение с учетом критических изменений.

Обновите вызовы API с версии 2 до версии 3

Чтобы использовать v3 вместо v2, вам необходимо обновить свои запросы для использования новых конечных точек v3.

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

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

Для версии 3 обновите URL-адрес на следующий:

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

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

Внесите необходимые изменения

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

  • Ресурсы YoutubeAdGroup и YoutubeAdGroupAd были заменены ресурсами AdGroup и AdGroupAd . Эти новые ресурсы предоставляют практически идентичную информацию ресурсам версии 2, но могут использовать обновлённые имена полей или типы перечислений. В процессе интеграции замените используемые ресурсы YoutubeAdGroup или YoutubeAdGroupAd на ресурсы AdGroup и AdGroupAd и обновите вызовы следующих сервисов версии 2 до соответствующих сервисов версии 3:
  • Ссылки на объекты YoutubeAndPartnersBiddingStrategy перенесены в новое поле youtubeAndPartnersBid в общем объекте BiddingStrategy . Поле biddingStrategy удалено из объекта YoutubeAndPartnersSettings . Обновите интеграцию, чтобы получить стратегию назначения ставок для позиций или групп объявлений YouTube из объекта BiddingStrategy в поле bidStrategy ресурса LineItem или AdGroup .
  • Поле thirdPartyMeasurementSettings в объекте YoutubeAndPartnersSettings переименовано в thirdPartyMeasurementConfigs , а объект YoutubeAndPartnersThirdPartyMeasurementSettings переименован в ThirdPartyMeasurementConfigs . Обновите интеграцию, чтобы получать информацию о конфигурации сторонних измерений с помощью нового поля и объекта.

Включите необходимые конфигурации биллинга при создании рекламодателей

Поле billingConfig теперь является обязательным для использования в ресурсе Advertiser . Обновите запросы advertisers.create , чтобы убедиться, что это поле задано. Платежную информацию по умолчанию для родительского партнера можно получить через новое поле billingConfig ресурса Partner .

Используйте новое поле для управления оптимизированным таргетингом

Новое логическое поле enableOptimizedTargeting заменило поле targetingExpansionLevel в объекте TargetingExpansionConfig .

Обновите интеграцию заказа на размещение, чтобы использовать новое поле KPI.

Новое поле kpi заменило поле performanceGoal в ресурсе InsertionOrder . Это новое поле использует объект Kpi вместо объекта PerformanceGoal , а также новые поля и перечисления.

Удалить ссылки на устаревшие службы и поля.

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

Дополнительные изменения

Помимо основных изменений, перечисленных выше, версия 3 также представляет новые функции.

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

Управление списком местоположений поблизости

В версии 3 вы можете полностью управлять списками местоположений с ближайшими пунктами назначения , используя сервис advertisers.locationLists.assignedLocations для создания и удаления местоположений, назначенных ресурсам LocationList TARGETING_LOCATION_TYPE_PROXIMITY . Местоположение определяется по идентификатору ресурса TargetingOption типа TARGETING_TYPE_POI . Его можно получить с помощью targetingTypes.targetingOptions.search .

Возможность создания пользовательских алгоритмов назначения ставок на основе правил

В версии 3 вы можете создавать и извлекать пользовательские алгоритмы назначения ставок на основе правил с помощью служб customBiddingAlgorithms , media , customBiddingAlgorithms.rules .

Эта функция находится в стадии бета-тестирования и доступна только партнёрам из списка разрешённых. Если ваш партнёр не из списка разрешённых, ваш запрос вернёт ошибку.