ทรัพยากร: GuaranteedOrder
คำสั่งซื้อที่รับประกัน
คำสั่งซื้อที่รับประกันคือเอนทิตีหลักของแหล่งที่มาของพื้นที่โฆษณาที่รับประกัน เมื่อสร้างแหล่งที่มาของพื้นที่โฆษณาที่รับประกัน คุณต้องกําหนดรหัสคําสั่งซื้อที่รับประกันให้กับแหล่งที่มาของพื้นที่โฆษณา
การแสดง JSON |
---|
{ "name": string, "legacyGuaranteedOrderId": string, "exchange": enum ( |
ช่อง | |
---|---|
name |
เอาต์พุตเท่านั้น ชื่อทรัพยากรของคำสั่งซื้อที่รับประกัน |
legacyGuaranteedOrderId |
เอาต์พุตเท่านั้น รหัสเดิมของคำสั่งซื้อที่รับประกัน กำหนดโดยโบรกเกอร์เดิม รหัสเดิมจะซ้ำกันภายในการแลกเปลี่ยนเดียว แต่ไม่มีการรับประกันว่าจะไม่ซ้ำกันสำหรับคำสั่งซื้อที่มีการรับประกันทั้งหมด รหัสนี้ใช้ใน SDF และ UI |
exchange |
ต้องระบุ เปลี่ยนแปลงไม่ได้ การแลกเปลี่ยนที่เป็นต้นทางของคำสั่งซื้อที่รับประกัน |
guaranteedOrderId |
เอาต์พุตเท่านั้น ตัวระบุที่ไม่ซ้ำกันของคำสั่งซื้อที่มีการรับประกัน รหัสคำสั่งซื้อที่มีการรับประกันจะมีรูปแบบเป็น |
displayName |
ต้องระบุ ชื่อที่แสดงของคำสั่งซื้อที่รับประกัน ต้องเข้ารหัส UTF-8 และมีขนาดสูงสุด 240 ไบต์ |
status |
การตั้งค่าสถานะของคำสั่งซื้อที่มีการรับประกัน |
updateTime |
เอาต์พุตเท่านั้น การประทับเวลาที่อัปเดตคำสั่งซื้อที่รับประกันครั้งล่าสุด กำหนดโดยระบบ ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น |
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 |
สถานะหลังจากที่ผู้ซื้อกำหนดค่าคำสั่งซื้อที่มีการรับประกัน |
เมธอด |
|
---|---|
|
สร้างคำสั่งซื้อที่มีการรับประกันใหม่ |
|
แก้ไขผู้ลงโฆษณาที่อ่านคำสั่งซื้อที่มีการรับประกัน |
|
ได้รับคำสั่งซื้อที่รับประกัน |
|
แสดงรายการคำสั่งซื้อที่มีการรับประกันที่ผู้ใช้ปัจจุบันเข้าถึงได้ |
|
อัปเดตคำสั่งซื้อที่มีการรับประกันที่มีอยู่ |