Method: exchanges.auctionPackages.patch

Atualiza um pacote de leilão.

Solicitação HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
auctionPackage.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.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
Campos
auctionPackage.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.
auctionPackage.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.
auctionPackage.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.
auctionPackage.format

enum (Format)

O tipo de formato de anúncio. Obrigatório. Não é possível fazer atualizações após a criação.
auctionPackage.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.
auctionPackage.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, sublinhados, hifens e pontos. Obrigatório. Obrigatório. Não permitir atualizações após a criação.
auctionPackage.logoUrl

string

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

Apenas saída.
auctionPackage.floorPrice

object (Money)

O preço mínimo desse pacote de leilão. Obrigatório.
auctionPackage.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".
auctionPackage.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".
auctionPackage.mediumType

enum (MediumType)

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

enum (UnderRepresentedGroup)

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

string (FieldMask format)

A máscara para controlar quais campos serão atualizados. Obrigatório.

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
auctionPackage.dv3MarketplaceUri

string

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

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de AuctionPackage.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Para mais informações, consulte OAuth 2.0 Overview.