REST Resource: exchanges.publishers

Recurso: Publisher

Encapsula um único publisher.

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 publisher. Precisa estar no formato: "exchanges/{seller_id}/publishers/{publisherId} Exemplo: "exchanges/1234/publishers/5678".
externalPublisherId

string

Obrigatório. [DESCONTINUADO] Esse campo será substituído em breve por externalPublisherIds[]. ID exclusivo do publisher fornecido pela exchange. Precisa corresponder ao ID do publisher enviado nas solicitações de lance.

Máximo de 100 caracteres. Os caracteres permitidos são alfanuméricos, sublinhado, traço e ponto.
externalPublisherIds[]

string

Opcional. IDs do publisher fornecidos pela exchange. Cada ID precisa ser exclusivo e corresponder ao ID do publisher 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 publisher. Precisa ser codificado em UTF-8 com um tamanho máximo de 30 caracteres.
status

enum (DiscoveryObjectStatus)

Obrigatório. O status desse publisher. Os publishers com status PAUSED ou REMOVED não são mostrados aos anunciantes do DV3.
mediumCapability

enum (MediumCapability)

Obrigatório. A mídia em que esse publisher planeja hospedar os anúncios.
description

string

Obrigatório. O texto de descrição desse publisher. Precisa ser codificado em UTF-8 com um tamanho máximo de 1.000 caracteres.
contactInfo[]

string

Obrigatório. E-mails de contato para os anunciantes se comunicarem com o publisher. Máximo de 10 contatos. Cada contato tem no máximo 100 caracteres. Exemplo: [US contact - John Smith: john.smith@abc.com].
commitmentCapability[]

enum (CommitmentCapability)

Opcional. Tipos de compromisso que esse publisher aceita.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Obrigatório. Detalhamento da estimativa do inventário desse publisher. Os anunciantes do DV3 podem conferir e filtrar esses detalhes. É necessário detalhar a previsão de domínio.
logoUrl

string

Apenas saída. O URL do logotipo desse publisher.
floorPrice

object (Money)

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

object (Money)

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

string

Opcional. Descrição geral em formato de texto livre. Precisa ser codificado em UTF-8 com um tamanho máximo de 200 caracteres. Essa descrição pode ser de SOV(participação de voz), CPD, garantia de volume. Exemplo de descrição: "CPD, alto impacto, 69% de visibilidade média"
tvMetadata

object (TVMetadata)

Opcional. Metadados para publishers que têm ofertas de TV. Obrigatório quando a capacidade de mídia contém TV. Não aplicável quando a capacidade de mídia não contém TV.
urgOwners[]

enum (UnderRepresentedGroup)

Opcional. Grupos sub-representados dos quais o proprietário é membro, se houver.

MediumCapability

Enumeração da capacidade de mídia. O front-end do Marketplace (no módulo de inventário do DV360) inclui diferentes seções para inventário. "Digital: inclui publishers e pacotes de leilão que abrangem inventário de display, vídeo (incluindo CTV e OTT) e áudio." "TV: é a nossa nova seção dedicada para descobrir o inventário de CTV e OTT. CTV e OTT são definidos da seguinte maneira: "A TV conectada (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 TVs com conexão de Internet integrada (Samsung Smart TV etc.). - Consoles de jogos: são consoles conectados à Internet (Xbox, PlayStation, Wii etc.). - Conversores: são 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 entregue por um provedor de vídeo pela Internet fora das redes fechadas de telecomunicações e provedores de TV a cabo. O vídeo OTT pode ser assistido em computadores, dispositivos móveis, tablets, bem como em dispositivos CTV ou STB (desde que o conteúdo seja entregue por IP para o último). "Áudio: é uma seção dedicada recém-lançada para inventário de áudio." "OOH: publishers de mídia digital out of home."

Tipos enumerados
MEDIUM_CAPABILITY_UNSPECIFIED Capacidade de mídia não especificada. Entrada inválida.
MEDIUM_CAPABILITY_DIGITAL Capacidade de mídia digital.
MEDIUM_CAPABILITY_TV Capacidade de mídia de TV.
MEDIUM_CAPABILITY_AUDIO Capacidade de mídia de áudio.
MEDIUM_CAPABILITY_OOH Capacidade de mídia out of home.

CommitmentCapability

Enumeração da capacidade de compromisso.

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

TVMetadata

Metadados para publishers que têm ofertas de TV.

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

enum (TVDeliveryType)

Obrigatório. Tipo de exibição de anúncios de TV.
topShows[]

string

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

TVDeliveryType

Enumeração do tipo de exibição de TV.

Tipos enumerados
TV_DELIVERY_TYPE_UNSPECIFIED Tipo de exibição de TV não especificado. Entrada inválida.
TV_DELIVERY_TYPE_CTV Tipo de exibição de TV conectada.
TV_DELIVERY_TYPE_LINEAR_TV Tipo de exibição de TV linear.

Métodos

create

 Cria um publisher.

get

 Recebe um publisher.

list

 Lista publishers.

patch

 Atualiza um publisher.
Faz upload do logotipo do publisher.