REST Resource: exchanges.auctionPackages

Ressource: AuctionPackage

Umschließt ein einzelnes Auktionspaket. Werbetreibende in DV3 können alle Auktionspakete in DV3 über die Benutzeroberfläche zur Marktplatzsuche durchsuchen und diese Pakete ohne Maßnahmen des Verkäufers verwenden.

JSON-Darstellung 
{
  "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
}
Felder
name

string

ID. Relativer Routenname für dieses Auktionspaket. Muss das Format „exchanges/{seller_id}/auctionpackages/{auction_package_id}“ haben. Beispiel: „exchanges/1234/auctionPackage/5678“. Nur Ausgabe.
displayName

string

Erforderlich. Der Anzeigename dieses Auktionspakets. Muss UTF-8-codiert sein und darf maximal 240 Zeichen lang sein. Erforderlich.
status

enum (DiscoveryObjectStatus)

Erforderlich. Der Status dieses Auktionspakets. Pakete mit dem Status „PAUSED“ oder „REMOVED“ werden DV3-Werbetreibenden nicht angezeigt. Erforderlich.
description

string

Erforderlich. Der Beschreibungstext für dieses Paket. Muss UTF-8-codiert sein und darf maximal 2.000 Zeichen lang sein. Erforderlich.
format

enum (Format)

Erforderlich. Nicht veränderbar. Der zugrunde liegende Anzeigenformattyp. Erforderlich. Nach dem Erstellen sind keine Aktualisierungen zulässig.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Optional. Prognoseaufschlüsselung für das Inventar dieses Auktionspakets. DV3-Werbetreibende können diese Aufschlüsselungen sehen und danach filtern. Optional.
externalDealId

string

Erforderlich. Nicht veränderbar. Die Deal-ID der Anzeigenplattform, die in Gebotsanfragen verwendet wird. Max. 100 Zeichen. Zulässige Zeichen sind alphanumerische Zeichen, Unterstriche, Bindestriche und Punkte. Erforderlich. Erforderlich. Nach dem Erstellen sind keine Aktualisierungen zulässig.
logoUrl

string

Nur Ausgabe. Die URL für das Logo dieses Auktionspakets.

Nur Ausgabe.
floorPrice

object (Money)

Erforderlich. Der Mindestpreis dieses Auktionspakets. Erforderlich.
startTime

string (Timestamp format)

Erforderlich. Zeitpunkt, zu dem dieses Produkt aktiv wird. Muss vor „endTime“ liegen. Der Beginn darf nicht mehr als ein Jahr in der Zukunft liegen. Erforderlich.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
endTime

string (Timestamp format)

Erforderlich. Zeitpunkt, zu dem dieses Produkt inaktiv wird. Erforderlich.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
mediumType

enum (MediumType)

Erforderlich. Medientyp des Auktionspakets.
urgOwners[]

enum (UnderRepresentedGroup)

Optional. Unterrepräsentierte Gruppen, denen der Inhaber angehört (falls zutreffend).
dv3MarketplaceUri

string

Nur Ausgabe. Dv360-Link für das Auktionspaket auf dem Marktplatz.

Format

Anzeigenformat für das Auktionspaket.

Enums
DEAL_FORMAT_UNSPECIFIED Deal-Format nicht angegeben. Für die Eingabe nicht gültig.
DEAL_FORMAT_DISPLAY Anzeigeformat.
DEAL_FORMAT_VIDEO Video format.
DEAL_FORMAT_AUDIO Audio format.

Methoden

create

 Erstellt ein neues Auktionspaket.

get

 Ruft ein Auktionspaket ab.

list

 Listet Auktionspakete auf.

patch

 Aktualisiert ein Auktionspaket.
Lädt ein Logo für das angegebene Paket hoch.