Рабочие процессы API

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

Получите список аукционных пакетов

Вызовите API LIST . Поддерживается фильтрация по external_deal_id .

Создать новый аукционный пакет

  1. external_deal_id должен быть уникальным. Вызовите функцию LIST с external_deal_id , чтобы проверить, использовался ли этот идентификатор уже.
  2. Воспользуйтесь API Create . Вам будет присвоено уникальное имя, которое можно использовать для получения созданного пакета.
  3. Воспользуйтесь функцией Get API , чтобы просмотреть подробную информацию о созданном аукционном пакете.
  4. При желании можно загрузить логотип для созданного пакета.

Обновить аукционный пакет

  1. Если вы не сохранили название созданного аукционного пакета, вызовите API LIST с фильтром по external_deal_id , чтобы получить аукционный пакет, который вы хотите обновить.
  2. Обновите поля на основе результатов, полученных с помощью API LIST.
  3. Для обновления пакета аукциона вызовите API патчей . Параметр updateMask обязателен. Он указывает, к каким полям должно быть применено обновление. В параметре updateMask можно указать только те поля, которые разрешено обновлять.

Бета-процесс

Единственное различие между бета-версией и общедоступной версией заключается в том, что во время бета-тестирования созданные аукционные пакеты должны иметь статус DISCOVERY_OBJECT_STATUS_PAUSED , и этот статус нельзя изменить. Пакеты со статусом PAUSED не отображаются в пользовательском интерфейсе DV360. Это позволяет биржам тестировать интеграцию API без отображения тестовых пакетов.

Обычно все "реальные" пакеты в бета-версии создаются как ПРИОСТАНОВЛЕННЫЕ, а затем активируются после выхода в общий доступ.

Квота

2000 активных пакетов на одну биржу.

2000 приостановленных посылок на каждый обмен.