ข้อผิดพลาดที่พบบ่อย
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
หน้านี้แสดงข้อผิดพลาดที่พบบ่อยและให้เคล็ดลับในการป้องกันและจัดการข้อผิดพลาด
ดูรายการข้อผิดพลาดทั้งหมดได้ในการอ้างอิง
ข้อผิดพลาด หากต้องการรับการสนับสนุนเพิ่มเติม โปรดไปที่ฟอรัม
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 วัน
|
คำแนะนำการป้องกัน |
ดูแอปที่ไม่ได้รับการยืนยัน
|
|
|
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 และรหัสการให้สิทธิ์ อ่านเพิ่มเติมเกี่ยวกับส่วนหัวของคำขอต่างๆ ได้ที่นี่
|
คำแนะนำการป้องกัน |
ไม่มี
|
|
|
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 เป็นรหัสบัญชีดูแลจัดการโดยไม่มีขีดกลาง (- ) ไลบรารีของไคลเอ็นต์มีการรองรับในตัวสำหรับรหัสนี้
|
|
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-31 UTC
[null,null,["อัปเดตล่าสุด 2025-08-31 UTC"],[[["\u003cp\u003eThis page provides solutions and preventative measures for common Google Ads API errors.\u003c/p\u003e\n"],["\u003cp\u003eFor a comprehensive list of errors, refer to the dedicated error references section.\u003c/p\u003e\n"],["\u003cp\u003eAdditional assistance and community support can be found on the Google Ads API forum.\u003c/p\u003e\n"],["\u003cp\u003eUnderstanding and addressing these errors is crucial for successful API integration and campaign management.\u003c/p\u003e\n"]]],[],null,[]]