REST Resource: exchanges.inventorySources

Recurso: InventorySource

Modelo de execução de uma origem de inventário do DV360.

Representação JSON 
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
Campos
name

string

Apenas saída. Nome do recurso relativo para o pedido. Gerado pelo servidor. Exemplo: "exchanges/1234/inventorySources/5678".
buyerStatus

enum (BuyerStatus)

Apenas saída. Status do comprador.
sellerStatus

enum (SellerStatus)

Status do vendedor.
transactionType

enum (TransactionType)

Apenas saída. Tipo de transação do produto.
pricingType

enum (PricingType)

Apenas saída. Tipo de preço do produto.
rateDetails

object (RateDetails)

Apenas saída. Detalhes da tarifa.
startTime

string (Timestamp format)

Apenas saída. O horário em que o produto será ativado. Precisa ser anterior a "endTime". O horário de início não pode ser mais de um ano no futuro.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Apenas saída. O momento em que este produto fica inativo.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

Previsão de volume diário fornecida pela troca. Usado para determinar o ritmo e permitir a escolha do comprador. Este campo está obsoleto.
audienceMatchRate

number

Apenas saída. Taxa de correspondência de público-alvo prevista para transações programáticas garantidas com segmentação por público-alvo, usada pela troca para determinar quantas solicitações adicionais devem ser enviadas. É um número decimal entre 0 e 1, cujo inverso deve ser usado como um multiplicador para as impressões. 0 indica que o campo não está definido e, portanto, não tem segmentação por público-alvo. Exemplo: "0.125". Isso indica que 12,5% das solicitações correspondem à segmentação por público-alvo, e a quantidade de solicitações enviadas deve ser 8 vezes as impressões negociadas.
makegoodRequested

boolean

Apenas saída. Indica se uma compensação foi solicitada ao comprador.
makegoodRequestedReason

string

Apenas saída. Motivo da solicitação de compensação fornecido pelo comprador.
percentFrequencyCapExcludedTraffic

string (int64 format)

Porcentagem do tráfego excluído do limite de frequência em uma transação programática garantida. É um número inteiro entre 0 e 100. O valor 0 (também o padrão) indica que não há exclusão e, portanto, todo o tráfego está qualificado para o limite de frequência. O valor 100 indica exclusão completa e, portanto, nenhum limite de frequência será aplicado. Valores entre 0 e 100 resultam em exclusão parcial. Por exemplo, um valor de 20 fará com que 20% do tráfego sejam excluídos do limite de frequência.
dv360WseatId[]

string (int64 format)

Apenas saída. As wseats que têm permissão para a origem de inventário.
lastModifiedTime

string (Timestamp format)

Apenas saída. A última vez que a origem de inventário foi atualizada. Observação: algumas atualizações internas do DV3 mudarão o horário da última modificação.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
creativeApprovalConfig

object (CreativeApprovalConfig)

Opcional. A configuração para aprovação de criativos. A aprovação pode ser exigida no nível da troca ou do publisher.

BuyerStatus

Status do comprador.

Tipos enumerados
BUYER_STATUS_UNSPECIFIED O status do comprador não foi especificado. Valor de entrada inválido.
BUYER_STATUS_ACTIVE O status do comprador está ativo. Item de linha atribuído, criativo válido atribuído.
BUYER_STATUS_PENDING Status do comprador pendente. Esse status significa que o negócio não está ativo e que o comprador precisa realizar determinadas ações.
BUYER_STATUS_PAUSED Status do comprador pausado pelo comprador.

SellerStatus

Status do vendedor.

Tipos enumerados
SELLER_STATUS_UNSPECIFIED O status do vendedor não foi especificado. Inesperado, indica que o status da negociação é desconhecido. Valor de entrada inválido.
SELLER_STATUS_ACTIVE O status do vendedor está ativo. A origem de inventário está ativa no lado da troca.
SELLER_STATUS_PAUSED O status do vendedor foi pausado.

InventorySourceVolumeForecast

Previsão diária do volume de solicitações para uma origem de inventário. As seguintes regras de validação se aplicam: - uma entrada precisa ser fornecida para cada dia da semana - o volume não pode ser negativo - o timeZoneId é obrigatório e precisa ser válido

Representação JSON 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
Campos
dailyVolumes[]

object (DailyVolume)

Previsão de volumes diários.
timeZoneId

string

Fuso horário do banco de dados IANA, por exemplo, "America/New_York", usado para os volumes diários.

DailyVolume

Volume de solicitações de uma origem de inventário em um determinado dia.

Representação JSON 
{
  "day": enum (DayOfWeek),
  "volume": string
}
Campos
day

enum (DayOfWeek)

Dia da semana a que o volume de solicitações se aplica.
volume

string (int64 format)

O volume de solicitações previsto para o dia da semana especificado.

DayOfWeek

Representa um dia da semana.

Enums
DAY_OF_WEEK_UNSPECIFIED O dia da semana não é especificado.
MONDAY Segunda-feira
TUESDAY Terça-feira
WEDNESDAY Quarta-feira
THURSDAY Quinta-feira
FRIDAY Sexta-feira
SATURDAY Sábado
SUNDAY Domingo

CreativeApprovalConfig

A configuração para aprovação de criativos.

Representação JSON 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
Campos
requiresExchangeApproval

boolean

Obrigatório. Indica se o criativo requer aprovação prévia de ingestão no nível da troca.
publisherConfigs[]

object (PublisherConfig)

Opcional. A configuração do editor.

PublisherConfig

A configuração do publisher (publisher_config). Se publisher_config estiver definido, o criativo vai precisar de aprovação prévia no nível do editor.

Representação JSON 
{
  "publisherId": string,
  "publisherDisplayName": string
}
Campos
publisherId

string

Obrigatório. O ID do publisher.
publisherDisplayName

string

Obrigatório. O nome do publisher.

Métodos

get

 Recebe uma origem de inventário.

list

 Lista as origens de inventário.

patch

 Atualiza uma origem de inventário.