Method: exchanges.orders.products.patch

Aggiorna un prodotto.

Richiesta HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{product.name=exchanges/*/orders/*/products/*}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di percorso

Parametri
product.name

string

Nome della risorsa relativo al prodotto. Generato dal server. Esempio: "exchanges/1234/orders/5678/products/abc". Solo output.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "product": {
    "name": string,
    "displayName": string,
    "externalDealId": string,
    "transactionType": enum (TransactionType),
    "pricingType": enum (PricingType),
    "updateTime": string,
    "startTime": string,
    "endTime": string,
    "rateDetails": {
      "rateType": enum (RateType),
      "rate": {
        object (Money)
      },
      "unitsPurchasedCount": string
    },
    "creativeConfig": [
      {
        "creativeType": enum (CreativeType),
        "dimensionCreativeConfig": {
          object (DimensionCreativeConfig)
        },
        "durationCreativeConfig": {
          object (DurationCreativeConfig)
        }
      }
    ],
    "makegood": boolean,
    "makegoodDetails": {
      "originalExternalDealId": string,
      "reason": string
    },
    "creativeSource": enum (CreativeSource),
    "mediumType": enum (MediumType),
    "audienceTargetingConfig": {
      "audienceType": enum (AudienceType)
    },
    "targetingCriteria": {
      "selectedTargetingOptions": [
        {
          object (SelectedTargetingOption)
        }
      ]
    },
    "forecastResult": {
      "forecasts": [
        {
          object (Forecast)
        }
      ]
    },
    "errorDetails": {
      "message": string,
      "instantDealErrorStatus": enum (InstantDealErrorStatus)
    },
    "frequencyCap": {
      "timeUnit": enum (TimeUnit),
      "maxImpressions": string
    },
    "program": string,
    "buyerCustomParameters": {
      string: string,
      ...
    },
    "etag": string
  },
  "updateMask": string
}
Campi
product.displayName

string

Il nome visualizzato del prodotto.

Deve essere codificato in UTF-8 con una dimensione massima di 240 byte. Obbligatorio.
product.externalDealId

string

ID esterno. Questo è l'ID deal nel sistema della piattaforma di scambio pubblicitario. Massimo 100 caratteri. I caratteri consentiti sono alfanumerici, trattino basso, trattino e punto. Deve essere univoco per tutti i prodotti. Obbligatorio.
product.transactionType

enum (TransactionType)

Tipo di transazione del prodotto. Obbligatorio.
product.pricingType

enum (PricingType)

Tipo di prezzo per il prodotto. Obbligatorio.
product.updateTime
(deprecated)

string (Timestamp format)

Il timestamp dell'ultimo aggiornamento del prodotto.

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".
product.startTime

string (Timestamp format)

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

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".
product.endTime

string (Timestamp format)

Il momento in cui questo prodotto diventa inattivo. Non può essere successiva all'anno 2036. Obbligatorio.

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".
product.rateDetails

object (RateDetails)

Dettagli tariffa. Obbligatorio.
product.creativeConfig[]

object (CreativeConfig)

I requisiti delle creatività per un prodotto. Obbligatorio per il prodotto di tipo di transazione prenotata.
product.makegood
(deprecated)

boolean

Indica se un prodotto è un prodotto di compensazione.
product.makegoodDetails
(deprecated)

object (MakegoodDetails)

I dettagli dell'elemento pubblicitario di recupero per un prodotto. Obbligatorio quando il prodotto è un makegood.
product.creativeSource

enum (CreativeSource)

Origine della creatività per un prodotto. Facoltativo, il valore predefinito è CREATIVE_SOURCE_ADVERTISER. Impossibile modificarlo dopo la creazione del prodotto.
product.mediumType

enum (MediumType)

Tipo di supporto per un prodotto. Se non specificato, il valore predefinito è DIGITAL per la compatibilità con le versioni precedenti. Impossibile modificarlo dopo la creazione del prodotto.
product.audienceTargetingConfig

object (AudienceTargetingConfig)

Facoltativo. Configurazione del targeting per pubblico applicata a livello di deal sulla piattaforma di scambio pubblicitario.
product.targetingCriteria

object (TargetingCriteria)

Solo output. Riferimenti ai criteri di targeting per prodotto. Applicabile solo agli scenari di deal istantanei.
product.forecastResult

object (ForecastResult)

Risultati della previsione del prodotto. Obbligatorio quando i criteri di targeting non sono vuoti e la previsione non viene fornita. Applicabile solo agli scenari di deal istantanei.
product.errorDetails

object (ErrorDetails)

I dettagli dell'errore devono essere specificati quando non è possibile aggiornare campi di prodotti specifici. Obbligatorio quando il risultato della previsione non può essere fornito a causa di un criterio di targeting o non è possibile apportare un aggiornamento al prodotto. Applicabile solo agli scenari di deal istantanei.
product.frequencyCap

object (FrequencyCap)

Solo output. Quota limite selezionata dall'acquirente. Applicabile solo agli scenari di deal istantanei.
product.program

string

Solo output. Il programma nell'ambito del quale l'acquirente ha creato il deal istantaneo. Vuoto per il flusso regolare dello scambio. Applicabile solo agli scenari di deal istantanei.
product.buyerCustomParameters

map (key: string, value: string)

Solo output. Parametri chiave/valore personalizzati impostati dall'acquirente nella richiesta di deal istantaneo. Applicabile solo agli scenari di deal istantanei.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
product.etag

string

Un etag che deve essere specificato durante l'aggiornamento di un prodotto. Deve essere specificato per un aggiornamento solo se il campo etag non è vuoto. Applicabile solo agli scenari di deal istantanei.
updateMask

string (FieldMask format)

La maschera per controllare quali campi aggiornare. Obbligatorio.

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

Corpo della risposta

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.