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

ไม่บังคับ รหัสที่ใช้ในการแมปเอนทิตีนี้กับแหล่งที่มาภายนอก
displayName

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของสาย
description

string

เอาต์พุตเท่านั้น ช่องรูปแบบอิสระเพิ่มเติมสำหรับอธิบายเส้น
lineState

enum (LineState)

เอาต์พุตเท่านั้น สถานะของสาย ดู LineState สำหรับวงจรการใช้งานของ Line

ผู้ขายสามารถใช้วิธีการที่กำหนดเอง Reserve, Book และ Reject เพื่อตั้งค่าอย่างใดอย่างหนึ่งต่อไปนี้

  • LINE_STATE_RESERVED
  • LINE_STATE_BOOKED
  • LINE_STATE_REJECTED_BY_SELLER

ผู้ซื้อจะเป็นผู้กำหนดสถานะบรรทัดอื่นๆ ทั้งหมด
rejection

object (Rejection)

ไม่บังคับ รายละเอียดการปฏิเสธสำหรับบรรทัด
startTime
(deprecated)

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่บรรทัดจะเริ่มแสดง (รวมด้วย)

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
endTime
(deprecated)

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่บรรทัดจะหยุดแสดงผล (ไม่รวม)

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "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 "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
reservationExpirationTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาการหมดอายุสำหรับการจอง ผู้ซื้อต้องจองก่อนที่การจองจะหมดอายุ มิเช่นนั้นจะถือว่ายกเลิก

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
targeting

object (Targeting)

เอาต์พุตเท่านั้น การกำหนดเป้าหมายสำหรับรายการโฆษณา
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"

LineState

สถานะของสาย

Enum
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

 ดึงข้อมูล 1 บรรทัดสำหรับคำสั่งซื้อ

list

 แสดงรายการบรรทัดสำหรับคำสั่งซื้อ

patch

 อัปเดตบรรทัดที่มีอยู่

reject

 ปฏิเสธบรรทัดที่มีอยู่

reserve

 จองสายที่มีอยู่