REST Resource: exchanges.orders

資源：Order

買方可接受的不可協商方案。

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)
  }
}
欄位
name

string

訂單的相對資源名稱。由伺服器產生。例如：「exchanges/1234/orders/5678」。僅供輸出。
displayName

string

向買家顯示的訂單名稱。最多 250 個字元。選填。
partnerId[]

string (int64 format)

Google Display & Video 360 中的合作夥伴 ID，舊稱 Doubleclick Bid Manager(DBM)。僅允許單一合作夥伴 ID。必填。
publisherEmail

string

發布商的電子郵件地址。須以有效的格式提供電子郵件地址。最多 250 個字元。選填。
publisherName

string

發布者名稱。最多 250 個字元。必填。
budget

object (Budget)

僅供輸出。買方設定的預算。僅適用於即時交易情境。
status

enum (OrderStatus)

訂單狀態。DV3 使用者接受、取消或封存訂單後，狀態可能會變更。此外，API 也支援在建立訂單後更新為「已取消」，表示這筆訂單已在交易所取消。
wseatConfig

object (WSeatConfig)

(選用步驟) WSeat Configuration：指定交易所的 WSeat 設定。使用多席交易的交易所應持續填寫並更新這個欄位。
updateTime

string (Timestamp format)

僅供輸出。訂單或其基礎產品的更新時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
buyerInfo

object (BuyerInfo)

僅供輸出。買方資訊，包括合作夥伴和廣告主詳細資料。僅適用於即時交易情境。

預算

已指定預算。

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.
}
欄位
budgetType

enum (BudgetType)

指定的預算類型。
聯集欄位 budget。只能包含一種預算。budget 只能是下列其中一項：
impressions

string (int64 format)

曝光次數預算。
money

object (Money)

貨幣預算。

BudgetType

預算類型

列舉
BUDGET_TYPE_UNSPECIFIED 未指定預算。輸入的內容無效。
BUDGET_TYPE_CURRENCY 貨幣預算。
BUDGET_TYPE_IMPRESSION 曝光次數預算。

OrderStatus

訂單狀態。

列舉
ORDER_STATUS_UNSPECIFIED 未指定訂單狀態。Unexpected：表示協商狀態不明。輸入值無效。
PENDING_ACCEPTANCE 訂單狀態為待接受。
ACCEPTED 訂單狀態為「已接受」。
ARCHIVED 訂單狀態已封存。
CANCELLED 訂單狀態已取消。
NEGOTIATING 訂單狀態為「協議中」。僅適用於即時交易情境。

WSeatConfig

WSeat 設定。

JSON 表示法 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
欄位
exchangeWseatStatus

enum (WSeatStatus)

(選用步驟) Exchange 端 WSeat 設定的目前狀態。
exchangeWseatIds[]

string (int64 format)

(選用步驟) 廣告交易平台端的 WSeat ID。
updateTime

string (Timestamp format)

僅供輸出。當交易平台更新 WSeatConfiguration 時，DV3 會自動更新這個欄位。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

WSeatStatus

WSeat Status 列舉選項。

列舉
W_SEAT_STATUS_UNSPECIFIED WSeatStatus 未指定。
W_SEAT_STATUS_ENFORCED 強制執行 WSeatStatus。指出 Exchange 是否會透過將 WSeatId 傳送至 DV3，或驗證出價回應中的 wseatid 來強制執行 WSeatId。
W_SEAT_STATUS_NOT_ENFORCED WSeatStatus 未強制執行。表示廣告交易平台不會在出價要求中傳送 wseatid，也不會驗證出價要求中的 wseatid。

BuyerInfo

即時交易情境的買方資訊。

JSON 表示法 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
欄位
partner

object (PartnerInfo)

僅供輸出。合作夥伴資訊。
advertisers[]

object (AdvertiserInfo)

僅供輸出。廣告主資訊。

PartnerInfo

即時交易情境的合作夥伴資訊。

JSON 表示法 
{
  "title": string
}
欄位
title

string

僅供輸出。Display & Video 360 中的合作夥伴顯示名稱。

AdvertiserInfo

即時交易情境的廣告主資訊。

JSON 表示法 
{
  "advertiserId": string,
  "domainUri": string
}
欄位
advertiserId

string (int64 format)

僅供輸出。Display & Video 360 中的廣告主 ID。
domainUri

string

僅供輸出。廣告主網站的網域 URI。

方法

accept

 接受訂單。

create

 建立訂單。

get

 取得訂單。

list

 列出訂單。

patch

 更新訂單。