REST Resource: exchanges.auctionPackages

Recurso: AuctionPackage

Encapsula um único pacote de leilão. Os anunciantes no DV3 podem navegar por todos os pacotes de leilão no DV3 pela interface de descoberta do marketplace e aceitar 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

Identificador. Nome do caminho relativo para esse 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

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

Obrigatório. O status desse pacote de leilão. Pacotes com status PAUSED ou REMOVED não são mostrados aos anunciantes do DV3. Obrigatório.
description

string

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

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

Opcional. Detalhamento da estimativa do inventário desse pacote de leilão. Os anunciantes do DV3 podem conferir e filtrar esses detalhes. Opcional.
externalDealId

string

Obrigatório. Imutável. O ID da transação de troca usado em 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 é possível fazer atualizações após a criação.
logoUrl

string

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

Apenas saída.
floorPrice

object (Money)

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

string (Timestamp format)

Obrigatório. Horário em que esse produto é ativado. Precisa ser anterior ao endTime. O horário de início não pode ser mais de um ano no futuro. Obrigatório.

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)

Obrigatório. Horário em que esse produto é desativado. Obrigatório.

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

enum (MediumType)

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

enum (UnderRepresentedGroup)

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

string

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

Formato

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

Tipos enumerados
DEAL_FORMAT_UNSPECIFIED Formato de transação não especificado. Não é válido para entrada.
DEAL_FORMAT_DISPLAY Formato de display.
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 pacotes de leilão.

patch

 Atualiza um pacote de leilão.
Faz o upload do logotipo para o pacote especificado.