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

Display & Video 360 API สามารถตอบกลับด้วยข้อผิดพลาดและคำเตือนต่างๆ โซลูชัน API ที่ดี ต้องจัดการข้อผิดพลาดเหล่านี้ได้

ข้อผิดพลาดของ API

คำขอไปยัง API ที่ดำเนินการตามที่ตั้งใจไว้ไม่สำเร็จจะแสดงข้อผิดพลาด ควรตรวจจับและจัดการการตอบกลับข้อผิดพลาด

ข้อควรระวัง: คำขอที่ส่งกลับข้อผิดพลาดจะนับรวมในโควต้า ลดอัตราข้อผิดพลาด เพื่อใช้โควต้า API ได้ดียิ่งขึ้น

การตอบกลับข้อผิดพลาดของ API จะมีรหัสการตอบกลับ HTTP, ข้อความแสดงข้อผิดพลาด และสถานะรหัส RPC ของ Google โดยมีรูปแบบดังนี้

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

ต่อไปนี้คือรายการข้อผิดพลาดของ API ที่พบบ่อยและการดำเนินการที่แนะนำ

หมายเหตุ: หากยังคงพบข้อผิดพลาดแม้ว่าจะดำเนินการแล้ว โปรดติดต่อทีมสนับสนุน

รหัสข้อผิดพลาด
400	INVALID_ARGUMENT คำขอของคุณมีปัญหา ตรวจสอบฟิลด์ข้อความในการตอบกลับข้อผิดพลาดและอัปเดตคำขอตามนั้น
401	UNAUTHENTICATED ระบบตรวจสอบสิทธิ์คำขอของคุณอย่างถูกต้องไม่ได้ ตรวจสอบว่าคุณได้รวมข้อมูลเข้าสู่ระบบ OAuth ที่ถูกต้องไว้ในคำขอแล้ว ดูข้อมูลเพิ่มเติมได้ที่คู่มือเริ่มใช้งานฉบับย่อ
403	PERMISSION_DENIED คุณไม่มีสิทธิ์ที่จำเป็นในการดำเนินการตามคำขอ ตรวจสอบว่าบัญชีผู้ใช้ของคุณมีสิทธิ์ที่เหมาะสมสำหรับพาร์ทเนอร์หรือผู้ลงโฆษณาที่เกี่ยวข้อง
404	NOT_FOUND ไม่พบแหล่งข้อมูลที่คุณพยายามดึง ตรวจสอบว่ารหัสที่คุณใช้ถูกต้องและเป็นรหัสของประเภททรัพยากรที่กำลังดึงข้อมูล
409	ABORTED มีการแก้ไขทรัพยากรที่คุณพยายามแก้ไขในที่อื่น รอสักครู่แล้วลองส่งคำขออีกครั้ง
429	RESOURCE_EXHAUSTED คุณใช้โควต้าคำขอรายวันหรืออัตราการจำกัดเกินแล้ว ใช้คอนโซล Google Cloud เพื่อตรวจสอบการใช้งาน API อัปเดตเวิร์กโฟลว์ให้ทำงานภายในขีดจำกัดโควต้าที่มีอยู่ ดูข้อมูลเพิ่มเติมได้ที่คู่มือการเพิ่มประสิทธิภาพการใช้งาน
500	INTERNAL API พบข้อผิดพลาดภายใน รอสักครู่แล้วลองส่งคำขออีกครั้ง หากข้อผิดพลาดยังคงอยู่ โปรดติดต่อทีมสนับสนุน
504	DEADLINE_EXCEEDED API ใช้เวลานานเกินไปในการดำเนินการคำขอให้เสร็จสมบูรณ์ รอสักครู่แล้วลองส่งคำขออีกครั้ง หากข้อผิดพลาดยังคงอยู่ โปรดติดต่อทีมสนับสนุน

ข้อผิดพลาดของ SDF

Display & Video 360 API ใช้การทำงานที่ใช้เวลานานเพื่อสร้างไฟล์ Structured Data (SDF) ข้อผิดพลาดในการสร้าง SDF จะแสดงในoperationที่เสร็จสมบูรณ์ ฟิลด์ error จะมีรายละเอียด ดูตัวอย่างที่ตัดทอนแล้วนี้

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

หากข้อความแสดงข้อผิดพลาดไม่ชัดเจน เราขอแนะนำให้ทำดังนี้

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

หากยังพบข้อผิดพลาด โปรดติดต่อทีมสนับสนุน

คำเตือนที่แม้จะเกิดขึ้นก็ยังดำเนินการต่อได้

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

สาเหตุหลักของคำเตือนอาจส่งผลต่อการแสดงรายการโฆษณา ในบางกรณี อาจทำให้โฆษณาไม่แสดงเลย

การป้องกัน

คำเตือนที่ไม่บล็อกบางรายการเกิดจากการกำหนดค่ารายการโฆษณาไม่ถูกต้อง ดังนี้

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

ตรวจสอบว่ารายการโฆษณาที่มีอยู่ไม่ได้สร้างคำเตือนใดๆ ก่อนที่จะใช้ การกำหนดค่าในรายการโฆษณาใหม่

การตรวจสอบ

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

คุณเพิ่มคำเตือนได้แม้ว่าจะไม่ได้เปลี่ยนการตั้งค่าหรือการกำหนดเป้าหมาย ตัวอย่างของ การดำเนินการนี้ ได้แก่

• ใบสั่งซื้อการใส่โฆษณาหยุดชั่วคราวหรือหมดอายุ
• เลิกใช้งานรายการผู้ใช้หรือตัวเลือกการกำหนดเป้าหมายแล้ว