ขีดจํากัดการใช้งาน 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 สำหรับเทรดเดียวคือรอ 5 วินาทีแล้วลองเรียกใช้ที่ล้มเหลวอีกครั้ง หากคำขอสำเร็จ ให้ทำซ้ำรูปแบบนี้สำหรับชุดข้อความอื่นๆ หากคำขอครั้งที่ 2 ไม่สำเร็จ แอปพลิเคชันควรลดความถี่ของคำขอลงจนกว่าการเรียกจะสำเร็จ เช่น เพิ่มความล่าช้า 5 วินาทีแรกเป็น 10 วินาที แล้วลองเรียกใช้ที่ล้มเหลวอีกครั้ง นอกจากนี้ ให้กำหนดขีดจำกัดการลองใหม่ด้วย เช่น ลองส่งคำขออีกครั้ง 5-7 ครั้งโดยมีระยะเวลาหน่วงที่แตกต่างกันก่อนที่แอปพลิเคชันจะแสดงข้อผิดพลาดแก่ผู้ใช้

โควต้า

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

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

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

ขีดจำกัด

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