ข้อผิดพลาดและคําเตือน

หน้าเว็บนี้กล่าวถึงข้อผิดพลาดและคำเตือนประเภทต่างๆ ที่คุณอาจ เมื่อใช้จอแสดงผลและ API ของวิดีโอ 360

ข้อผิดพลาดของ 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

จอแสดงผลและ 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 คุณจะ ควรปฏิบัติตาม หากข้อความแสดงข้อผิดพลาดไม่เห็นการดำเนินการอย่างชัดเจน ขอแนะนำให้ดำเนินการดังต่อไปนี้

• ตรวจสอบว่าผู้ใช้มีสิทธิ์ที่เหมาะสมสำหรับผู้เผยแพร่โฆษณาหลัก แหล่งข้อมูลของ partner หรือ advertiser
• ยืนยันว่ารหัสที่ระบุไว้ในตัวกรองถูกต้อง สอดคล้องกับประเภททรัพยากรที่ต้องการ และอยู่ในบริบทของ รหัสรูทที่กำหนด
• ตรวจสอบว่าไฟล์ SDF ดาวน์โหลดพร้อมกันไม่เกิน 20 รายการ งานต่อผู้ใช้

หากยังพบข้อผิดพลาด โปรดติดต่อฝ่ายสนับสนุนเพื่อรายงาน ปัญหาของคุณ

คำเตือนที่ไม่บล็อก

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

แม้จะเป็นเชิงรับ แต่ปัญหาที่ทำให้เกิดคำเตือนเหล่านี้อาจส่งผลกระทบต่อการแสดง จนถึงจุดที่ป้องกันไม่ให้เกิดขึ้นโดยสิ้นเชิง

การป้องกัน

ปัญหาหลายอย่างที่ทำให้คำเตือนไม่บล็อกสามารถหลีกเลี่ยงได้โดย การกำหนดค่ารายการโฆษณา ซึ่งรวมถึงรายการต่อไปนี้

• ช่วงเวลาแสดงโฆษณา: หากช่วงเวลาแสดงโฆษณาของรายการโฆษณาไม่ถูกต้อง หรือหาก ช่วงเวลาแสดงโฆษณาของใบสั่งซื้อการใส่โฆษณาระดับบนสุดหมดอายุแล้ว รายการโฆษณาจะสร้าง คำเตือนและจะไม่แสดง เพื่อหลีกเลี่ยงปัญหานี้ ช่วงเวลาแสดงโฆษณาของรายการไม่สิ้นสุดหลังจากการแสดงโฆษณาหลักที่แทรกไว้ คำสั่งซื้อ
• ครีเอทีฟโฆษณาที่มอบหมาย: หากไม่มีครีเอทีฟโฆษณาที่ถูกต้อง ที่กำหนดให้กับรายการโฆษณา รายการโฆษณาจะสร้างคำเตือน และจะไม่ แสดง
• การกำหนดเป้าหมาย: หากการกำหนดเป้าหมายของรายการโฆษณาไม่ใช่ กำหนดอย่างเหมาะสม รายการโฆษณาอาจสร้างคำเตือน และการแสดงผล ได้รับผลกระทบหรือถูกป้องกันด้วย

หากคุณจำลองการกำหนดค่าจากรายการโฆษณาที่มีอยู่ โปรดตรวจสอบว่า รายการโฆษณาที่มีอยู่ไม่สร้างคำเตือนที่ไม่ได้คาดการณ์ไว้

การตรวจสอบ

ปัญหาที่ทำให้คำเตือนไม่บล็อกอาจเกิดขึ้นขณะแสดงรายการโฆษณา เที่ยวบิน เพื่อให้รายการโฆษณาแสดงอย่างถูกต้อง โปรดตรวจสอบ รายการโฆษณาที่ใช้งานอยู่ สำหรับคำเตือนที่สร้างขึ้นใหม่ ดึงข้อมูลรายการโฆษณาได้ แบบเป็นกลุ่มโดยใช้ฟังก์ชัน advertisers.lineItems.list ถ้า รายการโฆษณาสร้างคำเตือนที่ไม่คาดคิด คุณควรแก้ไขปัญหา ทันทีเพื่อลดผลกระทบต่อการแสดงโฆษณา

ปัญหาอาจเกิดขึ้นได้แม้ว่าการตั้งค่าหรือการกำหนดเป้าหมายของรายการโฆษณาจะไม่มีการเปลี่ยนแปลง ตัวอย่างเช่น การหยุดชั่วคราวหรือการหมดอายุของใบสั่งซื้อการใส่โฆษณาระดับบนสุดและ การเลิกใช้งานรายชื่อผู้ใช้หรือการกำหนดเป้าหมายอื่นๆ