Method: exchanges.orders.patch

更新訂單。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
order.name

string

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

要求主體

要求主體的資料會採用以下結構：

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

string

向買方顯示的訂單名稱。最多 250 個半形字元。選填。
order.partnerId[]

string (int64 format)

Google Display & Video 360(舊稱 DoubleClick Bid Manager，簡稱 DBM) 中的合作夥伴 ID。必填。
order.publisherEmail

string

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

string

發布商名稱。最多 250 個半形字元。必填。
order.budget

object (Budget)

預算。僅適用於即時交易情境。僅供輸出。
order.status

enum (OrderStatus)

訂單狀態。DV3 使用者接受、取消或封存訂單後，狀態可能會變更。在 API 中建立後，也支援更新為「CANCELLED」，以表示這筆訂單已在 Exchange 中取消。
order.wseatConfig

object (WSeatConfig)

(非必要) WSeat 設定：指定交換端的 WSeat 設定。使用多座位交易的廣告交易平台應會持續填入及更新這個欄位。
order.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"。
updateMask

string (FieldMask format)

用於控制要更新哪些欄位的遮罩。必填。

這是以半形逗號分隔的完整欄位名稱清單。範例："user.displayName,photo"。

回應主體

如果成功，回應主體會包含 Order 的執行例項。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 Overview。