REST Resource: exchanges.auctionPackages

Risorsa: AuctionPackage

Incapsula un singolo pacchetto di aste. Gli inserzionisti in DV3 possono sfogliare tutti i pacchetti di aste in DV3 tramite l'interfaccia utente di discovery del marketplace e attivare l'utilizzo di questi pacchetti senza alcuna azione da parte del venditore.

Rappresentazione 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
}
Campi
name

string

Nome del percorso relativo per questo pacchetto di aste. Deve essere nel formato: "exchanges/{seller_id}/auctionpackages/{auction_package_id} Esempio: "exchanges/1234/auctionPackage/5678". Solo output.

displayName

string

Il nome visualizzato di questo pacchetto di aste. Deve essere codificato in UTF-8 con una dimensione massima di 240 caratteri. Obbligatorio.

status

enum (DiscoveryObjectStatus)

Lo stato di questo pacchetto di aste. I pacchetti con stato PAUSATO o RIMOSSO non vengono mostrati agli inserzionisti DV3. Obbligatorio.

description

string

Il testo descrittivo di questo pacchetto. Deve essere codificato in UTF-8 con una dimensione massima di 2000 caratteri. Obbligatorio.

format

enum (Format)

Il tipo di formato dell'annuncio sottostante. Obbligatorio. Aggiornamenti non consentiti dopo la creazione.

forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Analisi dettagliata delle previsioni per l'inventario di questo pacchetto di aste. Gli inserzionisti DV3 possono visualizzare e filtrare i dati in base a queste suddivisioni. Facoltativo.

externalDealId

string

L'ID deal della piattaforma di scambio utilizzato nelle richieste di offerta. Massimo 100 caratteri. I caratteri consentiti sono alfanumerici, trattini bassi, trattini e punti. Obbligatorio. Obbligatorio. Non consentire aggiornamenti dopo la creazione.

logoUrl

string

Solo output. L'URL del logo di questo pacchetto di aste.

Solo output.

floorPrice

object (Money)

Il prezzo minimo di questo pacchetto di aste. Obbligatorio.

startTime

string (Timestamp format)

Data e ora in cui il prodotto diventa attivo. Deve essere precedente a endTime. L'ora di inizio non può essere più lontana di 1 anno nel futuro. Obbligatorio.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Data e ora in cui questo prodotto diventa inattivo. Obbligatorio.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

mediumType

enum (MediumType)

Obbligatorio. Tipo di media del pacchetto di aste.

urgOwners[]

enum (UnderRepresentedGroup)

Facoltativo. Gruppi sottorappresentati di cui il proprietario fa parte, se presenti.

dv3MarketplaceUri

string

Solo output. Link a DV360 per il pacchetto di aste nel marketplace.

Formato

Formato dell'annuncio per il pacchetto dell'asta.

Enum
DEAL_FORMAT_UNSPECIFIED Formato del deal non specificato. Non valido per l'inserimento.
DEAL_FORMAT_DISPLAY Formato di visualizzazione.
DEAL_FORMAT_VIDEO Formato video.
DEAL_FORMAT_AUDIO Formato audio.

Metodi

create

Crea un nuovo pacchetto di aste.

get

Recupera un pacchetto di aste.

list

Elenca i pacchetti di aste.

patch

Aggiorna un pacchetto di aste.
Carica il logo per il pacchetto specificato.