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

หน้านี้แสดงข้อผิดพลาดที่พบบ่อยและให้เคล็ดลับในการป้องกันและจัดการข้อผิดพลาด ดูรายการข้อผิดพลาดทั้งหมดได้ในการอ้างอิงข้อผิดพลาด หากต้องการรับการสนับสนุนเพิ่มเติม โปรดไปที่ฟอรัม

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 ไม่ถูกต้อง วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ตรวจสอบว่าคุณได้ส่งโทเค็นเพื่อการเข้าถึงที่ถูกต้องซึ่งเชื่อมโยงกับบัญชีของคุณ บางครั้งอาจสับสนกับโทเค็นสำหรับรีเฟรชและรหัสการให้สิทธิ์ หากต้องการรับข้อมูลเข้าสู่ระบบที่เข้าถึงบัญชีลูกค้าทั้งหมดภายใต้บัญชีดูแลจัดการได้ โปรดตรวจสอบว่าคุณได้รับโทเค็นการรีเฟรชสำหรับบัญชีดูแลจัดการ ดูรายละเอียดเพิ่มเติมได้ในคำแนะนำเกี่ยวกับโทเค็นเพื่อการเข้าถึงและโทเค็นการรีเฟรช รวมถึง OAuth2
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN	สรุป โทเค็นนักพัฒนาแอปเชื่อมโยงกับองค์กร Google Cloud อยู่แล้ว และจะเชื่อมโยงกับองค์กรอื่นไม่ได้ สาเหตุที่พบได้ทั่วไป โทเค็นนักพัฒนาซอฟต์แวร์ไม่ได้เชื่อมโยงกับโปรเจ็กต์ Google Cloud ในองค์กร Google Cloud เดียวกันกับโปรเจ็กต์ Google Cloud ที่ใช้ในการส่งคำขอในตอนแรก วิธีจัดการ ตรวจสอบว่ารหัสไคลเอ็นต์ OAuth เชื่อมโยงกับโปรเจ็กต์ Google Cloud ในองค์กร Google Cloud เดียวกัน หากคุณได้ส่งคำขอ API ด้วยโทเค็นของนักพัฒนาแอปแล้ว คำแนะนำการป้องกัน ตรวจสอบว่าโปรเจ็กต์ Google Cloud ทั้งหมดของคุณเชื่อมโยงกับองค์กร Google Cloud เดียวกัน โปรเจ็กต์ Google Cloud สามารถเชื่อมโยงกับโทเค็นนักพัฒนาแอปได้เพียงโทเค็นเดียว แต่โทเค็นนักพัฒนาแอปสามารถเชื่อมโยงกับหลายโปรเจ็กต์ในองค์กรได้
DEVELOPER_TOKEN_INVALID	สรุป โทเค็นนักพัฒนาซอฟต์แวร์ไม่ถูกต้อง สาเหตุที่พบได้ทั่วไป สาเหตุที่พบบ่อยของข้อผิดพลาดนี้ ได้แก่ การพิมพ์โทเค็นนักพัฒนาแอปผิด หรือการตั้งค่าโทเค็นนักพัฒนาแอปไม่ถูกต้องในส่วนหัวคำขออื่น วิธีจัดการ โปรดคัดลอกโทเค็นของนักพัฒนาแอปจากศูนย์ API เพื่อหลีกเลี่ยงการพิมพ์ผิด คุณดูศูนย์ API ได้ในบัญชีดูแลจัดการ Google Ads นอกจากนี้ โปรดตรวจสอบว่าคุณตั้งค่าโทเค็นนักพัฒนาแอปในส่วนหัวที่ถูกต้อง บางครั้งอาจสับสนระหว่างโทเค็นนักพัฒนาแอปกับโทเค็นการรีเฟรช OAuth และรหัสการให้สิทธิ์ อ่านเพิ่มเติมเกี่ยวกับส่วนหัวของคำขอต่างๆ ได้ที่นี่ คำแนะนำการป้องกัน ไม่มี

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