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

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

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

ก่อนหน้า
คู่มือเริ่มใช้งานฉบับย่อ
ถัดไป
ขั้นตอนถัดไป