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

Identificador. Nome da rota relativa para esse pacote de leilão. Precisa estar no formato: "exchanges/{seller_id}/auctionpackages/{auction_package_id} Exemplo: "exchanges/1234/auctionPackage/5678".

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

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.
auctionPackage.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.
auctionPackage.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.
auctionPackage.format

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

Opcional. Detalhamento de estimativa do inventário desse pacote de leilão. Os anunciantes do DV3 podem conferir e filtrar esses detalhes.
auctionPackage.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. Não é possível fazer atualizações após a criação.
auctionPackage.logoUrl

string

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

object (Money)

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

string (Timestamp format)

Obrigatório. Horário em que esse produto fica ativo. Precisa ser anterior ao 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".
auctionPackage.endTime

string (Timestamp format)

Obrigatório. Horário em que esse 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".
auctionPackage.mediumType

enum (MediumType)

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

enum (UnderRepresentedGroup)

Opcional. Grupos sub-representados de que o proprietário faz parte, se houver.
updateMask

string (FieldMask format)

Opcional. A máscara para controlar quais campos atualizar.

É 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.