ขีดจํากัดและโควต้า

ขีดจำกัดและโควต้าจะปกป้องโครงสร้างพื้นฐานของ Google จากกระบวนการอัตโนมัติที่ใช้ Enterprise License Manager API ในลักษณะที่ไม่เหมาะสม คำขอที่มากเกินไปจาก API อาจเป็นผลมาจากการพิมพ์ผิดที่ไม่เป็นอันตราย หรืออาจเกิดจากระบบที่ออกแบบมาอย่างไม่มีประสิทธิภาพซึ่งทำให้เรียก API ได้โดยไม่จำเป็น ไม่ว่าสาเหตุเกิดจากสาเหตุใด การบล็อกการเข้าชมจากแหล่งที่มาหนึ่งๆ เมื่อถึงเกณฑ์หนึ่งๆ เป็นสิ่งจำเป็นต่อประสิทธิภาพโดยรวมของระบบ Google Workspace การดำเนินการของนักพัฒนาซอฟต์แวร์ 1 รายจะไม่ส่งผลเสียต่อชุมชนขนาดใหญ่

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

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

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

หมวดหมู่โควต้า API	โควต้า
จำนวนคำค้นหาต่อวินาที (QPS)	โควต้า QPS คือ 1

หมวดหมู่ขีดจำกัด API	ข้อจำกัด
สตริงการค้นหา max Results	ขนาดสูงสุดของ max Results คือ 100

ข้อจำกัดประเภทอื่นๆ	ข้อจำกัดและหลักเกณฑ์
คำขอแบบกลุ่ม	API รองรับการส่งคำขอแบบกลุ่ม
รูปแบบข้อมูลในการตอบกลับจาก API	รูปแบบข้อมูลการตอบสนองคือ JavaScript Object Notation (JSON)
การเปิดใช้ Enterprise License Manager API	ต้องเปิดใช้ API การจัดสรรก่อนเรียกใช้ Enterprise License Manager API ในแผงควบคุม ให้ไปที่หน้าการตั้งค่าของแท็บผู้ใช้และกลุ่ม และเปิดใช้ API การจัดเตรียมข้อมูล บันทึกการเปลี่ยนแปลง นอกจากนี้ จะต้องเปิดใช้งานและเปิดใช้งานบริการ Google Groups
คำขอที่ไม่ได้รับอนุญาต	API จะไม่ยอมรับคำขอที่ไม่ได้รับอนุญาต ระบบจะถือว่าคำขอไม่ได้รับอนุญาตหากไม่มีการให้โทเค็นการให้สิทธิ์ ดูข้อมูลเพิ่มเติมได้ที่การให้สิทธิ์คำขอ