ขีดจํากัดการใช้งาน API

ขีดจํากัดและโควต้าจะปกป้องโครงสร้างพื้นฐานของ Google จากกระบวนการอัตโนมัติที่ใช้ Groups Settings API อย่างไม่เหมาะสม คําขอที่มากเกินไปจาก API อาจเกิดจากการพิมพ์ผิดหรือระบบที่ออกแบบมาไม่ดีซึ่งทําให้เกิดการเรียก API ที่ไม่จําเป็น ไม่ว่าจะด้วยสาเหตุใดก็ตาม การบล็อกการเข้าชมจากแหล่งที่มาที่เฉพาะเจาะจงเมื่อมาถึงระดับหนึ่งจึงจําเป็นต่อการทํางานโดยรวมของระบบ Google Workspace

คําขอ API ล้มเหลว

ในกรณีที่คําขอ API ล้มเหลว แอปพลิเคชันของคุณจะได้รับการตอบกลับรหัสสถานะ HTTP รหัสสถานะ HTTP ของ 403 มีข้อมูลข้อผิดพลาดที่ระบุว่าโควต้า API เกินโควต้า การตอบกลับจะช่วยให้แอปพลิเคชันที่กําหนดเองตรวจหาข้อผิดพลาดและดําเนินการตามความเหมาะสม

คําขอตามเวลา

หากต้องการดําเนินการให้เสร็จในระยะเวลาที่กําหนด ให้ส่งคําขอพร้อมกันหรือใช้ชุดข้อความหลายรายการในแอปพลิเคชัน Java หรือ C# เช่น แยกคําขอตามเดือนหรือ ช่วงเวลาอื่น ในกรณีของชุดข้อความ ให้ลองใช้ชุดข้อความ 10 รายการ 1 ชุดต่อคําขอ คําแนะนําชุดข้อความมีข้อดีและข้อเสียไม่มีประโยชน์ต่อสถานการณ์ API ทั้งหมด หากจํานวนคําขอสูงเกินไป ข้อผิดพลาดของโควต้าจะเกิดขึ้น

ข้อผิดพลาดตามเวลา

สําหรับข้อผิดพลาดทั้งหมดที่อิงตามเวลา (ไม่เกิน N รายการต่อ X วินาทีต่อชุดข้อความ) โดยเฉพาะข้อผิดพลาดของรหัสสถานะ 503 เราแนะนําให้โค้ดยกเว้นข้อยกเว้นดังกล่าว และโดยใช้อัลกอริทึม Exponential Backoff แล้วรอสักพักก่อนที่จะลองเรียกใช้อีกครั้ง ตัวอย่างของ Groups Settings API สําหรับชุดข้อความ 1 ชุดคือให้รอ 5 วินาทีแล้วลองเรียกสายที่ล้มเหลวอีกครั้ง หากคําขอสําเร็จ ให้ใช้รูปแบบนี้กับเทรดอื่นซ้ํา หากคําขอครั้งที่ 2 ไม่สําเร็จ แอปพลิเคชันควรลดความถี่ของคําขอลงจนกว่าจะโทรสําเร็จ ตัวอย่างเช่น เพิ่มการหน่วงเวลาเริ่มต้น 5 วินาทีเป็น 10 วินาที แล้วลองโทรที่ไม่สําเร็จอีกครั้ง แล้วตัดสินใจเลือกข้อจํากัดในการลองอีกครั้ง ตัวอย่างเช่น ลองส่งคําขอซ้ํา 5 ถึง 7 ครั้งโดยมีความล่าช้าแตกต่างกันก่อนที่แอปพลิเคชันจะส่งคืนข้อผิดพลาดให้ผู้ใช้

โควต้า

หมวดหมู่โควต้าของ API โควต้า
การค้นหาต่อวัน

คุณสร้างคําค้นหาได้สูงสุด 100,000 รายการต่อวัน หากต้องการรองรับการใช้งานเกินขีดจํากัดนี้ คุณสามารถส่งคําขอได้จากหน้าโควต้าใน Google Cloud Console

คําอธิบายกลุ่ม ขนาดสูงสุด คุณจะป้อนคําอธิบายกลุ่มได้สูงสุด 300 อักขระ
ชื่อกลุ่ม ขนาดสูงสุด ชื่อกลุ่มมีอักขระได้สูงสุด 60 ตัว
defaultMessageDenyNotificationText ข้อความการแจ้งเตือนมีความยาวได้ไม่เกิน 10,000 อักขระ ดูข้อมูลเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ defaultMessageDenyNotificationText ได้ที่ข้อมูลอ้างอิง API
maxMessageBytes ขนาดสูงสุดของข้อความเริ่มต้นคือ 1 MB ดูข้อมูลเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ maxMessageBytes ได้ที่ข้อมูลอ้างอิง API

ข้อจำกัด

ประเภทของขีดจํากัด ข้อจํากัดและหลักเกณฑ์
รูปแบบข้อมูล ค่าเริ่มต้น
รูปแบบข้อมูลเริ่มต้นคือ JSON API รองรับรูปแบบ Atom ด้วย ทั้งข้อมูล JSON และ Atom รองรับความสามารถในการอ่านเต็ม ดูข้อมูลเพิ่มเติมได้ที่รูปแบบข้อมูล JSON และ Atom
การตั้งค่า Groups API, การเปิดใช้ คุณต้องเปิด Directory API ก่อนเรียกใช้ Groups Settings API โปรดดูข้อมูลเพิ่มเติมที่หัวข้อเปิดใช้ Google Workspace API