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

คู่มือนี้แสดงข้อผิดพลาดของ API ที่พบบ่อยและนำเสนอกลยุทธ์ในการป้องกันและ จัดการข้อผิดพลาดเหล่านั้น

ดูรายการประเภทข้อผิดพลาดทั้งหมดได้ที่ข้อมูลอ้างอิงข้อผิดพลาดของ Google Ads API หากต้องการความช่วยเหลือเพิ่มเติม โปรดถามคำถามในฟอรัม Google Ads API

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT

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

google.auth.exceptions.RefreshError

invalid_grant

สรุป โทเค็นหมดอายุหรือถูกเพิกถอน สาเหตุที่พบบ่อย โปรเจ็กต์ Google Cloud Platform ที่มีหน้าจอขอความยินยอมให้ใช้ OAuth ซึ่งกำหนดค่าสำหรับประเภทผู้ใช้ภายนอกและมีสถานะการเผยแพร่เป็น Testing จะได้รับโทเค็นการรีเฟรชซึ่งจะหมดอายุใน 7 วัน วิธีรับมือ สถานะการเผยแพร่ของโปรเจ็กต์ Google คือ Testing ดังนั้นโทเค็นการรีเฟรชจะหมดอายุทุก 7 วันและได้รับข้อผิดพลาด invalid_grant ไปที่คอนโซล Google API แล้วไปที่หน้าจอขอความยินยอม OAuth จากนั้นเปลี่ยนสถานะการเผยแพร่เป็นIn productionเพื่อไม่ให้โทเค็นการรีเฟรชหมดอายุในอีก 7 วัน คำแนะนำการป้องกัน ดูแอปที่ไม่ได้รับการยืนยัน

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	สรุป รหัสลูกค้าของไคลเอ็นต์ไม่ใช่ตัวเลข สาเหตุที่พบบ่อย ใช้รหัสลูกค้าของไคลเอ็นต์ที่ไม่ถูกต้อง วิธีรับมือ ไม่มี คำแนะนำการป้องกัน 123-456-7890 ควรเป็น 1234567890 ดูรายละเอียดได้ที่เริ่มต้นใช้งาน
CLIENT_CUSTOMER_ID_IS_REQUIRED	สรุป ไม่ได้ระบุรหัสลูกค้าของไคลเอ็นต์ในส่วนหัว HTTP สาเหตุที่พบบ่อย ไม่ได้ระบุรหัสลูกค้าของไคลเอ็นต์ในส่วนหัว HTTP วิธีรับมือ ไม่มี คำแนะนำการป้องกัน การเรียกใช้ทั้งหมดต้องมีรหัสลูกค้าของไคลเอ็นต์ ดังนั้นโปรดตรวจสอบว่าคุณได้ระบุรหัสในส่วนหัว HTTP แล้ว ลองใช้ไลบรารีของไคลเอ็นต์ของเราเนื่องจากไลบรารีจะจัดการเรื่องนี้ให้คุณ
CUSTOMER_NOT_FOUND	สรุป ไม่พบบัญชีสำหรับรหัสลูกค้าที่ระบุในส่วนหัว สาเหตุที่พบบ่อย พยายามเข้าถึงบัญชีที่เพิ่งสร้างขึ้นก่อนที่จะมีการสร้างบัญชีในแบ็กเอนด์ วิธีรับมือ รอ 5 นาทีแรก แล้วลองอีกครั้งทุกๆ 30 วินาที คำแนะนำการป้องกัน โปรดรอสักครู่หลังจากสร้างบัญชีแล้วก่อนที่จะส่งคำขอไปยังบัญชี
GOOGLE_ACCOUNT_COOKIE_INVALID	สรุป โทเค็นเพื่อการเข้าถึงในส่วนหัวของคำขอไม่ถูกต้องหรือหมดอายุแล้ว สาเหตุที่พบบ่อย ระบบได้ยกเลิกโทเค็นเพื่อการเข้าถึงแล้ว วิธีรับมือ ขอโทเค็นใหม่ หากคุณใช้ไลบรารีของไคลเอ็นต์ของเรา โปรดอ่านเอกสารประกอบเกี่ยวกับวิธีรีเฟรชโทเค็น คำแนะนำการป้องกัน จัดเก็บและนำโทเค็นเพื่อการเข้าถึงมาใช้ซ้ำจนกว่าจะหมดอายุ
NOT_ADS_USER	สรุป บัญชี Google ที่ใช้สร้างโทเค็นเพื่อการเข้าถึงไม่ได้เชื่อมโยงกับบัญชี Google Ads ใดๆ สาเหตุที่พบบ่อย ข้อมูลเข้าสู่ระบบที่ระบุตรงกับบัญชี Google ที่ไม่ได้เปิดใช้ Google Ads วิธีรับมือ อย่าลืมลงชื่อเข้าใช้ด้วยบัญชี Google Ads ที่ถูกต้อง (โดยปกติคือบัญชีดูแลจัดการ) สำหรับขั้นตอน OAuth นอกจากนี้ คุณยังเชิญบัญชี Google ให้เข้าถึงบัญชี Google Ads ที่มีอยู่ได้โดยลงชื่อเข้าใช้บัญชีดูแลจัดการ เลือกบัญชีลูกค้าหรือบัญชีดูแลจัดการที่เป็นปัญหา ไปที่ Tools and Settings > Access and security แล้วเพิ่มอีเมลของบัญชี Google คำแนะนำการป้องกัน ไม่มี
OAUTH_TOKEN_INVALID	สรุป โทเค็นเพื่อการเข้าถึง OAuth ในส่วนหัวไม่ถูกต้อง สาเหตุที่พบบ่อย โทเค็นเพื่อการเข้าถึงที่คุณส่งผ่านส่วนหัว HTTP ไม่ถูกต้อง วิธีรับมือ ไม่มี คำแนะนำการป้องกัน ตรวจสอบว่าคุณได้ส่งโทเค็นเพื่อการเข้าถึงที่ถูกต้องซึ่งเชื่อมโยงกับบัญชีของคุณ บางครั้งอาจสับสนกับโทเค็นการรีเฟรชและรหัสการให้สิทธิ์ หากต้องการรับข้อมูลเข้าสู่ระบบที่เข้าถึงบัญชีลูกค้าทั้งหมดภายใต้บัญชีดูแลจัดการได้ โปรดตรวจสอบว่าคุณได้รับโทเค็นการรีเฟรชสำหรับบัญชีดูแลจัดการ ดูคู่มือการตรวจสอบสิทธิ์ผู้ใช้

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	สรุป โปรเจ็กต์ Google Cloud มีสิทธิ์เข้าถึงแบบทดสอบเท่านั้น และใช้เพื่อเข้าถึงบัญชีที่ใช้งานจริงไม่ได้ สาเหตุที่พบบ่อย มีการใช้โปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ที่มีระดับการเข้าถึงการทดสอบเพื่อส่งคำขอไปยังบัญชี Google Ads ที่ไม่ใช่บัญชีทดสอบ (ที่ใช้งานจริง) (ใน API เวอร์ชัน v24 และก่อนหน้า เงื่อนไขนี้จะแสดงผล AuthorizationError.ACTION_NOT_PERMITTED) วิธีรับมือ หากคุณกำลังทดสอบ โปรดตรวจสอบว่าคำขอของคุณกำหนดเป้าหมายเป็นบัญชีทดสอบ หากต้องการเข้าถึงบัญชี Google Ads ที่ใช้งานจริง ให้ตรวจสอบระดับการเข้าถึงของโปรเจ็กต์ Google Cloud ในหน้าภาพรวม Google Ads API และอัปเกรดระดับการเข้าถึงของโปรเจ็กต์เป็นสิทธิ์เข้าถึงระดับ Explorer, Basic หรือ Standard คำแนะนำการป้องกัน ไม่มี
CUSTOMER_NOT_ENABLED	สรุป เข้าถึงบัญชีลูกค้าไม่ได้เนื่องจากไม่ได้อยู่ในสถานะที่เปิดใช้ สาเหตุที่พบบ่อย กรณีนี้เกิดขึ้นเมื่อบัญชีลูกค้าลงชื่อสมัครใช้ไม่เสร็จหรือถูกปิดใช้งาน วิธีรับมือ ลงชื่อเข้าใช้ UI ของ Google Ads และตรวจสอบว่าคุณได้ทําขั้นตอนการลงชื่อสมัครใช้สําหรับบัญชีนี้เสร็จสมบูรณ์แล้ว สําหรับบัญชีที่ถูกปิดใช้งาน โปรดดูเปิดใช้งานบัญชี Google Ads ที่ยกเลิกอีกครั้ง คำแนะนำการป้องกัน คุณสามารถตรวจสอบล่วงหน้าว่าบัญชีลูกค้าถูกปิดใช้งานหรือไม่โดยดูสถานะเป็นยกเลิกแล้ว
USER_PERMISSION_DENIED	สรุป ลูกค้าที่ได้รับอนุญาตไม่มีสิทธิ์เข้าถึงลูกค้าที่ดำเนินการ สาเหตุที่พบบ่อย การตรวจสอบสิทธิ์ในฐานะผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชีดูแลจัดการ แต่ไม่ได้ระบุ login-customer-id ในคำขอ วิธีรับมือ ไม่มี คำแนะนำการป้องกัน ระบุ login-customer-id เป็นรหัสบัญชีดูแลจัดการโดยไม่มีขีดกลาง (-) ไลบรารีของไคลเอ็นต์รองรับการดำเนินการนี้อยู่แล้ว