REST Resource: exchanges.publishers

Recurso: editor

Encapsula um único editor.

Representação 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

Apenas saída. Nome da rota relativa para esse editor. Precisa estar no formato: "exchanges/{seller_id}/publishers/{publisherId}". Exemplo: "exchanges/1234/publishers/5678".

externalPublisherId

string

Obrigatório. [DESATUALIZADO] Em breve, esse campo será substituído por externalPublisherIds[]. O ID do editor fornecido pela troca é exclusivo. Precisa corresponder ao ID do editor enviado nas solicitações de lance.

Máximo de 100 caracteres. Os caracteres permitidos são alfanuméricos, sublinhados, hifens e pontos.

externalPublisherIds[]

string

Opcional. Troca de IDs de editores fornecidos. Cada ID precisa ser exclusivo e corresponder ao ID do editor enviado nas solicitações de lance.

Máximo de 10 contagens. Máximo de 100 caracteres por ID. Os caracteres permitidos são alfanuméricos, sublinhado, traço e ponto.

displayName

string

Obrigatório. O nome de exibição desse editor. Precisa ser codificado em UTF-8 com um tamanho máximo de 30 caracteres.

status

enum (DiscoveryObjectStatus)

Obrigatório. O status do editor. Os editores com status PAUSADO ou REMOVIDO não são mostrados aos anunciantes da DV3.

mediumCapability

enum (MediumCapability)

Obrigatório. A mídia em que o editor planeja hospedar os anúncios.

description

string

Obrigatório. O texto de descrição do editor. Precisa ser codificado em UTF-8 com um tamanho máximo de 1.000 caracteres. Obrigatório.

contactInfo[]

string

Obrigatório. E-mails de contato para os anunciantes se comunicarem com o editor. Máximo de 10 contatos. Cada contato tem no máximo 100 caracteres. Exemplo: [Contato dos EUA: João Silva: john.smith@abc.com]. Obrigatório.

commitmentCapability[]

enum (CommitmentCapability)

Opcional. Tipos de compromisso compatíveis com esse editor.

forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Obrigatório. Desmembramento da previsão para o inventário do editor. Os anunciantes da DV3 podem conferir e filtrar essas informações. O detalhamento da previsão do domínio é obrigatório.

logoUrl

string

Apenas saída. O URL do logotipo do editor.

floorPrice

object (Money)

Opcional. O preço mínimo desse editor. Precisa ter o mesmo código de moeda com o preço máximo.

ceilingPrice

object (Money)

Opcional. O preço máximo dessa editora. Precisa ter o mesmo código de moeda com o preço mínimo.

generalCapability

string

Opcional.

tvMetadata

object (TVMetadata)

Opcional. Metadados do editor que tem ofertas de TV. Obrigatório quando a capacidade do meio inclui TV. Não aplicável quando a capacidade do meio não inclui TV.

urgOwners[]

enum (UnderRepresentedGroup)

Opcional. Em grupos representados em que o proprietário é membro, se houver.

MediumCapability

Enumeração de capacidade média. A interface do Marketplace (no módulo de inventário do DV360) inclui diferentes seções para o inventário. "Digital: inclui editores e pacotes de leilão que abrangem o inventário de display, vídeo (incluindo smart TV e OTT) e áudio." "TV: esta é nossa seção dedicada recém-lançada para descobrir inventários de smart TV e OTT. A CTV e o OTT são definidos da seguinte forma: "A smart TV (CTV) inclui todos os dispositivos que se enquadram nas seguintes descrições: - Dispositivos conectados ou de streaming: são dispositivos que se conectam a uma tela de TV para exibir streams de vídeo (Roku, Apple TV etc.) - Smart TV: são televisões que têm conexão de Internet integrada (Samsung Smart TV etc.). - Consoles de jogos: consoles de jogos conectados à Internet (Xbox, PlayStation, Wii etc.). - Conversores: dispositivos que exibem conteúdo tradicional a cabo e vídeo on demand." "Over the Top (OTT)" significa conteúdo de vídeo semelhante à TV transmitido por um provedor de vídeo pela Internet fora das redes fechadas de provedores de TV a cabo e de telecomunicações. O vídeo OTT pode ser visualizado em computadores, dispositivos móveis, tablets, smart TVs ou conversores, desde que o conteúdo seja transmitido por IP para o último. "Áudio: esta é uma seção dedicada ao inventário de áudio que foi lançada recentemente." "OOH: editores out of home digitais".

Enums
MEDIUM_CAPABILITY_UNSPECIFIED Capacidade média não especificada. Entrada inválida.
MEDIUM_CAPABILITY_DIGITAL Capacidade média digital.
MEDIUM_CAPABILITY_TV TV de capacidade média.
MEDIUM_CAPABILITY_AUDIO Áudio de capacidade média.
MEDIUM_CAPABILITY_OOH Capacidade média fora de casa.

CommitmentCapability

Enum de capacidade de compromisso.

Enums
COMMITMENT_CAPABILITY_UNSPECIFIED Capacidade de compromisso não especificada. Entrada inválida.
COMMITMENT_CAPABILITY_GUARANTEED O editor tem inventário garantido.
COMMITMENT_CAPABILITY_NON_GUARANTEED O editor tem inventário não garantido.

TVMetadata

Metadados para editores com ofertas de TV.

Representação JSON
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
Campos
tvDeliveryType

enum (TVDeliveryType)

Obrigatório. Tipo de veiculação de anúncios de TV.

topShows[]

string

Opcional. Lista dos principais títulos de programas de TV de propriedade do editor. Tamanho máximo: 10. Ser codificado em UTF-8.

TVDeliveryType

Enum de tipo de envio de TV.

Enums
TV_DELIVERY_TYPE_UNSPECIFIED O tipo de entrega de TV não foi especificado. Entrada inválida.
TV_DELIVERY_TYPE_CTV Tipo de envio de TV: smart TV.
TV_DELIVERY_TYPE_LINEAR_TV Tipo de exibição de TV: TV linear.

Métodos

create

Cria um novo editor.

get

Recebe um editor.

list

Lista os editores.

patch

Atualiza um editor.
Faça upload do logotipo da editora.