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),

      // Union field budget can be only one of the following:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of list of possible types for union field budget.
    },
    "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, precedentemente 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 dell'editore. 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 segnalare che questo ordine è stato annullato su Exchange.
order.wseatConfig

object (WSeatConfig)

Facoltativo. WSeat Configuration Specifies the WSeat configuration on the exchange side. Gli scambi che utilizzano offerte multi-posto devono mantenere questo campo compilato e aggiornato.
order.updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento dell'ordine o dei relativi prodotti sottostanti.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC 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 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 Order.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la OAuth 2.0 Overview.