Method: exchanges.orders.patch

Memperbarui pesanan.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
order.name

string

Nama resource relatif untuk pesanan. Dibuat oleh server. Contoh: "exchanges/1234/orders/5678". Hanya Output.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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
}
Kolom
order.displayName

string

Nama pesanan yang ditampilkan kepada pembeli. Maks. 250 karakter. Opsional.
order.partnerId[]

string (int64 format)

ID Partner di Google Display & Video 360, sebelumnya dikenal sebagai DoubleClick Bid Manager(DBM). Hanya mengizinkan satu ID partner. Wajib.
order.publisherEmail

string

Email untuk penayang. Harus berupa format email yang valid. Maks. 250 karakter. Opsional.
order.publisherName

string

Nama penayang. Maks. 250 karakter. Wajib.
order.budget

object (Budget)

Hanya output. Anggaran yang ditetapkan oleh pembeli. Hanya berlaku untuk skenario Kesepakatan Instan.
order.status

enum (OrderStatus)

Status pesanan. Status dapat berubah setelah pengguna DV3 menerima, membatalkan, atau mengarsipkan pesanan. Juga mendukung update ke 'DIBATALKAN' setelah pembuatan di API untuk menandakan bahwa pesanan ini telah dibatalkan di Exchange.
order.wseatConfig

object (WSeatConfig)

Opsional. Konfigurasi WSeat Menentukan konfigurasi WSeat di sisi bursa. Exchange yang menggunakan penawaran multi-tempat duduk diharapkan mengisi dan memperbarui kolom ini.
order.updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat pesanan atau produk yang mendasarinya diperbarui.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
order.buyerInfo

object (BuyerInfo)

Hanya output. Informasi pembeli, termasuk detail partner dan pengiklan. Hanya berlaku untuk skenario Kesepakatan Instan.
updateMask

string (FieldMask format)

Mask untuk mengontrol kolom yang akan diperbarui. Wajib.

Ini adalah comma-separated list berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".

Isi respons

Jika berhasil, isi respons memuat instance Order.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.