REST Resource: exchanges.auctionPackages

Ressource: AuctionPackage

Kapselt ein einzelnes Auktionspaket ein. Werbetreibende in DV3 können über die Benutzeroberfläche für die Marktplatzsuche alle Auktionspakete in DV3 durchsuchen und die Verwendung dieser Pakete aktivieren, ohne dass Verkäufer etwas unternehmen müssen.

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

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

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

status

enum (DiscoveryObjectStatus)

Der Status dieses Auktionspakets. Pakete mit dem Status „PAUSIERT“ oder „ENTFERNT“ werden DV3-Werbetreibenden nicht angezeigt. Erforderlich.

description

string

Der Beschreibungstext für dieses Paket. Muss UTF-8-codiert sein und eine maximale Größe von 2.000 Zeichen haben. Erforderlich.

format

enum (Format)

Der zugrunde liegende Anzeigenformattyp. Erforderlich. Nach dem Erstellen sind keine Aktualisierungen mehr möglich.

forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Aufschlüsselung der Prognose für das Inventar dieses Auktionspakets. DV3-Werbetreibende können diese Aufschlüsselungen sehen und nach ihnen filtern. Optional.

externalDealId

string

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. Aktualisierungen nach der Erstellung nicht zulassen.

logoUrl

string

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

Nur Ausgabe.

floorPrice

object (Money)

Der Mindestpreis dieses Auktionspakets. Erforderlich.

startTime

string (Timestamp format)

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

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Zeitpunkt, zu dem dieses Produkt inaktiv wird. Erforderlich.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

mediumType

enum (MediumType)

Erforderlich. Der Medientyp des Auktionspakets.

urgOwners[]

enum (UnderRepresentedGroup)

Optional. Unterrepräsentierte Gruppen, in denen der Inhaber Mitglied ist, falls zutreffend.

dv3MarketplaceUri

string

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

Format

Anzeigenformat für Auktionspaket.

Enums
DEAL_FORMAT_UNSPECIFIED Dealformat nicht angegeben. Nicht für die Eingabe zulässig.
DEAL_FORMAT_DISPLAY Anzeigeformat.
DEAL_FORMAT_VIDEO Videoformat
DEAL_FORMAT_AUDIO Audioformat

Methoden

create

Erstellt ein neues Auktionspaket.

get

Ruft ein Auktionspaket ab.

list

Hier werden Auktionspakete aufgeführt.

patch

Aktualisiert ein Auktionspaket.
Laden Sie das Logo für das angegebene Paket hoch.