REST Resource: orders.lines

资源：行

表示已配置商品的单个订单行。

JSON 表示法 
{
  "name": string,
  "product": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "lineState": enum (LineState),
  "rejection": {
    object (Rejection)
  },
  "startTime": string,
  "endTime": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "budget": {
    object (Money)
  },
  "lineTerms": {
    object (LineTerms)
  },
  "pendingReservationExpirationTime": string,
  "reservationExpirationTime": string,
  "targeting": {
    object (Targeting)
  },
  "createTime": string,
  "updateTime": string
}
字段
name

string

仅限输出。该行的资源名称，格式为：orders/{order_id}/lines/{id}。
product

string

仅限输出。此行要配置的 Product 的名称。格式 = products/123
externalId

string

可选。用于将此实体映射到外部来源的 ID。
displayName

string

仅限输出。线条的显示名称。
description

string

仅限输出。用于描述线条的额外自由格式字段。
lineState

enum (LineState)

仅限输出。线条的状态。如需了解 Line 的生命周期，请参阅 LineState。

卖方可以使用以下自定义方法（Reserve、Book 和 Reject）将其设置为以下项之一：

  • LINE_STATE_RESERVED
  • LINE_STATE_BOOKED
  • LINE_STATE_REJECTED_BY_SELLER。

所有其他订单项状态均由买方设置。
rejection

object (Rejection)

可选。订单项拒绝详情。
startTime
(deprecated)

string (Timestamp format)

仅限输出。订单项开始投放的时间（含边界值）。

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

string (Timestamp format)

仅限输出。订单项停止投放的时间（不含边界值）。

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

object (Date)

仅限输出。开始投放订单项的日期（含边界值）。时区与广告单元相同。
endDate

object (Date)

仅限输出。订单项停止投放的日期（含此日期）。时区与广告单元相同。
budget

object (Money)

仅限输出。订单项的预算。
lineTerms

object (LineTerms)

仅限输出。卖方对此订单项的保证条款。
pendingReservationExpirationTime

string (Timestamp format)

仅限输出。待处理预留的到期时间戳。卖方需要在待处理的预留到期之前进行预订或拒绝，否则将被视为被拒。

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

string (Timestamp format)

仅限输出。预留的到期时间戳。买方需要在预订到期之前预订，否则将被视为已取消。

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

object (Targeting)

仅限输出。相应订单项的定位条件。
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"。

LineState

线条的状态。

枚举
LINE_STATE_UNSPECIFIED 此版本中未指定或未知的线条状态时的默认值。
LINE_STATE_PENDING_RESERVATION 该订单项已由买方创建，并请求预订产品及更新定价和库存状况信息。
LINE_STATE_RESERVED 该行已被卖方预留。只有在先前状态为待预留时，才会出现此状态。
LINE_STATE_PENDING_BOOKING 买方已接受预订，并请求预订相应订单项。
LINE_STATE_BOOKED 卖家已预订该线路。仅当先前状态正在等待预订时，才可能出现此状态。在此阶段，不太可能会遭拒。
LINE_STATE_REJECTED_BY_SELLER 卖方拒绝了这条线路。只有在先前状态为待预留时，才会出现此状态。
LINE_STATE_CANCELLED_BY_BUYER 该线路已被买方取消。
LINE_STATE_PENDING_RESERVATION_EXPIRED 此行在等待预订时已过期。
LINE_STATE_RESERVED_EXPIRED 该行在预订时已过期，正在等待买方回复。

方法

book

 预订现有线路。

get

 检索订单的单个行。

list

 列出订单的行。

patch

 更新现有线条。

reject

 拒绝现有线路。

reserve

 预留现有线路。