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 )

Обязательно. Статус данного аукционного пакета. Пакеты со статусом «ПАУЗА» или «УДАЛЕНО» не отображаются рекламодателям 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)

Обязательно. Время, когда данный аукционный пакет станет активным. Должно быть раньше времени окончания аукциона. Время начала аукциона не может быть более чем на 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

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

Источник: 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 )

Обязательно. Статус данного аукционного пакета. Пакеты со статусом «ПАУЗА» или «УДАЛЕНО» не отображаются рекламодателям 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)

Обязательно. Время, когда данный аукционный пакет станет активным. Должно быть раньше времени окончания аукциона. Время начала аукциона не может быть более чем на 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

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

Источник: 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 )

Обязательно. Статус данного аукционного пакета. Пакеты со статусом «ПАУЗА» или «УДАЛЕНО» не отображаются рекламодателям 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)

Обязательно. Время, когда данный аукционный пакет станет активным. Должно быть раньше времени окончания аукциона. Время начала аукциона не может быть более чем на 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

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