Method: exchanges.auctionPackages.patch

Aggiorna un pacchetto di aste.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
auctionPackage.name

string

Nome del percorso relativo per questo pacchetto di aste. Deve essere nel formato: "exchanges/{seller_id}/auctionpackages/{auction_package_id} Esempio: "exchanges/1234/auctionPackage/5678". Solo output.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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
}
Campi
auctionPackage.displayName

string

Il nome visualizzato di questo pacchetto di aste. Deve essere codificato in UTF-8 con una dimensione massima di 240 caratteri. Obbligatorio.
auctionPackage.status

enum (DiscoveryObjectStatus)

Lo stato di questo pacchetto di aste. I pacchetti con stato PAUSATO o RIMOSSO non vengono mostrati agli inserzionisti DV3. Obbligatorio.
auctionPackage.description

string

Il testo descrittivo di questo pacchetto. Deve essere codificato in UTF-8 con una dimensione massima di 2000 caratteri. Obbligatorio.
auctionPackage.format

enum (Format)

Il tipo di formato dell'annuncio sottostante. Obbligatorio. Aggiornamenti non consentiti dopo la creazione.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Analisi dettagliata delle previsioni per l'inventario di questo pacchetto di aste. Gli inserzionisti DV3 possono visualizzare e filtrare i dati in base a queste suddivisioni. Facoltativo.
auctionPackage.externalDealId

string

L'ID deal della piattaforma di scambio utilizzato nelle richieste di offerta. Massimo 100 caratteri. I caratteri consentiti sono alfanumerici, trattini bassi, trattini e punti. Obbligatorio. Obbligatorio. Non consentire aggiornamenti dopo la creazione.
auctionPackage.logoUrl

string

Solo output. L'URL del logo di questo pacchetto di aste.

Solo output.
auctionPackage.floorPrice

object (Money)

Il prezzo minimo di questo pacchetto di aste. Obbligatorio.
auctionPackage.startTime

string (Timestamp format)

Data e ora in cui il prodotto diventa attivo. Deve essere precedente a endTime. L'ora di inizio non può essere più lontana di 1 anno nel futuro. Obbligatorio.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
auctionPackage.endTime

string (Timestamp format)

Data e ora in cui questo prodotto diventa inattivo. Obbligatorio.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
auctionPackage.mediumType

enum (MediumType)

Obbligatorio. Tipo di media del pacchetto di aste.
auctionPackage.urgOwners[]

enum (UnderRepresentedGroup)

Facoltativo. Gruppi sottorappresentati di cui il proprietario fa parte, se presenti.
updateMask

string (FieldMask format)

La maschera per controllare i campi da aggiornare. Obbligatorio.

Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".
auctionPackage.dv3MarketplaceUri

string

Solo output. Link a DV360 per il pacchetto di aste nel marketplace.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di AuctionPackage.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.