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

คู่มือนี้แสดงรายการข้อผิดพลาดของ 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 Cloud ที่มีสิทธิ์เข้าถึงระดับทดสอบเพื่อส่งคำขอไปยังบัญชี 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 ที่ยกเลิกอีกครั้ง คำแนะนำการป้องกัน คุณสามารถตรวจสอบล่วงหน้าว่าบัญชีลูกค้าถูกปิดใช้งานหรือไม่โดยดูสถานะเป็น CANCELLED
USER_PERMISSION_DENIED	สรุป ลูกค้าที่ได้รับอนุญาตไม่มีสิทธิ์เข้าถึงลูกค้าที่ดำเนินการ สาเหตุที่พบบ่อย ตรวจสอบสิทธิ์ในฐานะผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชีดูแลจัดการ แต่ไม่ได้ระบุ login-customer-id ในคำขอ วิธีรับมือ ไม่มี คำแนะนำการป้องกัน ระบุ login-customer-id เป็นรหัสบัญชีดูแลจัดการโดยไม่มีขีดกลาง (-) ไลบรารีของไคลเอ็นต์มีฟีเจอร์นี้ในตัว