REST Resource: exchanges.auctionPackages

Recurso: AuctionPackage

Encapsula un solo paquete de subasta. Los anunciantes de DV3 pueden explorar todos los paquetes de subastas en DV3 a través de la IU de descubrimiento del mercado y habilitar el uso de estos paquetes sin necesidad de que el vendedor realice ninguna acción.

Representación 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
}
Campos
name

string

Es el nombre de ruta relativo de este paquete de subasta. Debe tener el siguiente formato: "exchanges/{seller_id}/auctionpackages/{auction_package_id}. Ejemplo: "exchanges/1234/auctionPackage/5678". Solo salida.

displayName

string

Es el nombre visible de este paquete de subasta. Debe estar codificado en UTF-8 con un tamaño máximo de 240 caracteres. Obligatorio.

status

enum (DiscoveryObjectStatus)

Es el estado de este paquete de subasta. Los paquetes con el estado PAUSED o REMOVED no se muestran a los anunciantes de DV3. Obligatorio.

description

string

Es el texto de la descripción de este paquete. Debe estar codificado en UTF-8 con un tamaño máximo de 2,000 caracteres. Obligatorio.

format

enum (Format)

Es el tipo de formato de anuncio subyacente. Obligatorio. No se permiten actualizaciones después de la creación.

forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Desglose de las previsiones para el inventario de este paquete de subasta. Los anunciantes de DV3 pueden ver y filtrar estos desgloses. Opcional.

externalDealId

string

El ID del acuerdo de intercambio que se usa en las solicitudes de oferta. Máx. de 100 caracteres. Los caracteres permitidos son alfanuméricos, guiones bajos, guiones y puntos. Obligatorio. Obligatorio. No permitir actualizaciones después de la creación

logoUrl

string

Solo salida. Es la URL del logotipo de este paquete de subasta.

Solo salida.

floorPrice

object (Money)

Es el precio mínimo de este paquete de subasta. Obligatorio.

startTime

string (Timestamp format)

Es la hora en la que este producto se activa. Debe ser anterior a endTime. La hora de inicio no puede ser superior a 1 año en el futuro. Obligatorio.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Es la hora en la que este producto se vuelve inactivo. Obligatorio.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

mediumType

enum (MediumType)

Obligatorio. Es el tipo de medio del paquete de subasta.

urgOwners[]

enum (UnderRepresentedGroup)

Opcional. Grupos subrepresentados de los que el propietario es miembro, si corresponde

dv3MarketplaceUri

string

Solo salida. Vínculo de DV360 para el paquete de subasta en el mercado

Formato

Es el formato del anuncio para el paquete de subasta.

Enumeraciones
DEAL_FORMAT_UNSPECIFIED No se especificó el formato del acuerdo. No es válido para la entrada.
DEAL_FORMAT_DISPLAY Formato de visualización.
DEAL_FORMAT_VIDEO Formato de video
DEAL_FORMAT_AUDIO Formato de audio

Métodos

create

Crea un nuevo paquete de subasta.

get

Obtiene un paquete de subasta.

list

Muestra una lista de los paquetes de subasta.

patch

Actualiza un paquete de subasta.
Sube el logotipo del paquete especificado.