REST Resource: exchanges.orders

Resource: Order

Penawaran yang tidak dapat dinegosiasikan untuk disetujui pembeli.

Representasi JSON 
{
  "name": string,
  "displayName": string,
  "partnerId": [
    string
  ],
  "publisherEmail": string,
  "publisherName": string,
  "budget": {
    object (Budget)
  },
  "status": enum (OrderStatus),
  "wseatConfig": {
    object (WSeatConfig)
  },
  "updateTime": string,
  "buyerInfo": {
    object (BuyerInfo)
  }
}
Kolom
name

string

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

string

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

string (int64 format)

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

string

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

string

Nama penayang. Maks. 250 karakter. Wajib.
budget

object (Budget)

Hanya output. Anggaran yang ditetapkan oleh pembeli. Hanya berlaku untuk skenario Kesepakatan Instan.
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.
wseatConfig

object (WSeatConfig)

Opsional. Konfigurasi WSeat Menentukan konfigurasi WSeat di sisi bursa. Exchange yang memanfaatkan penawaran multi-tempat duduk diharapkan mengisi kolom ini dan memperbaruinya.
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".
buyerInfo

object (BuyerInfo)

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

Anggaran

Anggaran ditentukan.

Representasi JSON 
{
  "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.
}
Kolom
budgetType

enum (BudgetType)

Jenis anggaran yang ditentukan.
Kolom union budget. Hanya satu jenis anggaran yang dapat disertakan. budget hanya dapat berupa salah satu dari berikut:
impressions

string (int64 format)

Anggaran tayangan iklan.
money

object (Money)

Anggaran mata uang.

BudgetType

Jenis anggaran

Enum
BUDGET_TYPE_UNSPECIFIED Anggaran tidak ditentukan. Tidak valid untuk input.
BUDGET_TYPE_CURRENCY Anggaran mata uang.
BUDGET_TYPE_IMPRESSION Anggaran tayangan iklan.

OrderStatus

Status pesanan.

Enum
ORDER_STATUS_UNSPECIFIED Status pesanan tidak ditentukan. Tidak terduga, menunjukkan bahwa status negosiasi tidak diketahui. Nilai input tidak valid.
PENDING_ACCEPTANCE Status pesanan menunggu persetujuan.
ACCEPTED Status pesanan diterima.
ARCHIVED Status pesanan diarsipkan.
CANCELLED Status pesanan dibatalkan.
NEGOTIATING Negosiasi status pesanan. Hanya berlaku untuk Skenario Kesepakatan Instan.

WSeatConfig

Konfigurasi WSeat.

Representasi JSON 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
Kolom
exchangeWseatStatus

enum (WSeatStatus)

Opsional. Status saat ini di sisi Exchange untuk konfigurasi WSeat.
exchangeWseatIds[]

string (int64 format)

Opsional. ID WSeat di sisi Exchange.
updateTime

string (Timestamp format)

Hanya output. Kolom ini diperbarui secara otomatis oleh DV3 saat WSeatConfiguration diperbarui oleh bursa.

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

WSeatStatus

Opsi enum Status WSeat.

Enum
W_SEAT_STATUS_UNSPECIFIED WSeatStatus tidak ditentukan.
W_SEAT_STATUS_ENFORCED WSeatStatus diterapkan. Menunjukkan bahwa Exchange menerapkan WSeatId dengan mengirimkan WSeatId ke DV3 atau memverifikasi wseatid dalam respons bid.
W_SEAT_STATUS_NOT_ENFORCED WSeatStatus tidak diterapkan. Menunjukkan bahwa Exchange tidak mengirim wseatid dalam permintaan bid dan tidak memvalidasi wseatid dalam permintaan bid.

BuyerInfo

Informasi pembeli untuk skenario Kesepakatan Instan.

Representasi JSON 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
Kolom
partner

object (PartnerInfo)

Hanya output. Informasi partner.
advertisers[]

object (AdvertiserInfo)

Hanya output. Informasi pengiklan.

PartnerInfo

Informasi partner untuk skenario Kesepakatan Instan.

Representasi JSON 
{
  "title": string
}
Kolom
title

string

Hanya output. Judul tampilan partner di Display & Video 360.

AdvertiserInfo

Informasi pengiklan untuk skenario Kesepakatan Instan.

Representasi JSON 
{
  "advertiserId": string,
  "domainUri": string
}
Kolom
advertiserId

string (int64 format)

Hanya output. ID pengiklan di Display & Video 360.
domainUri

string

Hanya output. URI domain situs pengiklan.

Metode

accept

 Menerima pesanan.

create

 Membuat pesanan.

get

 Mendapatkan pesanan.

list

 Urutan daftar.

patch

 Memperbarui pesanan.