ขีดจำกัดและโควต้าจะช่วยปกป้องโครงสร้างพื้นฐานของ 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 |