REST Resource: exchanges.publishers

Recurso: Publisher

Encapsula un solo publicador.

Representación 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)
  ]
}
Campos
name

string

Solo salida. Es el nombre de ruta relativa de este publicador. Debe tener el formato "exchanges/{seller_id}/publishers/{publisherId}". Ejemplo: "exchanges/1234/publishers/5678".
externalPublisherId

string

Obligatorio. [EN DESUSO] Este campo se reemplazará pronto por externalPublisherIds[]. Es el ID de publicador único proporcionado por el exchange. Debe coincidir con el ID de publicador enviado en las solicitudes de oferta.

Máx. de 100 caracteres. Los caracteres permitidos son alfanuméricos, guiones bajos, guiones y puntos.
externalPublisherIds[]

string

Es opcional. Son los IDs de publicador proporcionados por el exchange. Cada ID debe ser único y coincidir con el ID de publicador enviado en las solicitudes de oferta.

Máx. de 10 recuentos. Máx. de 100 caracteres por ID. Los caracteres permitidos son alfanuméricos, guiones bajos, guiones y puntos.
displayName

string

Obligatorio. Es el nombre visible de este publicador. Debe estar codificado en UTF-8 con un tamaño máximo de 30 caracteres.
status

enum (DiscoveryObjectStatus)

Obligatorio. Es el estado de este publicador. Los publicadores con el estado PAUSED o REMOVED no se muestran a los anunciantes de DV3.
mediumCapability

enum (MediumCapability)

Obligatorio. Son los medios en los que este publicador planea alojar sus anuncios.
description

string

Obligatorio. Es el texto de descripción de este publicador. Debe estar codificado en UTF-8 con un tamaño máximo de 1,000 caracteres.
contactInfo[]

string

Obligatorio. Son los correos electrónicos de los puntos de contacto para que los anunciantes se comuniquen con el publicador. Máx. de 10 contactos. Cada contacto puede tener un máximo de 100 caracteres. Ejemplo: [US contact - John Smith: john.smith@abc.com].
commitmentCapability[]

enum (CommitmentCapability)

Es opcional. Son los tipos de compromiso que admite este publicador.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Obligatorio. Es el desglose de la previsión del inventario de este publicador. Los anunciantes de DV3 pueden ver y filtrar estos desgloses. Se requiere el desglose de la previsión del dominio.
logoUrl

string

Solo salida. Es la URL del logotipo de este publicador.
floorPrice

object (Money)

Es opcional. Es el precio mínimo de este publicador. Debe tener el mismo código de moneda que el precio máximo.
ceilingPrice

object (Money)

Es opcional. Es el precio máximo de este publicador. Debe tener el mismo código de moneda que el precio mínimo.
generalCapability

string

Es opcional. Es una descripción general en formato de texto libre. Debe estar codificado en UTF-8 con un tamaño máximo de 200 caracteres. Esta descripción puede ser de SOV(cuota publicitaria de la marca), CPD o garantía de volumen. Ejemplo de descripción: "CPD, High Impact, 69% avg. viewability"
tvMetadata

object (TVMetadata)

Es opcional. Son los metadatos del publicador que tiene ofertas de TV. Es obligatorio cuando la capacidad de medios contiene TV. No se aplica cuando la capacidad de medios no contiene TV.
urgOwners[]

enum (UnderRepresentedGroup)

Es opcional. Son los grupos subrepresentados de los que es miembro el propietario, si corresponde.

MediumCapability

Enum de capacidad de medios. El frontend de Marketplace (dentro del módulo de inventario de DV360) incluye diferentes secciones para el inventario. "Digital: Incluye publicadores y paquetes de subasta que abarcan el inventario de Display, Video (incl. CTV y OTT) y Audio". "TV: Es nuestra nueva sección dedicada para descubrir el inventario de CTV y OTT. CTV y OTT se definen de la siguiente manera: "La TV conectada (CTV) incluye todos los dispositivos que se ajusten a las siguientes descripciones: - Dispositivos conectados o de transmisión: Dispositivos que se conectan a una pantalla de TV para mostrar transmisiones de video por Internet (Roku, Apple TV, etc.) - Smart TV: TVs con conexión a Internet integrada (Samsung Smart TV, etc.) - Consolas de juegos: Consolas de juegos con conexión a Internet (Xbox, PlayStation, Wii, etc.) - Decodificadores: Dispositivos que ofrecen contenido tradicional por cable y video on demand". "La transmisión libre (OTT) se refiere al contenido de video similar a la TV que proporciona un proveedor de video a través de Internet fuera de las redes cerradas de los proveedores de telecomunicaciones y cable. El video OTT se puede ver en computadoras de escritorio, dispositivos móviles, tablets, así como en dispositivos CTV o STB (siempre que el contenido se publique a través de IP para estos últimos). "Audio: Es una sección nueva y dedicada para el inventario de audio". "OOH: Publicadores de publicidad digital exterior".

Enums
MEDIUM_CAPABILITY_UNSPECIFIED Capacidad de medios no especificada. No es una entrada válida.
MEDIUM_CAPABILITY_DIGITAL Capacidad de medios digitales.
MEDIUM_CAPABILITY_TV Capacidad de medios de TV.
MEDIUM_CAPABILITY_AUDIO Capacidad de medios de audio.
MEDIUM_CAPABILITY_OOH Capacidad de medios de publicidad exterior.

CommitmentCapability

Enum de capacidad de compromiso.

Enums
COMMITMENT_CAPABILITY_UNSPECIFIED Capacidad de compromiso no especificada. No es una entrada válida.
COMMITMENT_CAPABILITY_GUARANTEED El publicador tiene inventario garantizado.
COMMITMENT_CAPABILITY_NON_GUARANTEED El publicador tiene inventario no garantizado.

TVMetadata

Son los metadatos de los publicadores que tienen ofertas de TV.

Representación JSON 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
Campos
tvDeliveryType

enum (TVDeliveryType)

Obligatorio. Es el tipo de publicación de los anuncios de TV.
topShows[]

string

Es opcional. Es una lista de los títulos de los programas de TV principales que son propiedad del publicador. El tamaño máximo es 10. Debe estar codificado en UTF-8.

TVDeliveryType

Enum de tipo de publicación de TV.

Enums
TV_DELIVERY_TYPE_UNSPECIFIED Tipo de publicación de TV no especificado. No es una entrada válida.
TV_DELIVERY_TYPE_CTV Tipo de publicación de TV conectada.
TV_DELIVERY_TYPE_LINEAR_TV Tipo de publicación de TV lineal.

Métodos

create

 Crea un nuevo publicador.

get

 Obtiene un publicador.

list

 Muestra una lista de publicadores.

patch

 Actualiza un publicador.
Sube el logotipo del publicador.