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 rilevamento del marketplace e scegliere di utilizzare questi pacchetti senza l'intervento 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

Identificatore. Nome della route relativa 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

Obbligatorio. 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)

Obbligatorio. Lo stato di questo pacchetto di aste. I pacchetti con stato PAUSED o REMOVED non vengono mostrati agli inserzionisti DV3. Obbligatorio.
description

string

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

enum (Format)

Obbligatorio. Immutabile. Il tipo di formato dell'annuncio sottostante. Obbligatorio. Gli aggiornamenti non sono consentiti dopo la creazione.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Facoltativo. Suddivisione delle previsioni per l'inventario di questo pacchetto di aste. Gli inserzionisti DV3 possono visualizzare e filtrare queste suddivisioni. Facoltativo.
externalDealId

string

Obbligatorio. Immutabile. L'ID deal della piattaforma di scambio utilizzato nelle richieste di offerta. Massimo 100 caratteri. I caratteri consentiti sono alfanumerici, trattino basso, trattino e punto. Obbligatorio. Obbligatorio. Non consentire gli aggiornamenti dopo la creazione.
logoUrl

string

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

Solo output.
floorPrice

object (Money)

Obbligatorio. Il prezzo minimo di questo pacchetto di aste. Obbligatorio.
startTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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)

Obbligatorio. Ora in cui questo prodotto diventa inattivo. Obbligatorio.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 supporto del pacchetto di aste.
urgOwners[]

enum (UnderRepresentedGroup)

Facoltativo. Gruppi sottorappresentati di cui il proprietario è membro, se presenti.
dv3MarketplaceUri

string

Solo output. Link di Dv360 per il pacchetto di aste nel marketplace.

Formato

Formato dell'annuncio per il pacchetto di aste.

Enum
DEAL_FORMAT_UNSPECIFIED Formato del deal non specificato. Non valido per l'input.
DEAL_FORMAT_DISPLAY Formato display.
DEAL_FORMAT_VIDEO Formato video.
DEAL_FORMAT_AUDIO Formato audio.

Metodi

create

 Crea un nuovo pacchetto di aste.

get

 Ottiene un pacchetto di aste.

list

 Elenca i pacchetti di aste.

patch

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