Ресурс: AuctionPackage
Инкапсулирует один пакет аукциона. Рекламодатели в DV3 могут просматривать все пакеты аукционов в DV3 через пользовательский интерфейс обнаружения рынка и выбирать использование этих пакетов без действий продавца.
JSON-представление |
---|
{ "name": string, "displayName": string, "status": enum ( |
Поля | |
---|---|
name | Относительное имя маршрута для этого аукционного пакета. Должно быть в форме: "exchanges/{seller_id}/auctionpackages/{auction_package_id} Пример: "exchanges/1234/auctionPackage/5678". Только вывод. |
displayName | Отображаемое имя этого аукционного пакета. Должно быть в кодировке UTF-8 с максимальным размером 240 символов. Обязательно. |
status | Статус этого аукционного пакета. Пакеты со статусом PAUSED или REMOVED не показываются рекламодателям DV3. Обязательно. |
description | Текст описания для этого пакета. Должен быть в кодировке UTF-8 с максимальным размером 2000 символов. Обязательно. |
format | Базовый тип формата объявления. Обязательно. Обновления не допускаются после создания. |
forecast | Прогнозирование разбивки для инвентаря этого аукционного пакета. Рекламодатели DV3 могут видеть и фильтровать эти разбивки. Необязательно. |
externalDealId | Идентификатор сделки обмена, используемый в запросах ставок. Макс. 100 символов. Разрешенные символы: буквы, цифры, подчеркивание, тире и точка. Обязательно. Обязательно. Не разрешать обновления после создания. |
logoUrl | Только вывод. URL-адрес логотипа этого аукционного пакета. Только вывод. |
floorPrice | Минимальная цена этого аукционного пакета. Обязательно. |
startTime | Время, когда этот продукт станет активным. Должно быть раньше endTime. Время начала не может быть позже, чем 1 год. Обязательно. Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: |
endTime | Время, когда этот продукт станет неактивным. Обязательно. Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: |
mediumType | Обязательно. Средний тип аукционного пакета. |
urgOwners[] | Необязательно. Ниже представлены группы, членом которых является владелец, если таковые имеются. |
dv3MarketplaceUri | Только вывод. Ссылка Dv360 для пакета аукциона на торговой площадке. |
Формат
Формат объявления для аукционного пакета.
Перечисления | |
---|---|
DEAL_FORMAT_UNSPECIFIED | Формат сделки не указан. Недопустимо для ввода. |
DEAL_FORMAT_DISPLAY | Формат отображения. |
DEAL_FORMAT_VIDEO | Формат видео. |
DEAL_FORMAT_AUDIO | Аудиоформат. |
Методы | |
---|---|
| Создает новый пакет аукциона. |
| Получает аукционный пакет. |
| Перечисляет пакеты аукционов. |
| Обновляет пакет аукциона. |
| Загрузить логотип для указанного пакета. |