REST Resource: availabilityOrders

Resource: 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.State สำหรับวงจรการใช้งานของ AvailabilityOrder

ผู้ขายสามารถใช้เมธอด Complete แบบกำหนดเองเพื่อตั้งค่าเป็น STATE_COMPLETED ได้
pendingExpirationTime

string (Timestamp format)

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

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

object (AdvertiserInfo)

เอาต์พุตเท่านั้น ข้อมูลผู้ลงโฆษณา

รัฐ

ค่าที่เป็นไปได้สำหรับสถานะการสั่งซื้อความพร้อมจำหน่ายสินค้า

Enum
STATE_UNSPECIFIED ค่าเริ่มต้นเมื่อไม่ได้ระบุสถานะคำสั่งซื้อความพร้อมจำหน่ายสินค้าหรือไม่ทราบในเวอร์ชันนี้
STATE_PENDING ความพร้อมจำหน่ายสินค้าที่รอดำเนินการเมื่อผู้ซื้อระบุการตั้งค่าคำขอความพร้อมจำหน่ายสินค้าแล้ว
STATE_COMPLETED สถานะความพร้อมจำหน่ายสินค้าเสร็จสมบูรณ์เมื่อผู้ขายระบุการตอบกลับความพร้อมจำหน่ายสินค้าในทุกบรรทัด
STATE_CANCELLED สถานะความพร้อมจำหน่ายสินค้าถูกยกเลิกเมื่อผู้ซื้อให้คำขอยกเลิกก่อนที่ผู้ขายจะแจ้งข้อมูลความพร้อมจำหน่ายสินค้าสำหรับทุกบรรทัด
STATE_EXPIRED สถานะความพร้อมจำหน่ายสินค้าหมดอายุเมื่อคําสั่งซื้อหมดอายุก่อนที่ผู้ขายจะดําเนินการจนเสร็จสมบูรณ์

เมธอด

complete

 ทำเครื่องหมายคำสั่งซื้อความพร้อมจำหน่ายสินค้าที่มีอยู่ว่าเสร็จสมบูรณ์

get

 เรียกข้อมูลคำสั่งซื้อความพร้อมจำหน่ายสินค้าแต่ละรายการ

list

 แสดงรายการคำสั่งซื้อความพร้อมใช้งาน