REST Resource: orders.lines

Tài nguyên: Dòng

Một dòng đơn đặt hàng đại diện cho một sản phẩm đã thiết lập.

Biểu diễn dưới dạng 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
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của dòng ở định dạng: orders/{order_id}/lines/{id}.
product

string

Chỉ có đầu ra. Tên của Product dòng này đang định cấu hình. Định dạng = products/123
externalId

string

Không bắt buộc. Mã nhận dạng dùng để liên kết thực thể này với các nguồn bên ngoài.
displayName

string

Chỉ có đầu ra. Tên hiển thị của dòng.
description

string

Chỉ có đầu ra. Trường dạng tự do bổ sung để mô tả đường.
lineState

enum (LineState)

Chỉ có đầu ra. Trạng thái của đường kẻ. Hãy xem LineState để biết vòng đời của một Đường.

Người bán có thể sử dụng các phương thức tuỳ chỉnh sau: Reserve, Book và Reject để đặt thành một trong các phương thức sau:

  • LINE_STATE_RESERVED
  • LINE_STATE_BOOKED
  • LINE_STATE_REJECTED_BY_SELLER.

Tất cả các trạng thái đường kẻ khác do người mua đặt.
rejection

object (Rejection)

Không bắt buộc. Chi tiết về việc từ chối cho đường này.
startTime
(deprecated)

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tuyến này bắt đầu được phân phát (bao gồm cả ngày này).

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
endTime
(deprecated)

string (Timestamp format)

Chỉ có đầu ra. Thời điểm đường dây này ngừng phân phát (độc quyền).

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
startDate

object (Date)

Chỉ có đầu ra. Ngày mà tuyến bắt đầu được phân phát (bao gồm cả ngày đó). Cùng múi giờ với đơn vị quảng cáo.
endDate

object (Date)

Chỉ có đầu ra. Ngày mà tuyến này sẽ ngừng được phân phát (bao gồm cả ngày đó). Cùng múi giờ với đơn vị quảng cáo.
budget

object (Money)

Chỉ có đầu ra. Ngân sách của đường dây.
lineTerms

object (LineTerms)

Chỉ có đầu ra. Các điều khoản được đảm bảo của người bán cho dòng này.
pendingReservationExpirationTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian hết hạn của yêu cầu đặt chỗ đang chờ xử lý. Người bán cần phải đặt trước hoặc từ chối trước khi yêu cầu đặt trước đang chờ xử lý hết hạn, nếu không yêu cầu đặt trước đó sẽ bị coi là bị từ chối.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
reservationExpirationTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian hết hạn của giao dịch đặt chỗ. Người mua cần phải đặt trước trước khi đặt trước hết hạn, nếu không đặt trước sẽ được coi là đã huỷ.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
targeting

object (Targeting)

Chỉ có đầu ra. Tiêu chí nhắm mục tiêu cho đường kẻ.
createTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian tạo cho dòng.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của lần cập nhật gần đây nhất cho dòng.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

LineState

Trạng thái của một đường.

Enum
LINE_STATE_UNSPECIFIED Giá trị mặc định khi trạng thái đường kẻ chưa được chỉ định hoặc không xác định trong phiên bản này.
LINE_STATE_PENDING_RESERVATION Đường dây này do người mua tạo và yêu cầu đặt trước cũng như cập nhật thông tin về giá và tình trạng còn hàng.
LINE_STATE_RESERVED Đường dây này đã được người bán đặt trước. Trạng thái này chỉ có thể xảy ra nếu trạng thái trước đó là trạng thái đang chờ đặt trước.
LINE_STATE_PENDING_BOOKING Người mua đã chấp nhận yêu cầu đặt trước và đang yêu cầu đặt trước hàng.
LINE_STATE_BOOKED Người bán đã đặt trước tuyến đường này. Trạng thái này chỉ có thể xuất hiện nếu trạng thái trước đó là đang chờ đặt phòng. Dự kiến bị từ chối ở giai đoạn này.
LINE_STATE_REJECTED_BY_SELLER Mặt hàng này đã bị người bán từ chối. Trạng thái này chỉ có thể xảy ra nếu trạng thái trước đó là trạng thái đang chờ đặt trước.
LINE_STATE_CANCELLED_BY_BUYER Người mua đã huỷ dòng này.
LINE_STATE_PENDING_RESERVATION_EXPIRED Dòng này đã hết hạn trong khi đang chờ đặt chỗ.
LINE_STATE_RESERVED_EXPIRED Dòng này đã hết hạn trong khi được đặt trước, đang chờ người mua trả lời.

Phương thức

book

 Đặt một dòng xe hiện có.

get

 Truy xuất một dòng riêng lẻ cho một đơn đặt hàng.

list

 Liệt kê các dòng của một đơn đặt hàng.

patch

 Cập nhật một đường kẻ hiện có.

reject

 Từ chối một đường kẻ hiện có.

reserve

 Đặt trước một tuyến đường hiện có.