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 世界协调时间（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)

仅限输出。可用性行的预算。
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.preventAvailabilityLine] 自定义方法设置为以下某项：

  • STATE_COMPLETED
  • STATE_REJECTED

。
rejection

object (Rejection)

可用性行的拒绝详情。
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"。

州

可用性订单项状态的可能值。

枚举
STATE_UNSPECIFIED 在此版本中，可用性订单项状态未指定或未知时的默认值。
STATE_PENDING 买方提供了库存状况请求设置时的“待售商品”状态。
STATE_COMPLETED 卖方提供库存状况响应时的“已完成”状态。
STATE_REJECTED 库存状况被卖方拒批时的拒绝状态。必须提供拒登详情。
STATE_CANCELLED 买家在卖家完成之前取消订单或拒绝库存状况响应时处于“已取消”状态。

方法

complete

 将现有可用性行标记为完成。

get

 检索可用性订单的单个行。

list

 列出可用性订单的行。

reject

 将现有可用性行标记为“已拒绝”。