Method: sellers.orders.lines.reserve

保留現有的路線。

  • 如果成功，則傳回更新後的行。
  • 如果行不存在，則傳回錯誤代碼 NOT_FOUND。
  • 如未設定 lineTerms，則傳回錯誤代碼 INVALID_ARGUMENT。
  • 如果狀態不是 STATE_PENDING_RESERVATION，則傳回錯誤代碼 FAILED_PRECONDITION。

HTTP 要求

POST https://dv360outofhomeseller.googleapis.com/v1/{name=sellers/*/orders/*/lines/*}:reserve

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

路徑參數

參數
name

string

必要欄位。欄位會包含要預訂的行號名稱，例如：「sellers/789/orders/123/lines/321」

要求主體

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

JSON 表示法 
{
  "lineTerms": {
    object (LineTerms)
  },
  "reservationExpirationTime": string
}
欄位
lineTerms

object (LineTerms)

必要欄位。這行的賣方保證條款。
reservationExpirationTime

string (Timestamp format)

必要欄位。預留項目的到期日時間戳記。買家必須在預訂到期前預訂。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

回應主體

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。