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 ( |
Campos | |
---|---|
name |
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 |
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 |
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 |
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 |
Es el tipo de formato de anuncio subyacente. Obligatorio. No se permiten actualizaciones después de la creación. |
forecast |
Desglose de las previsiones para el inventario de este paquete de subasta. Los anunciantes de DV3 pueden ver y filtrar estos desgloses. Opcional. |
externalDealId |
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 |
Solo salida. Es la URL del logotipo de este paquete de subasta. Solo salida. |
floorPrice |
Es el precio mínimo de este paquete de subasta. Obligatorio. |
startTime |
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: |
endTime |
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: |
mediumType |
Obligatorio. Es el tipo de medio del paquete de subasta. |
urgOwners[] |
Opcional. Grupos subrepresentados de los que el propietario es miembro, si corresponde |
dv3MarketplaceUri |
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 |
|
---|---|
|
Crea un nuevo paquete de subasta. |
|
Obtiene un paquete de subasta. |
|
Muestra una lista de los paquetes de subasta. |
|
Actualiza un paquete de subasta. |
|
Sube el logotipo del paquete especificado. |