Method: exchanges.orders.patch

Memperbarui pesanan.

Permintaan HTTP

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

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

      // 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
}
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, yang 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 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 exchange. Exchange yang menggunakan kesepakatan multi-seat diharapkan untuk terus mengisi dan memperbarui kolom ini.
order.updateTime

string (Timestamp format)

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

Menggunakan RFC 3339 yang outputnya 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)

Masker untuk mengontrol kolom mana 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.