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

Identificatore. 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".

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

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

enum (DiscoveryObjectStatus)

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

string

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

enum (Format)

Obbligatorio. Immutabile. Il tipo di formato dell'annuncio sottostante. Gli aggiornamenti non sono consentiti dopo la creazione.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Facoltativo. Suddivisione delle previsioni per l'inventario di questo pacchetto di aste. Gli inserzionisti di DV3 possono visualizzare e filtrare queste suddivisioni.
auctionPackage.externalDealId

string

Obbligatorio. Immutabile. L'ID del deal della piattaforma di scambio utilizzato nelle richieste di offerta. Massimo 100 caratteri. I caratteri consentiti sono alfanumerici, trattino basso, trattino e punto. Gli aggiornamenti non sono consentiti dopo la creazione.
auctionPackage.logoUrl

string

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

object (Money)

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

string (Timestamp format)

Obbligatorio. L'ora in cui questo prodotto diventa attivo. Deve essere precedente a endTime. L'ora di inizio non può essere più di un anno nel futuro.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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)

Obbligatorio. L'ora in cui questo prodotto diventa inattivo.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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. Il tipo di supporto del pacchetto di aste.
auctionPackage.urgOwners[]

enum (UnderRepresentedGroup)

Facoltativo. I gruppi sottorappresentati di cui il proprietario è membro, se presenti.
updateMask

string (FieldMask format)

Facoltativo. La maschera per controllare i campi da aggiornare.

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

string

Solo output. Link di 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 saperne di più, consulta la OAuth 2.0 Overview.