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
  },
  "updateMask": string
}
Kolom
order.displayName

string

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

string (int64 format)

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

string

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

string

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

object (Budget)

Anggaran. Hanya berlaku untuk Skenario Transaksi Instan. Hanya output.
order.status

enum (OrderStatus)

Status pesanan. Status dapat berubah setelah pengguna DV3 menerima, membatalkan, atau mengarsipkan pesanan. Juga mendukung pembaruan ke 'CANCELLED' 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. Bursa yang menggunakan transaksi multi-kursi diharapkan untuk terus mengisi kolom ini dan memperbaruinya.
order.updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat pesanan atau produk pokoknya diperbarui.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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".
updateMask

string (FieldMask format)

Mask untuk mengontrol kolom yang akan diperbarui. Wajib.

Ini adalah daftar dipisahkan koma yang berisi nama-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.