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

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

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

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