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

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

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