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，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
createTime

string (Timestamp format)

仅限输出。创建时间戳。由系统分配。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

仅限输出。上次更新时间戳。由系统分配。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："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

 列出可用性订单。