ขีดจํากัดการใช้งาน 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
คำอธิบายกลุ่ม ขนาดสูงสุด	คุณจะป้อนคำอธิบายกลุ่มได้สูงสุด 300 อักขระ
ชื่อกลุ่ม ขนาดสูงสุด	ชื่อกลุ่มมีอักขระได้สูงสุด 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