Method: exchanges.orders.patch

Aggiorna un ordine.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
order.name

string

Nome della risorsa relativa per l'ordine. Generato dal server. Esempio: "exchanges/1234/orders/5678". Solo output.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "budgetType": enum (BudgetType),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "status": enum (OrderStatus),
    "wseatConfig": {
      "exchangeWseatStatus": enum (WSeatStatus),
      "exchangeWseatIds": [
        string
      ],
      "updateTime": string
    },
    "updateTime": string,
    "buyerInfo": {
      "partner": {
        object (PartnerInfo)
      },
      "advertisers": [
        {
          object (AdvertiserInfo)
        }
      ]
    }
  },
  "updateMask": string
}
Campi
order.displayName

string

Nome dell'ordine visualizzato dall'acquirente. Massimo 250 caratteri. Facoltativo.
order.partnerId[]

string (int64 format)

ID partner in Google Display &Video 360, in precedenza noto come DoubleClick Bid Manager(DBM). Consente un solo ID partner. Obbligatorio.
order.publisherEmail

string

Email per il publisher. Deve essere un formato email valido. Massimo 250 caratteri. Facoltativo.
order.publisherName

string

Nome del publisher. Massimo 250 caratteri. Obbligatorio.
order.budget

object (Budget)

Solo output. Il budget impostato dall'acquirente. Applicabile solo agli scenari di offerta immediata.
order.status

enum (OrderStatus)

Stato dell'ordine. Lo stato può cambiare dopo che gli utenti di DV3 accettano, annullano o archiviano un ordine. Supporta anche l'aggiornamento a "ANNULLATO" dopo la creazione nell'API per indicare che l'ordine è stato annullato su Exchange.
order.wseatConfig

object (WSeatConfig)

Facoltativo. Configurazione WSeat Specifica la configurazione WSeat sul lato Exchange. Si prevede che gli Exchange che utilizzano offerte multi-seat mantengano questo campo compilato e aggiornato.
order.updateTime

string (Timestamp format)

Solo output. Il timestamp dell'ultimo aggiornamento dell'ordine o dei prodotti sottostanti.

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".
order.buyerInfo

object (BuyerInfo)

Solo output. Le informazioni sull'acquirente, inclusi i dettagli del partner e dell'inserzionista. Applicabile solo agli scenari di offerta immediata.
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 Order.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

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