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

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

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 และรหัสการให้สิทธิ์ อ่านเพิ่มเติมเกี่ยวกับส่วนหัวของคำขอต่างๆ ได้ที่นี่ here.
คำแนะนำการป้องกัน ไม่มี

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

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