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

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

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 วัน คำแนะนำการป้องกัน ดูแอปที่ไม่ได้รับการยืนยัน

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	สรุป ใช้โอเปอเรเตอร์นี้กับคลาสย่อยของโฆษณาไม่ได้ สาเหตุที่พบได้ทั่วไป พยายามแก้ไขแอตทริบิวต์อื่นๆ นอกเหนือจาก status ของโฆษณา วิธีจัดการ ไม่มี คำแนะนำการป้องกัน เมื่อสร้างโฆษณาแล้ว คุณจะแก้ไขไม่ได้ หากต้องการแก้ไขโฆษณา คุณต้องสร้างโฆษณาใหม่แล้วนําโฆษณาเก่าออก แต่คุณสามารถแก้ไข status ของโฆษณาได้โดยใช้ MutateAdGroupAds
INVALID_INPUT	สรุป ฟิลด์อย่างน้อย 1 รายการในโฆษณามีอักขระที่ไม่ถูกต้อง สาเหตุที่พบได้ทั่วไป การใช้สัญลักษณ์พิเศษใน URL วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ตรวจสอบ URL ในแอปก่อนส่งคำขอ API
LINE_TOO_WIDE	สรุป ฟิลด์หนึ่งในโฆษณามีความยาวเกินความยาวสูงสุดที่อนุญาต ดูเกี่ยวกับโฆษณาแบบข้อความ สาเหตุที่พบได้ทั่วไป มีข้อความยาวเกินไป วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ตรวจสอบความยาวของบรรทัดก่อนส่งคำขอ API

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	สรุป ป้ายกำกับนี้เชื่อมโยงกับโฆษณาบางรายการแล้ว สาเหตุที่พบได้ทั่วไป พยายามเชื่อมโยงป้ายกำกับกับโฆษณาที่เชื่อมโยงแล้ว วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ก่อนอื่นให้ตรวจสอบว่าป้ายกำกับที่จะเพิ่มเชื่อมโยงกับโฆษณาอยู่แล้วหรือไม่
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	สรุป การดำเนินการพยายามอัปเดตโฆษณาที่ถูกนำออก สาเหตุที่พบได้ทั่วไป เมื่อนำโฆษณาออกแล้ว คุณจะอัปเดตโฆษณาไม่ได้อีกต่อไป รวมถึงการเปลี่ยนแปลงสถานะของโฆษณาด้วย วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ตรวจสอบว่าโค้ดไม่ได้พยายามอัปเดตโฆษณาที่ถูกนำออก

AdGroupCriterionError
INVALID_KEYWORD_TEXT	สรุป ข้อความคีย์เวิร์ดมีอักขระที่ไม่ถูกต้อง ดูเพิ่มคีย์เวิร์ด สาเหตุที่พบได้ทั่วไป ข้อความคีย์เวิร์ดมีอักขระที่ไม่ถูกต้อง วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ตรวจสอบข้อความคีย์เวิร์ดในแอปก่อนส่งคำขอไปยัง API

AdGroupError
DUPLICATE_ADGROUP_NAME	สรุป มีการเพิ่มหรือเปลี่ยนชื่อกลุ่มโฆษณา แต่มีกลุ่มโฆษณาอื่นใช้ชื่อนั้นอยู่แล้ว สาเหตุที่พบได้ทั่วไป การสร้างกลุ่มโฆษณาใหม่โดยใช้ชื่อของกลุ่มโฆษณาที่ใช้งานอยู่หรือหยุดชั่วคราว วิธีจัดการ บันทึกข้อผิดพลาดและแสดงข้อความแสดงข้อผิดพลาดต่อผู้ใช้ โดยอาจแนะนำชื่อกลุ่มโฆษณาที่ไม่ซ้ำกันหรือแสดงรายการชื่อที่ใช้อยู่ คำแนะนำการป้องกัน ไม่มี

AssetError
DUPLICATE_ASSET	สรุป การดำเนินการ 2 รายการในคำขอเดียวมีการดำเนินการสร้างสำหรับชิ้นงานที่มีข้อมูลไบนารีเดียวกัน สาเหตุที่พบได้ทั่วไป คำขอเปลี่ยนแปลงที่มีการดำเนินการสร้างที่ซ้ำกันซึ่งมีข้อมูลไบนารีเดียวกัน วิธีจัดการ สร้างชิ้นงานในคำขอแยกต่างหาก จากนั้นลิงก์ไปยังชิ้นงานในคำขอถัดไป หรือใช้รหัสชั่วคราวภายในคำขอเดียวกัน คำแนะนำการป้องกัน ไม่มี

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

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

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	สรุป ค่าเสนอราคาไม่ใช่ผลคูณที่แน่นอนของหน่วยขั้นต่ำของสกุลเงินของบัญชี เช่น US$ 0.015 (15000 ในหน่วยไมโคร) ไม่ใช่ราคาเสนอที่ถูกต้อง สาเหตุที่พบได้ทั่วไป ไม่มี วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ตรวจสอบว่าราคาเสนอเป็นทวีคูณของหน่วยขั้นต่ำสำหรับสกุลเงินของบัญชี
BID_TOO_BIG	สรุป ระบบจะแสดงข้อผิดพลาดแม้ว่าราคาเสนอจะอยู่ภายในงบประมาณของแคมเปญก็ตาม สาเหตุที่พบได้ทั่วไป ไม่มี วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ตรวจสอบว่าบัญชีเข้าร่วม Google Ad Grants หรือไม่ หากเป็นเช่นนั้น ให้จำกัดราคาเสนอ CPC เป็นสูงสุดที่โปรแกรมกำหนด

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	สรุป จำนวนงบประมาณน้อยเกินไป สาเหตุที่พบได้ทั่วไป ไม่มี วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ตรวจสอบว่าจำนวนงบประมาณมากกว่าหรือเท่ากับหน่วยขั้นต่ำสำหรับสกุลเงินของบัญชี
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	สรุป จำนวนงบประมาณจะมีทศนิยมที่สำคัญมากเกินไปเมื่อแปลงจากจำนวนเงินเล็กน้อยเป็นจำนวนเงินในสกุลเงินของบัญชี สาเหตุที่พบได้ทั่วไป ไม่มี วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ตรวจสอบว่าจำนวนงบประมาณหารด้วยหน่วยขั้นต่ำของสกุลเงินของบัญชีได้ลงตัว

CampaignError
DUPLICATE_CAMPAIGN_NAME	สรุป มีการเพิ่มหรือเปลี่ยนชื่อแคมเปญ แต่มีแคมเปญอื่นใช้ชื่อนั้นอยู่แล้ว สาเหตุที่พบได้ทั่วไป การสร้างแคมเปญใหม่โดยใช้ชื่อของแคมเปญที่ใช้งานอยู่หรือหยุดชั่วคราว วิธีจัดการ บันทึกข้อผิดพลาดและแสดงข้อความแสดงข้อผิดพลาดต่อผู้ใช้ โดยอาจแนะนำชื่อแคมเปญที่ไม่ซ้ำกันหรือแสดงรายการชื่อที่ใช้อยู่ คำแนะนำการป้องกัน ไม่มี

CriterionError
KEYWORD_HAS_INVALID_CHARS	สรุป การเพิ่มหรือแก้ไขคีย์เวิร์ดที่มีอักขระที่ไม่ถูกต้อง สาเหตุที่พบได้ทั่วไป ใช้สัญลักษณ์พิเศษ เช่น ! @ % * ในคีย์เวิร์ด วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ตรวจสอบว่าคุณไม่ได้ใช้อักขระที่ไม่ได้รับอนุญาตในคีย์เวิร์ด ดูเพิ่มคีย์เวิร์ด

DistinctError
DUPLICATE_ELEMENT	สรุป คำขอมีพารามิเตอร์ 2 รายการที่เหมือนกันและซ้ำซ้อน สาเหตุที่พบได้ทั่วไป ไม่มี วิธีจัดการ ไม่มี คำแนะนำการป้องกัน นํารายการที่ซ้ำกัน (การดำเนินการ พารามิเตอร์ องค์ประกอบรายการ) ออกก่อนส่งคำขอ มองหาฟิลด์ที่มีข้อจำกัด DistinctElements

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

MutateError

RESOURCE_NOT_FOUND

สรุป คำขออ้างอิงถึงทรัพยากรที่ไม่พบ สาเหตุที่พบได้ทั่วไป คำขอพยายามเปลี่ยนแปลงหรืออ้างอิงทรัพยากรที่ไม่มีอยู่หรือถูกนำออกไปแล้ว หรือชื่อทรัพยากรที่ระบุสำหรับทรัพยากรนั้นผิดรูปแบบ วิธีจัดการ ใช้คำขอค้นหาเพื่อดึงชื่อทรัพยากรสำหรับทรัพยากรที่มีอยู่ก่อนส่งคำขอเปลี่ยนแปลง อ่านคำแนะนำเกี่ยวกับคลังของไคลเอ็นต์ ซึ่งรวมถึงเอกสารประกอบเกี่ยวกับวิธีสร้างชื่อทรัพยากรที่ถูกต้องในทุกภาษาที่รองรับ คำแนะนำการป้องกัน อย่าสร้างชื่อทรัพยากรด้วยตนเอง ใช้วิธีการช่วยอย่างใดอย่างหนึ่งที่ไลบรารีของไคลเอ็นต์ของเรามีให้

NotEmptyError
EMPTY_LIST	สรุป รายการที่จำเป็นว่างเปล่า สาเหตุที่พบได้ทั่วไป ส่งรายการการดำเนินการที่ว่างเปล่าไปยังเมธอด mutate วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ไม่มี

QuotaError
RESOURCE_EXHAUSTED	สรุป เกินขีดจำกัดความถี่ของระบบ สาเหตุที่พบได้ทั่วไป ไม่มี วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ตั้งค่าการหน่วงเวลาสั้นๆ ระหว่างคำขอ หรือรวมการดำเนินการหลายอย่างไว้ในคำขอจำนวนน้อยลง

RangeError
TOO_LOW	สรุป ค่าต่ำกว่าค่าต่ำสุดที่อนุญาต สาเหตุที่พบได้ทั่วไป ลืมระบุรหัส ซึ่งส่งผลให้มีการส่งค่า 0 วิธีจัดการ ไม่มี คำแนะนำการป้องกัน โปรดทราบข้อจำกัดของช่วงที่ระบุไว้ในข้อมูลอ้างอิง API

RequestError
INVALID_INPUT	สรุป คำขอมีรูปแบบไม่ถูกต้อง สาเหตุที่พบได้ทั่วไป URL หรือเนื้อหาของคำขอมีรูปแบบไม่ถูกต้อง วิธีจัดการ ไม่มี คำแนะนำการป้องกัน ไม่มี
REQUIRED_FIELD_MISSING	สรุป คำขอไม่มีข้อมูลที่จำเป็น สาเหตุที่พบได้ทั่วไป โปรดกรอกข้อมูลในช่องที่ต้องกรอกเมื่อพยายามเพิ่มเอนทิตี วิธีจัดการ บันทึกข้อผิดพลาดและแสดงข้อความแสดงข้อผิดพลาดต่อผู้ใช้ แอตทริบิวต์ fieldPath ของข้อผิดพลาดจะระบุฟิลด์ที่ขาดหายไป คำแนะนำการป้องกัน โปรดดูเอกสารอ้างอิง API เพื่อดูว่าต้องกรอกช่องใดบ้าง

ResourceCountLimitExceededError
RESOURCE_LIMIT	สรุป คำขอพยายามสร้างทรัพยากรที่จะทำให้จำนวนทรัพยากรทั้งหมดเกินขีดจำกัดที่ระบุ สาเหตุที่พบได้ทั่วไป จำนวนทรัพยากรที่สามารถมีอยู่ในบริบทบางอย่างมีข้อจำกัดหลายประการ วิธีจัดการ ระบุขีดจำกัดที่พบโดยดูขีดจำกัดของระบบ คุณจะนำทรัพยากรที่มีอยู่มาใช้ซ้ำ หรือนำทรัพยากรออกเพื่อสร้างพื้นที่สำหรับทรัพยากรใหม่ก็ได้ คำแนะนำการป้องกัน ใช้คำค้นหาเพื่อตรวจสอบจำนวนทรัพยากรที่มีข้อจำกัด

StringLengthError
TOO_LONG	สรุป สตริงที่กำหนดให้กับฟิลด์ที่ระบุมีความยาวเกินขีดจำกัด สาเหตุที่พบได้ทั่วไป บรรทัดแรกหรือคำอธิบายสำหรับโฆษณามีข้อความมากเกินไป วิธีจัดการ ระบุขีดจำกัดที่พบ แก้ไขสตริงตามนั้น แล้วส่งคำขออีกครั้ง คำแนะนำการป้องกัน โปรดทราบขีดจำกัดความยาวของสตริง