В этом руководстве описаны распространенные рабочие процессы API для создания, получения и обновления аукционных пакетов в Display & Video 360.
Получите список аукционных пакетов
Вызовите API LIST . Поддерживается фильтрация по external_deal_id .
Создать новый аукционный пакет
-
external_deal_idдолжен быть уникальным. Вызовите функцию LIST сexternal_deal_id, чтобы проверить, использовался ли этот идентификатор уже. - Воспользуйтесь API Create . Вам будет присвоено уникальное имя, которое можно использовать для получения созданного пакета.
- Воспользуйтесь функцией Get API , чтобы просмотреть подробную информацию о созданном аукционном пакете.
- При желании можно загрузить логотип для созданного пакета.
Обновить аукционный пакет
- Если вы не сохранили название созданного аукционного пакета, вызовите API LIST с фильтром по
external_deal_id, чтобы получить аукционный пакет, который вы хотите обновить. - Обновите поля на основе результатов, полученных с помощью API LIST.
- Для обновления пакета аукциона вызовите API патчей . Параметр
updateMaskобязателен. Он указывает, к каким полям должно быть применено обновление. В параметреupdateMaskможно указать только те поля, которые разрешено обновлять.
Бета-процесс
Единственное различие между бета-версией и общедоступной версией заключается в том, что во время бета-тестирования созданные аукционные пакеты должны иметь статус DISCOVERY_OBJECT_STATUS_PAUSED , и этот статус нельзя изменить. Пакеты со статусом PAUSED не отображаются в пользовательском интерфейсе DV360. Это позволяет биржам тестировать интеграцию API без отображения тестовых пакетов.
Обычно все "реальные" пакеты в бета-версии создаются как ПРИОСТАНОВЛЕННЫЕ, а затем активируются после выхода в общий доступ.
Квота
2000 активных пакетов на одну биржу.
2000 приостановленных посылок на каждый обмен.