REST Resource: exchanges.auctionPackages

Ресурс: AuctionPackage

Инкапсулирует один пакет аукциона. Рекламодатели в DV3 могут просматривать все пакеты аукционов в DV3 через пользовательский интерфейс обнаружения рынка и выбирать использование этих пакетов без действий продавца.

JSON-представление
{
  "name": string,
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "description": string,
  "format": enum (Format),
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "externalDealId": string,
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "startTime": string,
  "endTime": string,
  "mediumType": enum (MediumType),
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ],
  "dv3MarketplaceUri": string
}
Поля
name

string

Относительное имя маршрута для этого аукционного пакета. Должно быть в форме: "exchanges/{seller_id}/auctionpackages/{auction_package_id} Пример: "exchanges/1234/auctionPackage/5678". Только вывод.

displayName

string

Отображаемое имя этого аукционного пакета. Должно быть в кодировке UTF-8 с максимальным размером 240 символов. Обязательно.

status

enum ( DiscoveryObjectStatus )

Статус этого аукционного пакета. Пакеты со статусом PAUSED или REMOVED не показываются рекламодателям DV3. Обязательно.

description

string

Текст описания для этого пакета. Должен быть в кодировке UTF-8 с максимальным размером 2000 символов. Обязательно.

format

enum ( Format )

Базовый тип формата объявления. Обязательно. Обновления не допускаются после создания.

forecast

object ( SellerProvidedInventoryAvailabilityEstimate )

Прогнозирование разбивки для инвентаря этого аукционного пакета. Рекламодатели DV3 могут видеть и фильтровать эти разбивки. Необязательно.

externalDealId

string

Идентификатор сделки обмена, используемый в запросах ставок. Макс. 100 символов. Разрешенные символы: буквы, цифры, подчеркивание, тире и точка. Обязательно. Обязательно. Не разрешать обновления после создания.

logoUrl

string

Только вывод. URL-адрес логотипа этого аукционного пакета.

Только вывод.

floorPrice

object ( Money )

Минимальная цена этого аукционного пакета. Обязательно.

startTime

string ( Timestamp format)

Время, когда этот продукт станет активным. Должно быть раньше endTime. Время начала не может быть позже, чем 1 год. Обязательно.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

endTime

string ( Timestamp format)

Время, когда этот продукт станет неактивным. Обязательно.

Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

mediumType

enum ( MediumType )

Обязательно. Средний тип аукционного пакета.

urgOwners[]

enum ( UnderRepresentedGroup )

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

dv3MarketplaceUri

string

Только вывод. Ссылка Dv360 для пакета аукциона на торговой площадке.

Формат

Формат объявления для аукционного пакета.

Перечисления
DEAL_FORMAT_UNSPECIFIED Формат сделки не указан. Недопустимо для ввода.
DEAL_FORMAT_DISPLAY Формат отображения.
DEAL_FORMAT_VIDEO Формат видео.
DEAL_FORMAT_AUDIO Аудиоформат.

Методы

create

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

get

Получает аукционный пакет.

list

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

patch

Обновляет пакет аукциона.
Загрузить логотип для указанного пакета.