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

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

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

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