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,
    "buyerInfo": {
      "partner": {
        object (PartnerInfo)
      },
      "advertisers": [
        {
          object (AdvertiserInfo)
        }
      ]
    }
  },
  "updateMask": string
}
欄位
order.displayName

string

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

string (int64 format)

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

string

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

string

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

object (Budget)

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

enum (OrderStatus)

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

object (WSeatConfig)

(選用步驟) WSeat Configuration：指定交易所的 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"。
order.buyerInfo

object (BuyerInfo)

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

string (FieldMask format)

遮罩用於控管要更新的欄位。必填。

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

回應主體

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。