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 de acceso

Parámetros
auctionPackage.name

string

Es el nombre de ruta relativo de este paquete de subasta. Debe tener el siguiente formato: "exchanges/{seller_id}/auctionpackages/{auction_package_id}. Ejemplo: "exchanges/1234/auctionPackage/5678". Solo salida.

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

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

enum (DiscoveryObjectStatus)

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

string

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

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

Desglose de las previsiones para el inventario de este paquete de subasta. Los anunciantes de DV3 pueden ver y filtrar estos desgloses. Opcional.
auctionPackage.externalDealId

string

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

string

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

Solo salida.
auctionPackage.floorPrice

object (Money)

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

string (Timestamp format)

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

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "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)

Es la hora en la que este producto se vuelve inactivo. Obligatorio.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "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)

Opcional. Grupos subrepresentados de los que el propietario es miembro, si corresponde
updateMask

string (FieldMask format)

La máscara para controlar qué campos se actualizarán. Obligatorio.

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

string

Solo salida. Vínculo de DV360 para el paquete de subasta en el mercado

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 alcance de OAuth:

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

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