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 del percorso

Parametri
product.name

string

Nome della route relativa per il 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
    },
    "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. Si tratta dell'ID deal nel sistema della piattaforma di scambio pubblicitario. Massimo 100 caratteri. I caratteri consentiti sono alfanumerici, trattini bassi, trattini e punti. Deve essere univoco in tutti i prodotti. Obbligatorio.
product.transactionType

enum (TransactionType)

Tipo di transazione del prodotto. Obbligatorio.
product.pricingType

enum (PricingType)

Tipo di prezzo del prodotto. Obbligatorio.
product.updateTime
(deprecated)

string (Timestamp format)

Il timestamp dell'ultimo aggiornamento del prodotto.

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

string (Timestamp format)

Data e ora in cui questo prodotto diventa inattivo. Al momento non può essere successiva al 2036. 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".
product.rateDetails

object (RateDetails)

Dettagli della tariffa. Obbligatorio.
product.creativeConfig[]

object (CreativeConfig)

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

boolean

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

object (MakegoodDetails)

I dettagli del rimedio per un prodotto. Obbligatorio quando il prodotto è un rimedio.
product.creativeSource

enum (CreativeSource)

Origine 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, per compatibilità con le versioni precedenti il valore predefinito è DIGITAL. Impossibile modificarlo dopo la creazione del prodotto.
product.audienceTargetingConfig

object (AudienceTargetingConfig)

Facoltativo. La configurazione del targeting per pubblico selezionata viene 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 dei prodotti. Obbligatorio quando i criteri di targeting non sono vuoti e la previsione non è 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 non è possibile fornire il risultato della previsione a causa di un criterio di targeting o non è possibile aggiornare il 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.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 i campi da 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 ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.