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

หน้านี้อธิบายข้อผิดพลาดที่พบบ่อยที่สุดซึ่งมาจาก 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 สําหรับบัญชีของคุณในหน้าผู้ดูแลระบบ > การตั้งค่าเครือข่าย ข้าง "รหัสเครือข่าย" ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่ารหัสเครือข่ายได้ในหน้าคำขอ XML ของ SOAP และส่วนหัวการตอบกลับ

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 API และดูบล็อกของเราเพื่อติดตามข่าวสารล่าสุดเกี่ยวกับ Ad Manager API

ข้อผิดพลาดในการยกเลิกมาร์แชลล์

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