ทรัพยากร: รับประกันคำสั่งซื้อ
คำสั่งซื้อที่รับประกันการแสดงผล
คำสั่งซื้อที่รับประกันการแสดงผลเป็นเอนทิตีหลักของแหล่งที่มาของพื้นที่โฆษณาที่รับประกันการแสดงผล เมื่อสร้างแหล่งที่มาของพื้นที่โฆษณาที่รับประกันการแสดงผล คุณต้องกำหนดรหัสคำสั่งซื้อที่รับประกันการแสดงผลให้กับแหล่งที่มาของพื้นที่โฆษณา
การแสดง JSON |
---|
{ "name": string, "legacyGuaranteedOrderId": string, "exchange": enum ( |
ช่อง | |
---|---|
name |
เอาต์พุตเท่านั้น ชื่อทรัพยากรของคำสั่งซื้อที่รับประกันการแสดงผล |
legacyGuaranteedOrderId |
เอาต์พุตเท่านั้น รหัสเดิมของคำสั่งซื้อที่รับประกันการแสดงผล ได้รับมอบหมายโดย Exchange เดิม รหัสเดิมจะไม่ซ้ำกันในการแลกเปลี่ยน 1 ครั้ง แต่ไม่รับประกันว่าคำสั่งซื้อทั้งหมดที่รับประกันจะไม่ซ้ำกัน รหัสนี้จะใช้ใน SDF และ UI |
exchange |
ต้องระบุ เปลี่ยนแปลงไม่ได้ การแลกเปลี่ยนซึ่งเป็นที่มาของคำสั่งซื้อที่รับประกันการแสดงผล |
guaranteedOrderId |
เอาต์พุตเท่านั้น ตัวระบุที่ไม่ซ้ำกันของคำสั่งซื้อที่รับประกันการแสดงผล รหัสคำสั่งซื้อที่รับประกันการแสดงผลมีรูปแบบเป็น |
displayName |
ต้องระบุ ชื่อที่แสดงของคำสั่งซื้อที่รับประกันการแสดงผล ต้องเป็น UTF-8 ที่เข้ารหัสด้วยขนาดสูงสุด 240 ไบต์ |
status |
การตั้งค่าสถานะของคำสั่งซื้อที่รับประกันการแสดงผล |
updateTime |
เอาต์พุตเท่านั้น การประทับเวลาเมื่อมีการอัปเดตคำสั่งซื้อที่รับประกันการแสดงผลครั้งล่าสุด กำหนดโดยระบบ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
publisherName |
ต้องระบุ ชื่อผู้เผยแพร่โฆษณาของคำสั่งซื้อที่รับประกันการแสดงผล ต้องเป็น UTF-8 ที่เข้ารหัสด้วยขนาดสูงสุด 240 ไบต์ |
readAccessInherited |
ผู้ลงโฆษณาทั้งหมดของ |
readAdvertiserIds[] |
รหัสของผู้ลงโฆษณาที่มีสิทธิ์อ่านคำสั่งซื้อที่รับประกันการแสดงผล ช่องนี้ต้องไม่มีผู้ลงโฆษณาที่กำหนดให้กับ |
defaultAdvertiserId |
เอาต์พุตเท่านั้น รหัสของผู้ลงโฆษณาเริ่มต้นของคำสั่งซื้อที่รับประกันการแสดงผล ผู้ลงโฆษณาเริ่มต้นจะเป็น |
defaultCampaignId |
รหัสของแคมเปญเริ่มต้นที่กำหนดให้กับคำสั่งซื้อที่รับประกันการแสดงผล แคมเปญเริ่มต้นต้องเป็นของผู้ลงโฆษณาเริ่มต้น |
ฟิลด์การรวม พาร์ทเนอร์หรือผู้ลงโฆษณาที่มีสิทธิ์เข้าถึงแบบอ่าน/เขียนสำหรับคำสั่งซื้อที่รับประกันการแสดงผล |
|
readWritePartnerId |
พาร์ทเนอร์ที่มีสิทธิ์เข้าถึงแบบอ่าน/เขียนสำหรับคำสั่งซื้อที่รับประกันการแสดงผล |
readWriteAdvertiserId |
ผู้ลงโฆษณาที่มีสิทธิ์เข้าถึงแบบอ่าน/เขียนสำหรับคำสั่งซื้อที่รับประกันการแสดงผล รวมถึงเป็นผู้ลงโฆษณาเริ่มต้นของคำสั่งซื้อที่รับประกันการแสดงผลด้วย |
GuaranteedOrderStatus
การตั้งค่าสถานะของคำสั่งซื้อที่รับประกันการแสดงผล
การแสดง JSON |
---|
{ "entityStatus": enum ( |
ช่อง | |
---|---|
entityStatus |
คำสั่งซื้อที่รับประกันการแสดงผลแสดงได้หรือไม่ ค่าที่ยอมรับได้คือ |
entityPauseReason |
เหตุผลที่ผู้ใช้ระบุในการหยุดคำสั่งซื้อที่รับประกันการแสดงผลนี้ไว้ชั่วคราว ต้องเป็น UTF-8 ที่เข้ารหัสด้วยความยาวสูงสุด 100 ไบต์ ใช้ได้เมื่อตั้งค่า |
configStatus |
เอาต์พุตเท่านั้น สถานะการกำหนดค่าของคำสั่งซื้อที่รับประกันการแสดงผล ค่าที่ยอมรับได้คือ ต้องมีการกำหนดค่าคำสั่งซื้อที่รับประกันการแสดงผล (กรอกข้อมูลในช่องที่ต้องกรอก เลือกครีเอทีฟโฆษณา และเลือกแคมเปญเริ่มต้น) ก่อน จึงจะแสดงได้ ปัจจุบันกำหนดค่าจะดำเนินการผ่าน UI ได้เท่านั้น |
GuaranteedOrderConfigStatus
สถานะการกำหนดค่าที่เป็นไปได้สำหรับคำสั่งซื้อที่รับประกันการแสดงผล
Enum | |
---|---|
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED |
ไม่ได้ระบุสถานะการอนุมัติหรือไม่ทราบในเวอร์ชันนี้ |
PENDING |
สถานะเริ่มต้นของคำสั่งซื้อที่รับประกันการแสดงผล ต้องกำหนดค่าคำสั่งซื้อที่รับประกันการแสดงผลในสถานะนี้ก่อนจึงจะแสดงได้ |
COMPLETED |
สถานะหลังจากผู้ซื้อกำหนดค่าคำสั่งซื้อที่รับประกันการแสดงผล |
วิธีการ |
|
---|---|
|
สร้างคำสั่งซื้อที่รับประกันการแสดงผลใหม่ |
|
การแก้ไขจะอ่านผู้ลงโฆษณาของคำสั่งซื้อที่รับประกันการแสดงผล |
|
ได้รับคำสั่งซื้อที่มีการรับประกัน |
|
แสดงรายการคำสั่งซื้อที่รับประกันการแสดงผลที่ผู้ใช้ปัจจุบันเข้าถึงได้ |
|
อัปเดตคำสั่งซื้อที่รับประกันการแสดงผลที่มีอยู่ |