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

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

ก่อนหน้า
จัดการข้อผิดพลาด
ถัดไป
ขั้นตอนถัดไป