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 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
createTime

string (Timestamp format)

出力専用。作成タイムスタンプ。システムによって割り当てられます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

出力専用。最終更新日時のタイムスタンプ。システムによって割り当てられます。

RFC3339 UTC「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

 在庫注文を一覧表示します。