ข้อผิดพลาดที่พบบ่อย
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
หน้านี้แสดงข้อผิดพลาดที่พบบ่อยและให้เคล็ดลับในการป้องกันและจัดการข้อผิดพลาด
ดูรายการข้อผิดพลาดทั้งหมดได้ในการอ้างอิง
ข้อผิดพลาด หากต้องการรับการสนับสนุนเพิ่มเติม โปรดไปที่ฟอรัม
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 วัน
|
|---|
| คำแนะนำการป้องกัน |
ดูแอปที่ไม่ได้รับการยืนยัน
|
|---|
|
|
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR |
| สรุป | ใช้โอเปอเรเตอร์นี้กับคลาสย่อยของโฆษณาไม่ได้ |
|---|
| สาเหตุที่พบได้ทั่วไป |
พยายามแก้ไขแอตทริบิวต์อื่นๆ นอกเหนือจาก status ของโฆษณา
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
เมื่อสร้างโฆษณาแล้ว คุณจะแก้ไขไม่ได้ หากต้องการแก้ไขโฆษณา คุณต้องสร้างโฆษณาใหม่แล้วนําโฆษณาเก่าออก แต่คุณสามารถแก้ไข status ของโฆษณาได้โดยใช้ MutateAdGroupAds
|
|---|
|
INVALID_INPUT |
| สรุป | ฟิลด์อย่างน้อย 1 รายการในโฆษณามีอักขระที่ไม่ถูกต้อง |
|---|
| สาเหตุที่พบได้ทั่วไป |
การใช้สัญลักษณ์พิเศษใน URL
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
ตรวจสอบ URL ในแอปก่อนส่งคำขอ API
|
|---|
|
LINE_TOO_WIDE |
| สรุป | ฟิลด์หนึ่งในโฆษณามีความยาวเกินความยาวสูงสุดที่อนุญาต ดูเกี่ยวกับโฆษณาแบบข้อความ |
|---|
| สาเหตุที่พบได้ทั่วไป |
มีข้อความยาวเกินไป
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
ตรวจสอบความยาวของบรรทัดก่อนส่งคำขอ API
|
|---|
|
|
AD_GROUP_AD_LABEL_ALREADY_EXISTS |
| สรุป | ป้ายกำกับนี้เชื่อมโยงกับโฆษณาบางรายการแล้ว |
|---|
| สาเหตุที่พบได้ทั่วไป |
พยายามเชื่อมโยงป้ายกำกับกับโฆษณาที่เชื่อมโยงแล้ว
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
ก่อนอื่น ให้ตรวจสอบว่าป้ายกำกับที่จะเพิ่มเชื่อมโยงกับโฆษณาอยู่แล้วหรือไม่
|
|---|
|
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD |
| สรุป | การดำเนินการพยายามอัปเดตโฆษณาที่ถูกนำออก |
|---|
| สาเหตุที่พบได้ทั่วไป |
เมื่อนำโฆษณาออกแล้ว คุณจะอัปเดตโฆษณาไม่ได้อีกต่อไป รวมถึงการเปลี่ยนแปลงสถานะของโฆษณาด้วย
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
ตรวจสอบว่าโค้ดไม่ได้พยายามอัปเดตโฆษณาที่ถูกนำออก
|
|---|
|
|
INVALID_KEYWORD_TEXT |
| สรุป | ข้อความคีย์เวิร์ดมีอักขระที่ไม่ถูกต้อง ดูเพิ่มคีย์เวิร์ด |
|---|
| สาเหตุที่พบได้ทั่วไป |
ข้อความคีย์เวิร์ดมีอักขระที่ไม่ถูกต้อง
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
ตรวจสอบข้อความคีย์เวิร์ดในแอปก่อนส่งคำขอไปยัง API
|
|---|
|
|
DUPLICATE_ADGROUP_NAME |
| สรุป | มีการเพิ่มหรือเปลี่ยนชื่อกลุ่มโฆษณา แต่มีกลุ่มโฆษณาอื่นใช้ชื่อนั้นอยู่แล้ว |
|---|
| สาเหตุที่พบได้ทั่วไป |
การสร้างกลุ่มโฆษณาใหม่โดยใช้ชื่อของกลุ่มโฆษณาที่ใช้งานอยู่หรือหยุดชั่วคราว
|
|---|
| วิธีจัดการ |
บันทึกข้อผิดพลาดและแสดงข้อความแสดงข้อผิดพลาดต่อผู้ใช้ โดยอาจแนะนำชื่อกลุ่มโฆษณาที่ไม่ซ้ำกันหรือแสดงรายการชื่อที่ใช้อยู่
|
|---|
| คำแนะนำการป้องกัน |
ไม่มี
|
|---|
|
|
DUPLICATE_ASSET |
| สรุป | การดำเนินการ 2 รายการในคำขอเดียวมีการดำเนินการสร้างสำหรับชิ้นงานที่มีข้อมูลไบนารีเดียวกัน |
|---|
| สาเหตุที่พบได้ทั่วไป |
คำขอเปลี่ยนแปลงที่มีการดำเนินการสร้างที่ซ้ำกันซึ่งมีข้อมูลไบนารีเดียวกัน
|
|---|
| วิธีจัดการ |
สร้างชิ้นงานในคำขอแยกต่างหาก จากนั้นลิงก์ไปยังชิ้นงานในคำขอถัดไป หรือใช้รหัสชั่วคราวภายในคำขอเดียวกัน
|
|---|
| คำแนะนำการป้องกัน |
ไม่มี
|
|---|
|
|
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 เป็นรหัสบัญชีดูแลจัดการโดยไม่มีขีดกลาง (-) ไลบรารีของไคลเอ็นต์มีการรองรับในตัวสำหรับรหัสนี้
|
|---|
|
|
BID_TOO_MANY_FRACTIONAL_DIGITS |
| สรุป | ค่าเสนอราคาไม่ใช่ผลคูณที่แน่นอนของหน่วยขั้นต่ำของสกุลเงินของบัญชี เช่น US$ 0.015 (15000 ในหน่วยไมโคร) ไม่ใช่ราคาเสนอที่ถูกต้อง |
|---|
| สาเหตุที่พบได้ทั่วไป |
ไม่มี
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
ตรวจสอบว่าราคาเสนอเป็นทวีคูณของหน่วยขั้นต่ำสำหรับสกุลเงินของบัญชี
|
|---|
|
BID_TOO_BIG |
| สรุป | ระบบจะแสดงข้อผิดพลาดแม้ว่าราคาเสนอจะอยู่ภายในงบประมาณของแคมเปญก็ตาม |
|---|
| สาเหตุที่พบได้ทั่วไป |
ไม่มี
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
ตรวจสอบว่าบัญชีเข้าร่วม Google Ad Grants หรือไม่ หากเป็นเช่นนั้น ให้จำกัดราคาเสนอ CPC เป็นสูงสุดที่โปรแกรมกำหนด
|
|---|
|
|
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC |
| สรุป | จำนวนงบประมาณน้อยเกินไป |
|---|
| สาเหตุที่พบได้ทั่วไป |
ไม่มี
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
ตรวจสอบว่าจำนวนงบประมาณมากกว่าหรือเท่ากับหน่วยขั้นต่ำสำหรับสกุลเงินของบัญชี
|
|---|
|
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT |
| สรุป | จำนวนงบประมาณจะมีทศนิยมที่มีเลขนัยสำคัญมากเกินไปเมื่อแปลงจากจำนวนเงินเล็กน้อยเป็นจำนวนเงินในสกุลเงินของบัญชี |
|---|
| สาเหตุที่พบได้ทั่วไป |
ไม่มี
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
ตรวจสอบว่าจำนวนงบประมาณหารด้วยหน่วยขั้นต่ำสำหรับสกุลเงินของบัญชีได้ลงตัว
|
|---|
|
|
DUPLICATE_CAMPAIGN_NAME |
| สรุป | มีการเพิ่มหรือเปลี่ยนชื่อแคมเปญ แต่มีแคมเปญอื่นใช้ชื่อนั้นอยู่แล้ว |
|---|
| สาเหตุที่พบได้ทั่วไป |
การสร้างแคมเปญใหม่โดยใช้ชื่อของแคมเปญที่ใช้งานอยู่หรือหยุดชั่วคราว
|
|---|
| วิธีจัดการ |
บันทึกข้อผิดพลาดและแสดงข้อความแสดงข้อผิดพลาดต่อผู้ใช้ โดยอาจแนะนำชื่อแคมเปญที่ไม่ซ้ำกันหรือแสดงรายการชื่อที่ใช้อยู่
|
|---|
| คำแนะนำการป้องกัน |
ไม่มี
|
|---|
|
|
KEYWORD_HAS_INVALID_CHARS |
| สรุป | การเพิ่มหรือแก้ไขคีย์เวิร์ดที่มีอักขระที่ไม่ถูกต้อง |
|---|
| สาเหตุที่พบได้ทั่วไป |
ใช้สัญลักษณ์พิเศษ เช่น ! @ % * ในคีย์เวิร์ด
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
ตรวจสอบว่าคุณไม่ได้ใช้อักขระที่ไม่ได้รับอนุญาตในคีย์เวิร์ด ดูเพิ่มคีย์เวิร์ด
|
|---|
|
|
DUPLICATE_ELEMENT |
| สรุป | คำขอมีพารามิเตอร์ 2 รายการที่เหมือนกันและซ้ำซ้อน |
|---|
| สาเหตุที่พบได้ทั่วไป |
ไม่มี
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
นํารายการที่ซ้ำกัน (การดำเนินการ พารามิเตอร์ องค์ประกอบรายการ) ออกก่อนส่งคำขอ มองหาฟิลด์ที่มีข้อจำกัด DistinctElements
|
|---|
|
|
DEADLINE_EXCEEDED |
| สรุป | คำขอหมดเวลาและดำเนินการไม่เสร็จเร็วพอที่จะส่งคืนการตอบกลับ |
|---|
| สาเหตุที่พบได้ทั่วไป |
มีการส่งคำขอค้นหาที่สร้างการตอบกลับขนาดใหญ่เกินไป หรือคำขอเปลี่ยนแปลงมีขนาดใหญ่เกินไปที่จะประมวลผล
|
|---|
| วิธีจัดการ |
รอประมาณ 30 วินาที แล้วลองส่งคําขออีกครั้ง หากยังคงพบข้อผิดพลาดอยู่ ให้ลองแบ่งคำขอออกเป็นคำขอที่เล็กลงหลายๆ คำขอ ซึ่งจะดำเนินการให้เสร็จได้เร็วกว่า
|
|---|
| คำแนะนำการป้องกัน |
ดูการแบ่งกลุ่มเพื่อทําความเข้าใจว่าการแบ่งกลุ่มส่งผลต่อขนาดของการตอบกลับได้อย่างไร โปรดทราบข้อจำกัดของเลเยอร์การรับส่ง gRPC
|
|---|
|
INTERNAL_ERROR |
| สรุป | เกิดข้อผิดพลาดที่ไม่คาดคิดขณะประมวลผลคำขอ |
|---|
| สาเหตุที่พบได้ทั่วไป |
API ทำงานไม่ถูกต้องเนื่องจากมีข้อบกพร่อง
|
|---|
| วิธีจัดการ |
ลองส่งคำขอที่ล้มเหลวเนื่องจากข้อผิดพลาดนี้อีกครั้ง โดยใช้กำหนดการ Exponential Backoff สำหรับการลองใหม่
|
|---|
| คำแนะนำการป้องกัน |
ไม่มี
|
|---|
|
TRANSIENT_ERROR |
| สรุป | เกิดข้อผิดพลาดภายในชั่วคราว และควรลองอีกครั้ง |
|---|
| สาเหตุที่พบได้ทั่วไป |
ข้อผิดพลาดนี้เกิดขึ้นเมื่อ API พบปัญหาชั่วคราวภายใน
|
|---|
| วิธีจัดการ |
ลองส่งคำขอที่ล้มเหลวเนื่องจากข้อผิดพลาดนี้อีกครั้ง โดยใช้กำหนดการ Exponential Backoff สำหรับการลองใหม่
|
|---|
| คำแนะนำการป้องกัน |
ไม่มี
|
|---|
|
InvalidGrantError
|
invalid_grant (malformed auth code) |
| สรุป | รหัสการให้สิทธิ์ที่แลกเปลี่ยนเป็นโทเค็น OAuth มีรูปแบบไม่ถูกต้อง |
|---|
| สาเหตุที่พบได้ทั่วไป |
กรณีนี้จะเกิดขึ้นเมื่อพยายามสร้างโทเค็นรีเฟรชสำหรับผู้ใช้ที่ได้รับสิทธิ์เข้าถึงแอปพลิเคชันที่ขอแล้ว เช่น กรณีที่เรียกใช้ตัวอย่างการสร้างข้อมูลเข้าสู่ระบบของผู้ใช้มากกว่า 1 ครั้งสำหรับข้อมูลเข้าสู่ระบบไคลเอ็นต์ OAuth เดียวกันและผู้ใช้ที่ให้สิทธิ์
|
|---|
| วิธีจัดการ |
หากต้องการสร้างโทเค็นการรีเฟรชใหม่สำหรับการรวมกันของผู้ใช้ที่ให้สิทธิ์และข้อมูลเข้าสู่ระบบไคลเอ็นต์ OAuth ที่ระบุ ให้เพิกถอนโทเค็นการรีเฟรชที่มีอยู่ โปรดทราบว่าการเพิกถอนโทเค็นจะทำให้โทเค็นนั้นใช้เพื่อเข้าถึง Google Ads API ไม่ได้ และจะทำให้โทเค็นเพื่อการเข้าถึงที่สร้างขึ้นโดยใช้โทเค็นรีเฟรชไม่ถูกต้อง
|
|---|
| คำแนะนำการป้องกัน |
อย่าลืมจัดเก็บโทเค็นการรีเฟรชไว้ในที่ปลอดภัยเพื่อหลีกเลี่ยงการรีเฟรช
|
|---|
|
|
RESOURCE_NOT_FOUND |
| สรุป | คำขออ้างอิงถึงทรัพยากรที่ไม่พบ |
|---|
| สาเหตุที่พบได้ทั่วไป |
คำขอพยายามเปลี่ยนแปลงหรืออ้างอิงทรัพยากรที่ไม่มีอยู่หรือถูกนำออกไปแล้ว หรือชื่อทรัพยากรที่ระบุสำหรับทรัพยากรนั้นผิดรูปแบบ
|
|---|
| วิธีจัดการ |
ใช้คำขอค้นหาเพื่อดึงชื่อทรัพยากรสำหรับทรัพยากรที่มีอยู่ก่อนส่งคำขอเปลี่ยนแปลง อ่านคำแนะนำเกี่ยวกับคลังของไคลเอ็นต์ ซึ่งรวมถึงเอกสารประกอบเกี่ยวกับวิธีสร้างชื่อทรัพยากรที่ถูกต้องในทุกภาษาที่รองรับ
|
|---|
| คำแนะนำการป้องกัน |
อย่าสร้างชื่อทรัพยากรด้วยตนเอง ใช้วิธีการช่วยเหลืออย่างใดอย่างหนึ่งที่ไลบรารีของไคลเอ็นต์ของเรามีให้
|
|---|
|
|
EMPTY_LIST |
| สรุป | รายการที่จำเป็นว่างเปล่า |
|---|
| สาเหตุที่พบได้ทั่วไป |
ส่งรายการการดำเนินการที่ว่างเปล่าไปยังเมธอด mutate
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
ไม่มี
|
|---|
|
|
RESOURCE_EXHAUSTED |
| สรุป | เกินขีดจำกัดความถี่ของระบบ |
|---|
| สาเหตุที่พบได้ทั่วไป |
ไม่มี
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
ตั้งค่าการหน่วงเวลาสั้นๆ ระหว่างคำขอหรือรวมการดำเนินการเพิ่มเติมในคำขอที่น้อยลง
|
|---|
|
|
TOO_LOW |
| สรุป | ค่าต่ำกว่าค่าต่ำสุดที่อนุญาต |
|---|
| สาเหตุที่พบได้ทั่วไป |
ลืมระบุรหัส ซึ่งส่งผลให้มีการส่งค่า 0
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
โปรดทราบข้อจำกัดของช่วงที่ระบุไว้ในข้อมูลอ้างอิง API
|
|---|
|
|
INVALID_INPUT |
| สรุป | คำขอมีรูปแบบไม่ถูกต้อง |
|---|
| สาเหตุที่พบได้ทั่วไป |
URL หรือเนื้อหาของคำขอมีรูปแบบไม่ถูกต้อง
|
|---|
| วิธีจัดการ |
ไม่มี
|
|---|
| คำแนะนำการป้องกัน |
ไม่มี
|
|---|
|
REQUIRED_FIELD_MISSING |
| สรุป | คำขอไม่มีข้อมูลที่จำเป็น |
|---|
| สาเหตุที่พบได้ทั่วไป |
โปรดกรอกข้อมูลในช่องที่ต้องกรอกเมื่อพยายามเพิ่มเอนทิตี
|
|---|
| วิธีจัดการ |
บันทึกข้อผิดพลาดและแสดงข้อความแสดงข้อผิดพลาดต่อผู้ใช้ แอตทริบิวต์ fieldPath ของข้อผิดพลาดจะระบุฟิลด์ที่ขาดหายไป
|
|---|
| คำแนะนำการป้องกัน |
โปรดดูเอกสารอ้างอิง API เพื่อดูว่าต้องกรอกช่องใดบ้าง
|
|---|
|
|
RESOURCE_LIMIT |
| สรุป | คำขอพยายามสร้างทรัพยากรที่จะทำให้จำนวนทรัพยากรทั้งหมดเกินขีดจำกัดที่ระบุ |
|---|
| สาเหตุที่พบได้ทั่วไป |
จำนวนทรัพยากรที่สามารถมีอยู่ในบริบทบางอย่างมีข้อจำกัดหลายประการ
|
|---|
| วิธีจัดการ |
ระบุขีดจำกัดที่พบโดยดูขีดจำกัดของระบบ คุณจะนำทรัพยากรที่มีอยู่มาใช้ซ้ำ หรือนำทรัพยากรออกเพื่อสร้างพื้นที่สำหรับทรัพยากรใหม่ก็ได้
|
|---|
| คำแนะนำการป้องกัน |
ใช้คำค้นหาเพื่อตรวจสอบจำนวนทรัพยากรที่มีข้อจำกัด
|
|---|
|
|
TOO_LONG |
| สรุป | สตริงที่กำหนดให้กับฟิลด์ที่ระบุมีความยาวเกินขีดจำกัด |
|---|
| สาเหตุที่พบได้ทั่วไป |
บรรทัดแรกหรือคำอธิบายสำหรับโฆษณามีข้อความมากเกินไป
|
|---|
| วิธีจัดการ |
ระบุขีดจำกัดที่พบ แก้ไขสตริงตามนั้น แล้วส่งคำขออีกครั้ง
|
|---|
| คำแนะนำการป้องกัน |
โปรดทราบขีดจำกัดความยาวของสตริง
|
|---|
|
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-31 UTC
[null,null,["อัปเดตล่าสุด 2025-08-31 UTC"],[[["\u003cp\u003eThe Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting.\u003c/p\u003e\n"],["\u003cp\u003eCommon causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines.\u003c/p\u003e\n"],["\u003cp\u003eSuggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors.\u003c/p\u003e\n"],["\u003cp\u003eUnderstanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them.\u003c/p\u003e\n"]]],[],null,[]]
