Method: exchanges.auctionPackages.patch

Actualiza un paquete de subasta.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
auctionPackage.name

string

Es el identificador. Es el nombre de la ruta relativa de este paquete de subasta. Debe tener el formato "exchanges/{seller_id}/auctionpackages/{auction_package_id}". Ejemplo: "exchanges/1234/auctionPackage/5678".

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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

Obligatorio. Es el nombre visible de este paquete de subasta. Debe estar codificado en UTF-8 con un tamaño máximo de 240 caracteres.
auctionPackage.status

enum (DiscoveryObjectStatus)

Obligatorio. Es el estado de este paquete de subasta. Los paquetes con el estado PAUSED o REMOVED no se muestran a los anunciantes de DV3.
auctionPackage.description

string

Obligatorio. Es el texto de descripción de este paquete. Debe estar codificado en UTF-8 con un tamaño máximo de 2,000 caracteres.
auctionPackage.format

enum (Format)

Obligatorio. Inmutable. Es el tipo de formato de anuncio subyacente. No se permiten actualizaciones después de la creación.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Es opcional. Es el desglose de la previsión del inventario de este paquete de subasta. Los anunciantes de DV3 pueden ver y filtrar estos desgloses.
auctionPackage.externalDealId

string

Obligatorio. Inmutable. Es el ID del acuerdo de Exchange que se usa en las solicitudes de oferta. Máx. de 100 caracteres. Los caracteres permitidos son alfanuméricos, guiones bajos, guiones y puntos. No se permiten actualizaciones después de la creación.
auctionPackage.logoUrl

string

Solo salida. Es la URL del logotipo de este paquete de subasta.
auctionPackage.floorPrice

object (Money)

Obligatorio. Es el precio mínimo de este paquete de subasta.
auctionPackage.startTime

string (Timestamp format)

Obligatorio. Es la hora en la que este producto se activa. Debe ser anterior a endTime. La hora de inicio no puede ser más de 1 año en el futuro.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
auctionPackage.endTime

string (Timestamp format)

Obligatorio. Es la hora en la que este producto se desactiva.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
auctionPackage.mediumType

enum (MediumType)

Obligatorio. Es el tipo de medio del paquete de subasta.
auctionPackage.urgOwners[]

enum (UnderRepresentedGroup)

Es opcional. Son los grupos subrepresentados de los que el propietario es miembro, si corresponde.
updateMask

string (FieldMask format)

Es opcional. Es la máscara para controlar qué campos se actualizarán.

Esta es una lista separada por comas de los nombres de campos completamente calificados. Ejemplo: "user.displayName,photo".
auctionPackage.dv3MarketplaceUri

string

Solo salida. Es el vínculo de DV360 para el paquete de subasta en el marketplace.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de AuctionPackage.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.