ข้อผิดพลาดที่พบบ่อย

หน้านี้อธิบายข้อผิดพลาดที่พบได้บ่อยที่สุดซึ่งแสดงผลโดย Google Ad Manager API ระบบจะแสดงข้อผิดพลาดในรูปแบบ Error.REASON:

ข้อผิดพลาดเกี่ยวกับขีดจำกัดของเอนทิตี

EntityChildrenLimitReachedError

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

ข้อผิดพลาดเกี่ยวกับโควต้า

QuotaError.EXCEEDED_QUOTA

สรุป
จำนวนคำขอที่ส่งต่อวินาทีสูงเกินไปและเกินขีดจำกัดที่อนุญาต
เคล็ดลับการจัดการที่แนะนำ
  • ใช้เมธอดแบบกลุ่ม เช่น updateLineItems โดยรวบรวมการเปลี่ยนแปลงในเครื่องและส่งคำขอเดียวเพื่อดำเนินการเปลี่ยนแปลงเหล่านั้นทั้งหมดพร้อมกัน
  • รอประมาณ 5 วินาที แล้วลองส่งคําขออีกครั้ง โปรดทราบว่าการดำเนินการนี้ไม่ได้รับประกันว่าคำขอจะสำเร็จ หากดำเนินการไม่สำเร็จอีกครั้ง ให้ลองเพิ่มเวลารอ เราขอแนะนำให้ใช้ตัวเลือกนี้สำหรับแอปพลิเคชันแบบอินเทอร์แอกทีฟที่ผสานรวมกับ Ad Manager ซึ่งใช้แบบเรียลไทม์
  • จำกัดคำขอไว้ที่ 2 รายการต่อวินาทีสำหรับเครือข่าย Ad Manager หรือ 8 รายการต่อวินาทีสำหรับเครือข่าย Ad Manager 360 ขอย้ำอีกครั้งว่าวิธีนี้ไม่ได้รับประกันว่าคำขอทุกรายการจะสำเร็จ แต่จะช่วยลดจำนวนครั้งที่คุณได้รับข้อผิดพลาดนี้ เราขอแนะนำให้ใช้ตัวเลือกนี้สำหรับแอปพลิเคชันที่ผสานรวมกับ Ad Manager ซึ่งไม่มีการโต้ตอบแบบเรียลไทม์ เช่น การเรียกใช้รายงานทุกคืน

ข้อผิดพลาดในการตรวจสอบสิทธิ์

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

สรุป
ผู้ใช้พยายามสร้างเครือข่ายทดสอบโดยใช้บัญชีที่เชื่อมโยงกับเครือข่ายอยู่แล้ว
สาเหตุที่พบบ่อย
ผู้ใช้ไม่ได้สร้างบัญชี Google ใหม่ก่อนที่จะโทรหา NetworkService.makeTestNetwork()
เคล็ดลับการจัดการที่แนะนำ
สร้างบัญชีใหม่ก่อนโทร NetworkService.makeTestNetwork() ดูข้อมูลเพิ่มเติมได้ที่วิธีสร้างเครือข่ายทดสอบ

AuthenticationError.NETWORK_CODE_REQUIRED

สรุป
ผู้ใช้ไม่ได้ระบุ networkCode หากต้องการส่งคำขอ คุณต้องมีรหัสเครือข่าย
สาเหตุที่พบบ่อย
ต้องระบุรหัสเครือข่ายสำหรับคำขอทั้งหมด ยกเว้น NetworkService.getAllNetworks() และ NetworkService.makeTestNetwork()
เคล็ดลับการจัดการที่แนะนำ
ใส่รหัสเครือข่ายของเครือข่ายที่ระบุไว้ในส่วนหัวของคำขอ ใช้เฉพาะรหัสเครือข่ายที่ใช้ได้กับการเข้าสู่ระบบบัญชีของคุณ คุณดูรหัสได้ในเว็บไซต์ Ad Manager สำหรับบัญชีของคุณ ในหน้าผู้ดูแลระบบ > การตั้งค่าเครือข่าย ข้าง "รหัสเครือข่าย" ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่ารหัสเครือข่ายได้ในหน้าส่วนหัวคำขอและส่วนหัวการตอบกลับ SOAP XML

AuthenticationError.NETWORK_NOT_FOUND

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

AuthenticationError.NO_NETWORKS_TO_ACCESS

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

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

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

ข้อผิดพลาดเกี่ยวกับสิทธิ์

PermissionError.PERMISSION_DENIED

สรุป
ผู้ใช้ไม่มีสิทธิ์ที่จำเป็นสำหรับคำขอ
สาเหตุที่พบบ่อย
  • คุณพยายามเข้าถึงออบเจ็กต์ที่มีอยู่ในเครือข่ายอื่น
  • คุณพยายามเข้าถึงออบเจ็กต์ที่มีอยู่ในเครือข่าย แต่คุณไม่มีสิทธิ์อ่านหรืออัปเดต
  • คุณพยายามทำงานที่ต้องเปิดใช้ฟีเจอร์เพิ่มเติมในบัญชี
เคล็ดลับการจัดการที่แนะนำ
  • หากคุณกำลังสร้าง UI ให้แจ้งผู้ใช้ว่าไม่มีสิทธิ์ดำเนินการนี้และให้พูดคุยกับผู้ดูแลระบบ
  • หากคุณพยายามทำงาน เช่น งานที่เกี่ยวข้องกับฟีเจอร์พรีเมียมเท่านั้นซึ่งเครือข่ายของคุณไม่มีสิทธิ์ดำเนินการ โปรดพูดคุยกับผู้จัดการฝ่ายดูแลลูกค้าเกี่ยวกับการเปิดใช้ฟีเจอร์นี้
  • โปรดทราบว่าโดยค่าเริ่มต้น เครือข่ายทดสอบไม่ใช่เครือข่าย Ad Manager 360 ซึ่งหมายความว่าเครือข่ายทดสอบจะไม่มีฟีเจอร์พรีเมียมที่พบในเครือข่าย Ad Manager 360 พูดคุยกับผู้จัดการฝ่ายดูแลลูกค้าเพื่อเปิดใช้ฟีเจอร์ในเครือข่ายทดสอบ

ข้อผิดพลาดเกี่ยวกับเวอร์ชัน

ApiVersionError.UPDATE_TO_NEWER_VERSION

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

ข้อผิดพลาด 404

สรุป
คำขอของคุณไปไม่ถึงเซิร์ฟเวอร์
สาเหตุที่พบบ่อย
การเชื่อมต่ออินเทอร์เน็ตหรือพร็อกซีอาจกำหนดค่าไม่ถูกต้อง นอกจากนี้ เวอร์ชันของ API ที่คุณเรียกใช้อาจเลิกใช้งานแล้ว
เคล็ดลับการจัดการที่แนะนำ
ตรวจสอบการกำหนดค่าอินเทอร์เน็ตหรือพร็อกซี และตรวจสอบว่าคุณใช้ API เวอร์ชันล่าสุด คุณอาจต้องอัปเกรดไลบรารีของไคลเอ็นต์เป็นเวอร์ชันล่าสุดด้วย
คำแนะนำการป้องกัน
โปรดดูชุมชนความช่วยเหลือของ Ad Manager และบล็อกของเราเพื่อติดตามข่าวสารล่าสุดเกี่ยวกับ Ad Manager API

ข้อผิดพลาดในการถอดรหัสข้อมูล

สรุป
SOAP XML ในคำขอของคุณไม่เป็นไปตามข้อกำหนด WSDL
สาเหตุที่พบบ่อย
คำขอมีช่องหรือเอนทิตีที่ไม่ได้รวมอยู่ในข้อกำหนดเฉพาะของ WSDL หรืออยู่ในเนมสเปซที่ไม่ถูกต้อง
ประเภทในคำขอไม่ตรงกัน (เช่น ช่องจำนวนเต็มมีค่าสตริง)
เคล็ดลับการจัดการที่แนะนำ
ตรวจสอบว่าคำขอของคุณเป็นไปตามข้อกำหนดเฉพาะของ WSDL
ใช้ไลบรารีของไคลเอ็นต์เพื่อสร้าง SOAP ที่ถูกต้อง และใช้ SOAP นี้เพื่อเปรียบเทียบ ไลบรารีของไคลเอ็นต์ทั้งหมดรองรับการบันทึกคำขอและการตอบกลับ SOAP