REST Resource: exchanges.publishers

Ressource: Publisher

Kapselt einen einzelnen Publisher ein.

JSON-Darstellung 
{
  "name": string,
  "externalPublisherId": string,
  "externalPublisherIds": [
    string
  ],
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "mediumCapability": enum (MediumCapability),
  "description": string,
  "contactInfo": [
    string
  ],
  "commitmentCapability": [
    enum (CommitmentCapability)
  ],
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "ceilingPrice": {
    object (Money)
  },
  "generalCapability": string,
  "tvMetadata": {
    object (TVMetadata)
  },
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ]
}
Felder
name

string

Nur Ausgabe. Relativer Routenname für diesen Publisher. Muss folgendermaßen formatiert sein: „exchanges/{seller_id}/publishers/{publisherId}“. Beispiel: „exchanges/1234/publishers/5678“.
externalPublisherId

string

Erforderlich. [VERSCHUSSELT] Dieses Feld wird bald durch „externalPublisherIds[]“ ersetzt. Von der Anzeigenplattform bereitgestellte eindeutige Publisher-ID. Muss mit der Publisher-ID übereinstimmen, die in Gebotsanfragen gesendet wurde.

Max. 100 Zeichen. Zulässige Zeichen sind alphanumerische Zeichen, Unterstriche, Bindestriche und Punkte.
externalPublisherIds[]

string

Optional. Von der Anzeigenplattform bereitgestellte Publisher-IDs. Jede ID muss eindeutig sein und mit der Publisher-ID übereinstimmen, die in Gebotsanfragen gesendet wurde.

Maximal 10 Zählungen. Maximal 100 Zeichen pro ID. Zulässige Zeichen sind alphanumerische Zeichen, Unterstriche, Bindestriche und Punkte.
displayName

string

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

enum (DiscoveryObjectStatus)

Erforderlich. Der Status dieses Publishers. Publisher mit dem Status „PAUSIERT“ oder „ENTFERNT“ werden DV3-Werbetreibenden nicht angezeigt.
mediumCapability

enum (MediumCapability)

Erforderlich. Die Medien, auf denen der Publisher seine Anzeigen hosten möchte.
description

string

Erforderlich. Die Beschreibung dieses Verlags und Webpublishers. Muss UTF-8-codiert sein und darf maximal 1.000 Zeichen lang sein. Erforderlich.
contactInfo[]

string

Erforderlich. E-Mail-Adressen der Ansprechpartner, über die die Werbetreibenden mit dem Publisher kommunizieren können. Maximal 10 Kontakte. Jeder Kontakt darf maximal 100 Zeichen lang sein. Beispiel: [US-Kontakt – Max Mustermann: max.mustermann@abc.com] Erforderlich.
commitmentCapability[]

enum (CommitmentCapability)

Optional. Die vom Publisher unterstützten Arten von Verpflichtungen.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Erforderlich. Aufschlüsselung der Prognose für das Inventar dieses Publishers. DV3-Werbetreibende können diese Aufschlüsselungen sehen und nach ihnen filtern. Eine Aufschlüsselung der Domainprognose ist erforderlich.
logoUrl

string

Nur Ausgabe. Die URL für das Logo dieses Publishers.
floorPrice

object (Money)

Optional. Der Mindestpreis dieses Publishers. Muss denselben Währungscode wie der Höchstpreis haben.
ceilingPrice

object (Money)

Optional. Der Höchstpreis dieses Publishers. Muss denselben Währungscode wie der Mindestpreis haben.
generalCapability

string

Optional.
tvMetadata

object (TVMetadata)

Optional. Metadaten für einen Publisher mit TV-Angeboten. Erforderlich, wenn die Medium-Funktion „Fernsehen“ enthält. Nicht zutreffend, wenn die Medium-Funktion nicht „Fernsehen“ enthält.
urgOwners[]

enum (UnderRepresentedGroup)

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

MediumCapability

Enum für mittlere Kapazität. Das Marktplatz-Frontend (im Inventarmodul von DV360) enthält verschiedene Bereiche für Inventar. „Digital: Dazu gehören Publisher und Auktionspakete für Display-, Video- (einschließlich CTV und OTT) und Audioinventar.“ „TV: In diesem neuen Bereich finden Sie CTV- und OTT-Inventar. CTV und OTT werden wie unten definiert: „Internetfähige Fernseher (CTV) umfassen alle Geräte, auf die eine der folgenden Beschreibungen zutrifft: – Internetfähige Geräte oder Streaminggeräte: Geräte, die mit einem Fernseher verbunden werden können, um Videostreams wiederzugeben (z. B. Roku und Apple TV) – Smart-TV: Fernseher mit integrierter Internetverbindung (z. B. Samsung Smart TV) – Spielekonsolen: Spielekonsolen mit Internetverbindung (z. B. Xbox, PlayStation und Wii) – Set-Top-Boxen: Geräte, über die traditionelle Kabel- und Video-on-Demand-Inhalte wiedergegeben werden.“ „Over-the-Top“ (OTT) bezeichnet TV-ähnliche Videoinhalte, die von einem Videoanbieter über das Internet außerhalb der geschlossenen Netzwerke von Telekommunikations- und Kabelanbietern bereitgestellt werden. OTT-Videos können auf Computern, Mobilgeräten, Tablets sowie auf CTV- oder STB-Geräten angesehen werden (sofern die Inhalte für Letztere über IP bereitgestellt werden). „Audio: Dieser neue Bereich ist speziell für Audioinventar gedacht.“ „OOH: Digitale Außenwerbung“

Enums
MEDIUM_CAPABILITY_UNSPECIFIED Medienfunktion nicht angegeben. Ungültige Eingabe.
MEDIUM_CAPABILITY_DIGITAL Digitale Mittelkapazität.
MEDIUM_CAPABILITY_TV Fernseher mit mittlerer Leistung.
MEDIUM_CAPABILITY_AUDIO Audio mit mittlerer Funktion
MEDIUM_CAPABILITY_OOH Mittelmäßige Leistung außerhalb des Zuhauses.

CommitmentCapability

Enum für die Zusicherungsfunktion.

Enums
COMMITMENT_CAPABILITY_UNSPECIFIED Die Zusicherungsfunktion ist nicht angegeben. Ungültige Eingabe.
COMMITMENT_CAPABILITY_GUARANTEED Der Publisher hat garantiertes Inventar.
COMMITMENT_CAPABILITY_NON_GUARANTEED Der Publisher hat nicht garantiertes Inventar.

TVMetadata

Metadaten für Publisher mit TV-Angeboten.

JSON-Darstellung 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
Felder
tvDeliveryType

enum (TVDeliveryType)

Erforderlich. Auslieferungstyp von TV-Anzeigen.
topShows[]

string

Optional. Liste der beliebtesten TV-Sendungen des Publishers. Maximale Größe: 10. Muss UTF-8-codiert sein.

TVDeliveryType

Enum für den TV-Auslieferungstyp.

Enums
TV_DELIVERY_TYPE_UNSPECIFIED Typ der TV-Auslieferung nicht angegeben. Ungültige Eingabe.
TV_DELIVERY_TYPE_CTV TV-Auslieferungstyp: internetfähiger Fernseher.
TV_DELIVERY_TYPE_LINEAR_TV TV-Auslieferungstyp: Lineares Fernsehen.

Methoden

create

 Erstellt einen neuen Verlag oder Webpublisher.

get

 Ruft einen Publisher ab.

list

 Listet Publisher auf.

patch

 Aktualisiert einen Publisher.
Laden Sie das Verlagslogo hoch.