REST Resource: exchanges.auctionPackages

Recurso: AuctionPackage

Encapsula um único pacote de leilão. Os anunciantes na DV3 podem navegar por todos os pacotes de leilão na DV3 pela interface de descoberta do marketplace e ativar o uso desses pacotes sem a ação do vendedor.

Representação JSON 
{
  "name": string,
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "description": string,
  "format": enum (Format),
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "externalDealId": string,
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "startTime": string,
  "endTime": string,
  "mediumType": enum (MediumType),
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ],
  "dv3MarketplaceUri": string
}
Campos
name

string

Nome de rota relativo para este pacote de leilão. Precisa estar no formato: "exchanges/{seller_id}/auctionpackages/{auction_package_id}". Exemplo: "exchanges/1234/auctionPackage/5678". Apenas saída.
displayName

string

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

enum (DiscoveryObjectStatus)

O status desse pacote de leilão. Os pacotes com status PAUSADO ou REMOVIDO não são mostrados aos anunciantes do DV3. Obrigatório.
description

string

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

enum (Format)

O tipo de formato de anúncio. Obrigatório. Não é possível fazer atualizações após a criação.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Desmembramento da previsão para o inventário desse pacote de leilão. Os anunciantes da DV3 podem conferir e filtrar essas informações. Opcional.
externalDealId

string

O ID da transação da troca usada nas solicitações de lance. Máximo de 100 caracteres. Os caracteres permitidos são alfanuméricos, sublinhado, traço e ponto. Obrigatório. Obrigatório. Não permitir atualizações após a criação.
logoUrl

string

Apenas saída. O URL do logotipo deste pacote de leilão.

Apenas saída.
floorPrice

object (Money)

O preço mínimo desse pacote de leilão. Obrigatório.
startTime

string (Timestamp format)

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. Obrigatório.

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)

O momento em que o produto fica inativo. Obrigatório.

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".
mediumType

enum (MediumType)

Obrigatório. Tipo de mídia do pacote de leilão.
urgOwners[]

enum (UnderRepresentedGroup)

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

string

Apenas saída. Link do DV360 para o pacote de leilão no marketplace.

Formato

Formato do anúncio para o pacote de leilão.

Enums
DEAL_FORMAT_UNSPECIFIED Formato da transação não especificado. Entrada inválida.
DEAL_FORMAT_DISPLAY Mostrar formato.
DEAL_FORMAT_VIDEO Formato de vídeo.
DEAL_FORMAT_AUDIO Formato de áudio.

Métodos

create

 Cria um novo pacote de leilão.

get

 Recebe um pacote de leilão.

list

 Lista os pacotes de leilão.

patch

 Atualiza um pacote de leilão.
Faça upload do logotipo do pacote especificado.