หน้านี้จะกล่าวถึงข้อผิดพลาดและคำเตือนประเภทต่างๆ ที่คุณอาจพบเมื่อใช้ Display & Video 360 API
ข้อผิดพลาดของ API
คำขอที่ส่งไปยัง API ที่ดำเนินการให้เสร็จสมบูรณ์ไม่ได้จะแสดงข้อความแสดงข้อผิดพลาด คำขอที่ส่งกลับข้อผิดพลาดจะนับรวมในโควต้าของผู้ใช้ และจะได้รับการพิจารณาเมื่อตรวจสอบคำขอโควต้าเพิ่มเติม คุณควรประมวลผลและจัดการการตอบกลับข้อผิดพลาดเพื่อหลีกเลี่ยงข้อผิดพลาดในอนาคต
การตอบกลับข้อผิดพลาดจะใช้รูปแบบต่อไปนี้และมีรหัสตอบกลับ HTTP, ข้อความแสดงข้อผิดพลาด และสถานะรหัส RPC ของ Google
{
"error": {
"code": integer,
"message": string,
"status": enum (google.rpc.Code)
}
}
ด้านล่างนี้คือรายการข้อผิดพลาด API ที่พบบ่อยพร้อมกับการดำเนินการที่แนะนำหากแสดงผล
รหัส | RPC | การดำเนินการที่แนะนำ |
---|---|---|
400
|
INVALID_ARGUMENT
|
เกิดปัญหากับคำขอของคุณ ตรวจสอบช่องข้อความในการตอบกลับข้อผิดพลาดและแก้ไขคําขอตามที่ระบุ |
401
|
UNAUTHENTICATED
|
ไม่สามารถตรวจสอบสิทธิ์คำขอของคุณได้อย่างเหมาะสม ยืนยันว่าคุณรวมข้อมูลเข้าสู่ระบบ OAuth ที่ถูกต้องในคำขอ หากต้องการข้อมูลเพิ่มเติม โปรดดูคู่มือเริ่มต้นใช้งานของเรา |
403
|
PERMISSION_DENIED
|
คุณไม่มีสิทธิ์ที่จำเป็นในการทำตามคำขอ ตรวจสอบว่าบัญชีผู้ใช้มีสิทธิ์ ที่เหมาะสมสำหรับพาร์ทเนอร์หรือผู้ลงโฆษณาที่เกี่ยวข้อง |
404
|
NOT_FOUND
|
ไม่พบทรัพยากรที่คุณพยายามเรียกข้อมูล ตรวจสอบว่ารหัสที่ใช้อยู่ถูกต้องและเป็นประเภททรัพยากรที่กำลังดึงข้อมูล |
409
|
ABORTED
|
ทรัพยากรที่คุณพยายามแก้ไขมีการแก้ไขจากที่อื่นด้วย รอสักครู่แล้วลองส่งคำขออีกครั้ง |
429
|
RESOURCE_EXHAUSTED
|
คุณมีขีดจำกัดของอัตราหรือโควต้าคำขอรายวันแล้ว
ตรวจสอบการใช้งาน API โดยใช้คอนโซล Google API และแก้ไขเวิร์กโฟลว์ให้ทำงานภายในขีดจำกัดโควต้าที่มีอยู่ สำหรับข้อมูลเพิ่มเติม โปรดดูที่หน้าเกี่ยวกับการเพิ่มประสิทธิภาพโควต้า หากดำเนินงานภายในโควต้ารายวันที่ระบุไม่ได้ คุณอาจขอโควต้าเพิ่มเติมได้ |
500
|
INTERNAL
|
API พบข้อผิดพลาดภายใน โปรดรอสักครู่ แล้วลองส่งคำขออีกครั้ง หากข้อผิดพลาดยังคงอยู่ โปรดติดต่อทีมสนับสนุน |
504
|
DEADLINE_EXCEEDED
|
API ใช้เวลาดำเนินการตามคำขอนานเกินไป โปรดรอสักครู่แล้วลองส่งคําขออีกครั้ง หากข้อผิดพลาดยังคงอยู่ ให้ติดต่อทีมสนับสนุน |
ข้อผิดพลาดของ SDF
Display & Video 360 API ใช้เมธอดแบบไม่พร้อมกันสำหรับสร้างและดาวน์โหลดไฟล์ข้อมูลที่มีโครงสร้าง (SDF) ด้วยเหตุนี้ ระบบจะส่งข้อผิดพลาดที่เกิดขึ้นระหว่างการสร้าง SDF กลับมาในงานดาวน์โหลด SDF ที่เสร็จแล้ว งานดาวน์โหลด SDF ที่เสร็จสิ้นใน error
จะถูกทำเครื่องหมายว่าเสร็จสิ้น แต่กลับมีช่องข้อผิดพลาดปรากฏขึ้นแทนชื่อทรัพยากรสื่อในช่อง response
ตามที่เห็นในตัวอย่างที่ถูกตัดทอนนี้
{
...
"done": true,
"error": {
"code": 3,
"message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
}
}
หากได้รับข้อความแสดงข้อผิดพลาดที่ดำเนินการได้เมื่อพยายามสร้าง SDF คุณควรปฏิบัติตามข้อความนั้น หากข้อความแสดงข้อผิดพลาดไม่สามารถแก้ไขได้ชัดเจน ขอแนะนำให้ดำเนินการต่อไปนี้
- ตรวจสอบว่าผู้ใช้มีสิทธิ์ที่เหมาะสมสำหรับทรัพยากรของพาร์ทเนอร์หรือผู้ลงโฆษณาหลัก
- ยืนยันว่ารหัสที่ระบุในตัวกรองถูกต้อง ตรงกับประเภททรัพยากรที่ต้องการ และอยู่ในบริบทของรหัสรูทที่ระบุ
- ตรวจสอบว่างานดาวน์โหลด SDF พร้อมกันไม่เกินขีดจำกัด 20 รายการต่อผู้ใช้
หากยังพบข้อผิดพลาด โปรดติดต่อทีมสนับสนุนเพื่อรายงานปัญหา
คำเตือนที่ไม่บล็อก
คำเตือนที่ยังสามารถดำเนินการต่อได้สำหรับรายการโฆษณาเพื่อระบุปัญหาที่อาจส่งผลต่อการแสดงรายการโฆษณา ระบบจะส่งคำเตือนที่คล้ายกัน
ใน UI ผ่านแบนเนอร์การแจ้งเตือน คำเตือนเหล่านี้เป็นแบบไม่ต้องดำเนินการใดๆ และจะแสดงในช่อง warningMessages
ของรายการโฆษณา
แม้จะเป็นแบบแพสซีฟ แต่ปัญหาที่ทำให้เกิดคำเตือนเหล่านี้อาจส่งผลกระทบต่อการแสดงรายการโฆษณาจนถึงจุดที่ป้องกันการแสดงผลโดยสมบูรณ์ได้
การป้องกัน
ปัญหาหลายอย่างที่ทำให้เกิดคำเตือนที่ไม่บล็อกสามารถหลีกเลี่ยงได้ผ่านการกำหนดการตั้งค่ารายการโฆษณาที่เหมาะสม ซึ่งรวมถึงการตั้งค่าต่อไปนี้
- ช่วงเวลาแสดงโฆษณา: หากช่วงเวลาแสดงโฆษณาของรายการโฆษณาไม่ถูกต้องหรือการแสดงโฆษณาของใบสั่งซื้อการใส่โฆษณาหลักหมดอายุ รายการโฆษณาจะสร้างคำเตือนและจะไม่แสดง เพื่อหลีกเลี่ยงไม่ให้เกิดปัญหาหลัง ให้ตรวจสอบว่าการแสดงโฆษณาของรายการโฆษณาไม่ได้สิ้นสุดช้ากว่าการแสดงโฆษณาของใบสั่งซื้อการใส่โฆษณาระดับบนสุด
- ครีเอทีฟโฆษณาที่มอบหมาย: หากไม่มีการกำหนดครีเอทีฟโฆษณาที่ถูกต้องให้กับรายการโฆษณา รายการโฆษณาจะสร้างคำเตือนและจะไม่แสดง
- การกำหนดเป้าหมาย: หากไม่ได้กำหนดการกำหนดเป้าหมายของรายการโฆษณาอย่างถูกต้อง รายการโฆษณาอาจสร้างคำเตือน การแสดงโฆษณาอาจ ได้รับผลกระทบหรือถูกป้องกันไม่ให้เกิดขึ้นเลย
หากคุณจำลองการกำหนดค่าจากรายการโฆษณาที่มีอยู่ โปรดตรวจสอบว่ารายการโฆษณาที่มีอยู่ไม่ได้สร้างคำเตือนที่ไม่คาดคิด
Monitoring
ปัญหาที่ทําให้เกิดคําเตือนที่ไม่บล็อกอาจปรากฏขึ้นขณะที่รายการโฆษณาทํางานอยู่ เพื่อให้มั่นใจว่ารายการโฆษณาแสดงอย่างถูกต้อง ให้คอยตรวจสอบรายการโฆษณาที่ใช้งานอยู่เพื่อหาคำเตือนที่เพิ่งสร้างใหม่ คุณดึงข้อมูลรายการโฆษณาจำนวนมากได้โดยใช้ฟังก์ชัน advertisers.lineItems.list
หากรายการโฆษณาสร้างคำเตือนที่ไม่คาดคิด คุณควรแก้ไขปัญหาทันทีเพื่อลดผลกระทบต่อการแสดงโฆษณา
ปัญหาอาจเกิดขึ้นได้แม้ว่าการตั้งค่าหรือการกำหนดเป้าหมายของรายการโฆษณาจะไม่มีการเปลี่ยนแปลง เช่น การหยุดชั่วคราวหรือการหมดอายุของใบสั่งซื้อการใส่โฆษณาระดับบนสุด และการเลิกใช้งานรายชื่อผู้ใช้หรือการกำหนดเป้าหมายอื่นๆ