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

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

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

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 เป็นรหัสบัญชีดูแลจัดการโดยไม่มีขีดกลาง (-) ไลบรารีไคลเอ็นต์รองรับการดำเนินการนี้อยู่แล้ว

ก่อนหน้า
เรียก API
ถัดไป
ขั้นตอนถัดไป