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 momento em que o produto fica ativo. Precisa ser anterior a endTime. O horário de início não pode ser mais de um ano no futuro.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" 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 o produto fica inativo.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" 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)

A troca forneceu a previsão de volume diário. 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. Esse é um número decimal entre 0 e 1, e o inverso dele precisa ser usado como um multiplicador para as impressões. 0 indica que o campo não foi 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 precisa ser 8 vezes maior que as impressões negociadas.
makegoodRequested

boolean

Apenas saída. Indica se uma compensação foi solicitada pelo 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 de uma transação programática garantida. É um número inteiro entre 0 e 100. O valor 0 (também é o valor 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 resultarão em exclusão parcial. Por exemplo, um valor de 20 vai resultar em 20% do tráfego sendo excluído 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. Última vez que a origem do inventário foi atualizada. Algumas atualizações internas do DV3 vão mudar o horário da última modificação.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" 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 a aprovação do criativo. A aprovação pode ser necessária no nível da troca ou do editor.

BuyerStatus

Status do comprador.

Enums
BUYER_STATUS_UNSPECIFIED O status do comprador não foi especificado. Valor de entrada inválido.
BUYER_STATUS_ACTIVE Status do comprador: ativo. Item de linha atribuído, criativo válido atribuído.
BUYER_STATUS_PENDING Status do comprador pendente. Esse status significa que a transação não está ativa e que o comprador precisa realizar algumas ações.
BUYER_STATUS_PAUSED O status do comprador foi pausado pelo comprador.

SellerStatus

Status do vendedor.

Enums
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 Status do vendedor: ativo. A origem do inventário está ativa no lado da troca.
SELLER_STATUS_PAUSED O status do vendedor está pausado.

InventorySourceVolumeForecast

Previsão do volume de solicitações diárias 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 de fusos horários da IANA, por exemplo, "America/New_York", que é usado para os volumes diários.

DailyVolume

Solicitar o volume 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 em que o volume de solicitações se aplica.
volume

string (int64 format)

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

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 a aprovação do criativo.

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

boolean

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

object (PublisherConfig)

Opcional. A configuração do editor.

PublisherConfig

A configuração do editor (publisher_config). Se o publisher_config estiver definido, o criativo vai precisar de aprovação antes da transferência no nível do editor.

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

string

Obrigatório. O ID do editor.
publisherDisplayName

string

Obrigatório. O nome do editor.

Métodos

get

 Recebe uma origem de inventário.

list

 Lista as origens de inventário.

patch

 Atualiza uma origem de inventário.