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

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

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

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

Обновите вызовы API с версии 2 на версию 3.

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

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

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

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

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

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

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

Мы вносим ряд серьезных изменений в v3. Прочтите следующие инструкции и внесите необходимые изменения, соответствующие вашему текущему использованию 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 было переименовано в thirdPartyMeasurementConfigs в объекте YoutubeAndPartnersSettings , а объект YoutubeAndPartnersThirdPartyMeasurementSettings был переименован в ThirdPartyMeasurementConfigs . Обновите свою интеграцию, чтобы получать информацию о конфигурации сторонних измерений, используя новое поле и объект.

Включите необходимые настройки выставления счетов при создании рекламодателей.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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