REST Resource: exchanges.publishers

Recurso: Editor

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 relativo para este publicador. Debe tener el siguiente formato: "exchanges/{seller_id}/publishers/{publisherId}. Ejemplo: "exchanges/1234/publishers/5678".
externalPublisherId

string

Obligatorio. [OBSOLETO] Este campo pronto se reemplazará por externalPublisherIds[]. Exchange proporcionó un ID de publicador único. Debe coincidir con el ID del publicador que se envía en las solicitudes de oferta.

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

string

Opcional. El mercado proporcionó los IDs del publicador. Cada ID debe ser único y coincidir con el ID del publicador que se envía en las solicitudes de oferta.

Máximo de 10 recuentos. Se permiten 100 caracteres como máximo 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 DETENIDO o REMOVIDO no se muestran a los anunciantes de DV3.
mediumCapability

enum (MediumCapability)

Obligatorio. El medio en el que este publicador planea alojar sus anuncios.
description

string

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

string

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

enum (CommitmentCapability)

Opcional. Son los tipos de compromisos que admite este publicador.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Obligatorio. 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)

Opcional. Es el precio mínimo de este editor. Debe tener el mismo código de moneda con el precio máximo.
ceilingPrice

object (Money)

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

string

Opcional.
tvMetadata

object (TVMetadata)

Opcional. Metadatos del publicador que tiene ofertas de TV. Obligatorio cuando la capacidad del medio incluye TV. No se aplica cuando la capacidad de contenido multimedia no incluye TV.
urgOwners[]

enum (UnderRepresentedGroup)

Opcional. Grupos subrepresentados de los que el propietario es miembro, si corresponde

MediumCapability

Enumeración de capacidades medias. El frontend de Marketplace (dentro del módulo Inventory de DV360) incluye diferentes secciones para el inventario. "Digital: Incluye publicadores y paquetes de subastas que abarcan inventario de Display, Video (incluidos CTV y OTT) y Audio". "TV: Esta es nuestra nueva sección exclusiva para descubrir inventario de CTV y OTT. La CTV y la 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étera). - Smart TV: Son TVs con conexión a Internet integrada (Samsung Smart TV, etcétera). - Consolas de juegos: Consolas de juegos con conexión a Internet (Xbox, PlayStation, Wii, etcétera) - Decodificador: Dispositivo que ofrece contenido tradicional por cable y video on demand". "Transmisión libre (OTT) significa contenido de video similar a la TV que ofrece un proveedor de video a través de Internet fuera de las redes cerradas de los proveedores de telecomunicaciones y cable. Los videos de OTT se pueden mirar en computadoras, dispositivos móviles, tablets, así como en CTV o STB (siempre que el contenido se publique a través de IP para estos últimos). "Audio: Esta es una sección nueva y exclusiva para el inventario de audio". "OOH: Publicadores de publicidad digital exterior".

Enumeraciones
MEDIUM_CAPABILITY_UNSPECIFIED No se especificó la capacidad media. La entrada no es válida.
MEDIUM_CAPABILITY_DIGITAL Digital de capacidad media
MEDIUM_CAPABILITY_TV TV de capacidad media
MEDIUM_CAPABILITY_AUDIO Audio de capacidad media
MEDIUM_CAPABILITY_OOH Capacidad media fuera del hogar.

CommitmentCapability

Enum de capacidades de compromiso.

Enumeraciones
COMMITMENT_CAPABILITY_UNSPECIFIED No se especificó la capacidad de compromiso. La entrada no es válida.
COMMITMENT_CAPABILITY_GUARANTEED El publicador tiene inventario garantizado.
COMMITMENT_CAPABILITY_NON_GUARANTEED El editor tiene inventario no garantizado.

TVMetadata

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

Opcional. Es la lista de los títulos de los programas de TV principales que pertenecen al publicador. Tamaño máximo: 10. Debe estar codificado en UTF-8.

TVDeliveryType

Enumeración del tipo de publicación de TV.

Enumeraciones
TV_DELIVERY_TYPE_UNSPECIFIED No se especificó el tipo de entrega de TV. La entrada no es válida.
TV_DELIVERY_TYPE_CTV Tipo de publicación de TV: TV conectada
TV_DELIVERY_TYPE_LINEAR_TV Tipo de publicación de TV: TV lineal.

Métodos

create

 Crea un editor nuevo.

get

 Obtiene un publicador.

list

 Muestra una lista de publicadores.

patch

 Actualiza un editor.
Sube el logotipo del editor.