REST Resource: availabilityOrders

資源：AvailabilityOrder

供應情形訂單包含一組 AvailabilityLines。供應量訂單是由買方建立。賣方會在回應中更新供應情形。

工作流程如下：

  • 買方建立供應情形訂單和行，並將狀態設為待處理。買方無法進一步變更供應量訂單或委刊項。
  • 賣方在可預訂時段處理所有營業項目，是填寫可用性條款或標示為已遭拒。只有在訂單和委刊項處於待處理狀態時，您才能執行這項操作。
  • 賣方使用 complete 自訂動作，將供應情形要求標示為已完成。供應情形順序或子行完成後，即無法進一步變更。
JSON 表示法 
{
  "name": string,
  "description": string,
  "state": enum (State),
  "pendingExpirationTime": string,
  "createTime": string,
  "updateTime": string,
  "advertiserInfo": {
    object (AdvertiserInfo)
  }
}
欄位
name

string

僅供輸出。供應情形順序的資源名稱，格式為：availabilityOrders/{id}。
description

string

僅供輸出。額外的任意形式欄位，用於說明供應情形順序。
state

enum (State)

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

賣方可以使用 Complete 自訂方法設為 STATE_COMPLETED。
pendingExpirationTime

string (Timestamp format)

僅供輸出。待處理可用性訂單的到期時間戳記。待處理的供應情形訂單必須於期限內完成，否則系統會將訂單視為已完成，沒有供應情形。

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

object (AdvertiserInfo)

僅供輸出。廣告客戶資訊。

州

供應情形訂單狀態的可能值。

列舉
STATE_UNSPECIFIED 此預設值中，尚未指定供應情形訂單狀態，或這個版本不明時的預設值。
STATE_PENDING 買方提供供應量請求設定時，供應中狀態仍為待處理。
STATE_COMPLETED 賣方提供所有路線的供應情形回應時，已完成的供應狀態狀態。
STATE_CANCELLED 買方在賣方提供所有行的供應情形回應之前提供取消要求，此時的供應情形已取消。
STATE_EXPIRED 在賣家完成訂單前，供應情形過期。

方法

complete

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

get

 擷取個別可用性順序。

list

 列出供應情形訂單。