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

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