REST Resource: exchanges.publishers

Risorsa: Editore

Incapsula un singolo publisher.

Rappresentazione 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)
  ]
}
Campi
name

string

Solo output. Nome percorso relativo per questo editore. Deve essere nel seguente formato: "exchanges/{seller_id}/publishers/{publisherId} Esempio: "exchanges/1234/publishers/5678".
externalPublisherId

string

Obbligatorio. [OBSOLETO] Questo campo verrà presto sostituito da externalPublisherIds[]. L'ID publisher univoco fornito dalla piattaforma di scambio. Deve corrispondere all'ID publisher inviato nelle richieste di offerta.

Massimo 100 caratteri. I caratteri consentiti sono alfanumerici, trattini bassi, trattini e punti.
externalPublisherIds[]

string

Facoltativo. ID publisher forniti dalla piattaforma di scambio. Ogni ID deve essere univoco e corrispondere all'ID publisher inviato nelle richieste di offerta.

Massimo 10 conteggi. Massimo 100 caratteri per ID. I caratteri consentiti sono alfanumerici, trattini bassi, trattini e punti.
displayName

string

Obbligatorio. Il nome visualizzato di questo editore. Deve essere codificato in UTF-8 con una dimensione massima di 30 caratteri.
status

enum (DiscoveryObjectStatus)

Obbligatorio. Lo stato di questo publisher. I publisher con stato PAUSATO o RIMOSSO non vengono mostrati agli inserzionisti DV3.
mediumCapability

enum (MediumCapability)

Obbligatorio. I media su cui questo publisher prevede di pubblicare i propri annunci.
description

string

Obbligatorio. Il testo descrittivo di questo editore. Deve essere codificato in UTF-8 con una dimensione massima di 1000 caratteri. Obbligatorio.
contactInfo[]

string

Obbligatorio. Indirizzi email dei punti di contatto per consentire agli inserzionisti di comunicare con l'editore. Massimo 10 contatti. Ogni contatto può contenere al massimo 100 caratteri. Esempio: [Contatto Stati Uniti - John Smith: john.smith@abc.com]. Obbligatorio.
commitmentCapability[]

enum (CommitmentCapability)

Facoltativo. Tipi di impegno supportati da questo publisher.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Obbligatorio. Analisi dettagliata della previsione per l'inventario di questo publisher. Gli inserzionisti DV3 possono visualizzare e filtrare i dati in base a queste suddivisioni. La suddivisione della previsione del dominio è obbligatoria.
logoUrl

string

Solo output. L'URL del logo di questo editore.
floorPrice

object (Money)

Facoltativo. Il prezzo minimo di questo editore. Deve avere lo stesso codice valuta del prezzo massimo.
ceilingPrice

object (Money)

Facoltativo. Il prezzo massimo di questo editore. Deve avere lo stesso codice valuta del prezzo minimo.
generalCapability

string

Facoltativo.
tvMetadata

object (TVMetadata)

Facoltativo. Metadati per il publisher che offre contenuti TV. Obbligatorio quando la funzionalità del mezzo include la TV. Non applicabile se la funzionalità del mezzo non include la TV.
urgOwners[]

enum (UnderRepresentedGroup)

Facoltativo. Gruppi sottorappresentati di cui il proprietario fa parte, se presenti.

MediumCapability

Enum delle funzionalità medie. La pagina frontend del marketplace (all'interno del Modulo di inventario di DV360) include diverse sezioni per l'inventario. "Digitale: include publisher e pacchetti di aste che spaziano dall'inventario display, video (incluse CTV e OTT) e audio". "TV: questa è la nostra sezione dedicata appena lanciata per scoprire l'inventario per TV connesse a internet (CTV) e OTT. Le TV connesse a internet e le piattaforme OTT sono definite come segue: "Le TV connesse a internet (CTV) includono tutti i dispositivi che rispondono alle seguenti descrizioni: - Dispositivi connessi o di streaming: dispositivi che si connettono a uno schermo TV per mostrare video stream (Roku, Apple TV e così via) - Smart TV: TV con connessione a internet integrata (Samsung Smart TV ecc.) - Console per videogiochi: console per videogiochi connesse a internet (Xbox, PlayStation, Wii ecc.) - Decoder: dispositivi che offrono contenuti via cavo tradizionali e video on demand." "Over-the-top (OTT)" indica contenuti video simili alla TV trasmessi da un fornitore di video su internet al di fuori delle reti chiuse di fornitori di servizi di telecomunicazioni e via cavo. I video OTT possono essere visualizzati su computer, dispositivi mobili, tablet e TV connesse a internet (CTV) o decoder (a condizione che i contenuti vengano trasmessi tramite IP per questi ultimi). "Audio: si tratta di una sezione dedicata appena lanciata per l'inventario audio." "OOH: publisher out of home digitale".

Enum
MEDIUM_CAPABILITY_UNSPECIFIED Capacità media non specificata. Input non valido.
MEDIUM_CAPABILITY_DIGITAL Digitale con capacità media.
MEDIUM_CAPABILITY_TV TV di media potenza.
MEDIUM_CAPABILITY_AUDIO Audio con funzionalità medie.
MEDIUM_CAPABILITY_OOH Capacità media out of home.

CommitmentCapability

Enum della funzionalità di impegno.

Enum
COMMITMENT_CAPABILITY_UNSPECIFIED Capacità di impegno non specificata. Input non valido.
COMMITMENT_CAPABILITY_GUARANTEED Il publisher dispone di inventario garantito.
COMMITMENT_CAPABILITY_NON_GUARANTEED L'editore dispone di inventario non garantito.

TVMetadata

Metadati per i publisher che offrono contenuti TV.

Rappresentazione JSON 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
Campi
tvDeliveryType

enum (TVDeliveryType)

Obbligatorio. Tipo di pubblicazione degli annunci TV.
topShows[]

string

Facoltativo. Elenco dei principali titoli di programmi TV di proprietà dell'editore. Dimensione massima 10. Deve essere codificato in UTF-8.

TVDeliveryType

Enum del tipo di pubblicazione per la TV.

Enum
TV_DELIVERY_TYPE_UNSPECIFIED Tipo di pubblicazione TV non specificato. Input non valido.
TV_DELIVERY_TYPE_CTV Tipo di pubblicazione TV: TV connessa a internet.
TV_DELIVERY_TYPE_LINEAR_TV Tipo di pubblicazione TV: TV lineare.

Metodi

create

 Crea un nuovo editore.

get

 Recupera un editore.

list

 Elenca i publisher.

patch

 Aggiorna un editore.
Carica il logo dell'editore.