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

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

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

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