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

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

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

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

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

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

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

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

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

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

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

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

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

Обновление вызовов относительно ресурсов аудитории как собственных, так и сторонних, а также соответствующего таргетинга

Ресурсы FirstAndThirdPartyAudience были заменены ресурсами FirstPartyAndPartnerAudience .

Это изменение потребует от вас обновления следующего:

  • Ссылки на ресурсы FirstAndThirdPartyAudience для использования нового ресурса FirstPartyAndPartnerAudience .
  • Существующие запросы к методам в службе v3 firstAndThirdPartyAudiences к новой службе v4 firstPartyAndPartnerAudiences .
  • Ожидаемый размер страницы по умолчанию для запросов firstPartyAndPartnerAudiences.list составляет от 100 до 5000 элементов.
  • Ссылки на поле firstAndThirdPartyAudienceType версии 3 на новое поле firstPartyAndPartnerAudienceType версии 4 с использованием нового типа перечисления FirstPartyAndPartnerAudienceType , при этом старые значения соответствуют следующим новым значениям:
    • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY на TYPE_FIRST_PARTY
    • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY к TYPE_PARTNER

  • Ссылки на значение перечисления AudienceType LICENSED вместо использования одного из следующих новых, более конкретных значений:

    • THIRD_PARTY
    • COMMERCE
    • LINEAR

  • Ссылки на ресурсы AssignedTargetingOption типа TargetingType TARGETING_TYPE_AUDIENCE_GROUP для замены полей v3 в AudienceGroupAssignedTargetingOptionDetails следующими новыми полями v4:

Обновить существующие запросы на массовый таргетинг списков групп объявлений

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions был переименован в advertisers.adGroups.bulkListAssignedTargetingOptions . Обновите существующие запросы, чтобы использовать новое название метода.

Включите цель оптимизации при создании заказов на размещение

Поле optimizationObjective теперь является обязательным в ресурсе InsertionOrder . Обновите запросы advertisers.insertionOrders.create , чтобы убедиться, что это поле задано.

Удалить ссылки на поле креативного ресурса publisherReviewStatuses

Поле publisherReviewStatuses было удалено из объекта ReviewStatusInfo в ресурсе Creative после того, как оно было объявлено устаревшим в июне 2024 года .