REST Resource: exchanges.publishers

Zasób: Publisher

Zawiera pojedynczego wydawcę.

Zapis JSON 
{
  "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)
  ]
}
Pola
name

string

Tylko dane wyjściowe. Nazwa względna trasy dla tego wydawcy. Powinien mieć format: „exchanges/{seller_id}/publishers/{publisherId}”. Przykład: „exchanges/1234/publishers/5678”.
externalPublisherId

string

Wymagane. [WYCOFANE] To pole zostanie wkrótce zastąpione przez externalPublisherIds[]. Giełda przekazuje unikalny identyfikator wydawcy. Musi być zgodny z identyfikatorem wydawcy wysłanym w pytaniach o stawkę.

Maksymalnie 100 znaków. Dozwolone znaki to znaki alfanumeryczne, podkreślenia, łączniki i kropki.
externalPublisherIds[]

string

Opcjonalnie. Identyfikatory wydawcy podawane przez giełdę. Każdy identyfikator musi być niepowtarzalny i odpowiadać identyfikatorowi wydawcy przesłanemu w żądaniach stawek.

Maksymalnie 10 liczb. Maksymalnie 100 znaków na identyfikator. Dozwolone znaki to znaki alfanumeryczne, podkreślenia, łączniki i kropki.
displayName

string

Wymagane. Wyświetlana nazwa tego wydawcy. Musi być zakodowany w formacie UTF-8 i mieć maksymalnie 30 znaków.
status

enum (DiscoveryObjectStatus)

Wymagane. Stan tego wydawcy. Wydawcy ze stanem PAUSED (Wstrzymany) lub REMOVED (Usunięty) nie są widoczni dla reklamodawców DV3.
mediumCapability

enum (MediumCapability)

Wymagane. Media, w których wydawca planuje umieszczać reklamy.
description

string

Wymagane. Tekst opisu tego wydawcy. Musi być zakodowany w formacie UTF-8 i mieć maksymalnie 1000 znaków. Wymagane.
contactInfo[]

string

Wymagane. Adresy e-mail osób kontaktowych, które reklamodawcy mogą używać do komunikacji z wydawcą. Maksymalnie 10 kontaktów. Każdy kontakt może mieć maksymalnie 100 znaków. Przykład: [Kontakt w Stanach Zjednoczonych – Jan Kowalski: john.smith@abc.com]. Wymagane.
commitmentCapability[]

enum (CommitmentCapability)

Opcjonalnie. Typy zobowiązań obsługiwane przez tego wydawcę.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Wymagane. Prognozowanie prognozy dla zasobów reklamowych tego wydawcy. Reklamodawcy w DV3 mogą wyświetlać te zestawienia i je filtrować. Wymagane jest zestawienie prognozy domeny.
logoUrl

string

Tylko dane wyjściowe. Adres URL logo tego wydawcy.
floorPrice

object (Money)

Opcjonalnie. Cena minimalna tego wydawcy. Musi mieć ten sam kod waluty co cena maksymalna.
ceilingPrice

object (Money)

Opcjonalnie. Maksymalna cena tego wydawcy. Musi mieć ten sam kod waluty co cena minimalna.
generalCapability

string

Opcjonalnie.
tvMetadata

object (TVMetadata)

Opcjonalnie. Metadane wydawcy, który ma oferty telewizyjne. Wymagany, gdy medium zawiera telewizję. Nie dotyczy, gdy medium nie ma możliwości wyświetlania treści na telewizorze.
urgOwners[]

enum (UnderRepresentedGroup)

Opcjonalnie. Grupy reprezentowane przez właściciela, jeśli takie istnieją.

MediumCapability

Wyliczenie możliwości medium. Interfejs Rynku (w ramach modułu Zasoby reklamowe DV360) zawiera różne sekcje dotyczące zasobów reklamowych. „Treści cyfrowe: obejmuje to wydawców i pakiety aukcji obejmujące zasoby reklamowe w sieci reklamowej, wideo (w tym CTV i OTT) oraz audio”. „TV: to nowa sekcja poświęcona zasobom reklamowym na urządzeniach CTV i OTT. CTV i OTT są definiowane w ten sposób: „CTV (telewizory z internetem) obejmuje wszystkie urządzenia pasujące do tych kategorii: – Podłączone urządzenia lub urządzenia do strumieniowego przesyłania danych: urządzenia podłączone do ekranu telewizyjnego, które wyświetlają strumienie wideo (np. Roku, Apple TV). – Telewizory Smart TV: telewizory z wbudowanym połączeniem internetowym (np. Samsung Smart TV). – Konsole do gier: konsole do gier mające połączenie z internetem (np. Xbox, PlayStation, Wii). – Dekodery: urządzenia wyświetlające przekazy z tradycyjnych telewizji kablowych i treści wideo na żądanie. „Over the Top (OTT)” to treści wideo podobne do telewizyjnych dostarczane przez dostawcę treści wideo przez internet poza zamkniętymi sieciami dostawców usług telekomunikacyjnych i kablowych. Treści OTT Video można oglądać na komputerach, urządzeniach mobilnych, tabletach, a także na telewizorach CTV i dekoderach (o ile treści są dostarczane przez sieć IP). „Audio: to nowo uruchomiona sekcja poświęcona zasobom audio”. „OOH: wydawcy cyfrowych reklam zewnętrznych”.

Wartości w polu enum
MEDIUM_CAPABILITY_UNSPECIFIED Nieokreślone możliwości medium. Nieprawidłowe dane wejściowe.
MEDIUM_CAPABILITY_DIGITAL Średnia wydajność cyfrowa.
MEDIUM_CAPABILITY_TV Telewizor o średnich możliwościach.
MEDIUM_CAPABILITY_AUDIO Dźwięk o średniej jakości.
MEDIUM_CAPABILITY_OOH Średnia zdolność do działania poza domem.

CommitmentCapability

Typ zobowiązania.

Wartości w polu enum
COMMITMENT_CAPABILITY_UNSPECIFIED Nie określono możliwości zobowiązania. Nieprawidłowe dane wejściowe.
COMMITMENT_CAPABILITY_GUARANTEED Wydawca ma gwarantowane zasoby reklamowe.
COMMITMENT_CAPABILITY_NON_GUARANTEED Wydawca ma niegwarantowane zasoby reklamowe.

TVMetadata

Metadane wydawców, którzy mają oferty TV.

Zapis JSON 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
Pola
tvDeliveryType

enum (TVDeliveryType)

Wymagane. Typ dostawy reklam telewizyjnych.
topShows[]

string

Opcjonalnie. Lista najpopularniejszych tytułów programów telewizyjnych należących do wydawcy. Maksymalny rozmiar: 10. Musi być zakodowany w formacie UTF-8.

TVDeliveryType

Typ wyświetlania telewizyjnego.

Wartości w polu enum
TV_DELIVERY_TYPE_UNSPECIFIED Nieokreślony typ dostawy telewizyjnej. Nieprawidłowe dane wejściowe.
TV_DELIVERY_TYPE_CTV Typ dostawy TV: CTV.
TV_DELIVERY_TYPE_LINEAR_TV Typ dostawy telewizyjnej: telewizja linearna.

Metody

create

 Tworzy nowego wydawcę.

get

 Pobiera dane wydawcy.

list

 Wyświetla listę wydawców.

patch

 Aktualizuje wydawcę.
Prześlij logo wydawcy.