REST Resource: availabilityOrders.availabilityLines

資源：AvailabilityLine

供應量行代表一組設定，可讓買方請求廣告空間供應量以及賣方回應。如要瞭解工作流程，請參閱 AvailabilityOrder。

JSON 表示法 
{
  "name": string,
  "product": string,
  "startTime": string,
  "endTime": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "budget": {
    object (Money)
  },
  "targeting": {
    object (Targeting)
  },
  "availabilityLineTerms": {
    object (LineTerms)
  },
  "state": enum (State),
  "rejection": {
    object (Rejection)
  },
  "createTime": string,
  "updateTime": string
}
欄位
name

string

僅供輸出。可用性行的資源名稱，格式如下：availabilityOrders/123/availabilityLines/321。
product

string

僅供輸出。這項可用性要求的目標 Product 名稱。格式 = products/456
startTime
(deprecated)

string (Timestamp format)

僅供輸出。要求提供供應情形的開始時間 (含)。

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

string (Timestamp format)

僅供輸出。要求供應情形的結束時間 (不含)。

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

object (Date)

僅供輸出。要求供應情形的開始日期 (含)。與廣告單元採用相同的時區。
endDate

object (Date)

僅供輸出。要求供應情形的結束日期 (含此日期)。與廣告單元採用相同的時區。
budget

object (Money)

僅供輸出。供應量的預算。
targeting

object (Targeting)

僅供輸出。請求供應情況的指定目標。
availabilityLineTerms

object (LineTerms)

僅供輸出。賣方可以使用 [Complete][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine] 更新 [LineTerms]。
state

enum (State)

僅供輸出。這個供應情形順序的狀態。如要瞭解 availabilityLine 的生命週期，請參閱 AvailabilityLine.State。

賣方可以使用 [Complete][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine] 或 [拒絕][google.ads.xbid.outofhome.v1beta1.OrderManagementService.DismissAvailabilityLine] 自訂方法來設為下列其中一個選項：

  • STATE_COMPLETED
  • STATE_REJECTED

。
rejection

object (Rejection)

供應情形專線的拒絕詳細資料。
createTime

string (Timestamp format)

僅供輸出。可用性行的建立時間戳記。

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

string (Timestamp format)

僅供輸出。供應情形行的上次更新時間戳記。

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

州

供應線狀態的可能值。

列舉
STATE_UNSPECIFIED 此預設值尚未指定供應量行狀態，或此版本不明時的預設值。
STATE_PENDING 買方提供供應量請求設定時，供應中狀態仍為待處理。
STATE_COMPLETED 賣方提供供應情形回應時的已完成狀態。
STATE_REJECTED 賣方拒絕供應供應情形資訊的拒絕狀態。必須提供拒登詳情。
STATE_CANCELLED 買家在賣家完成或拒絕供應情形回應前取消訂單的狀態已取消。

方法

complete

 將現有的供應情形標示為已完成。

get

 擷取可用性訂單的個別行。

list

 列出可用性訂單的資料。

reject

 將現有的供應情形標示為已遭拒。