ขีดจำกัดและโควต้าการใช้งาน

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

คำขอ API ไม่สำเร็จ

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

ข้อผิดพลาดที่อิงตามเวลา

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

จำกัดสูงสุด

หมวดหมู่ขีดจำกัด API	จำกัดสูงสุด
การติดตาม purchaseOrderId	พร็อพเพอร์ตี้นี้รับอักขระข้อความธรรมดาได้สูงสุด 80 ตัว
การติดตาม maxResults	maxResults สตริงการค้นหาอาจมีผลลัพธ์ 1-100 รายการ ค่าเริ่มต้นคือ 20 ผลการค้นหา
โทเค็นการโอน (customerAuthToken)	โทเค็นการโอนของลูกค้าจะมีอายุ 30 วันหลังจากที่สร้าง
จำนวนผู้ใช้สูงสุดสำหรับลูกค้า	จำนวนผู้ใช้สูงสุดอาจเป็น 50,000 หรือจำนวนสูงสุดที่กำหนดไว้ในสัญญาตัวแทนจำหน่าย ของคุณ ทั้งนี้ขึ้นอยู่กับสัญญา ของคุณ
คำขอที่ไม่ได้รับอนุญาต	Google ไม่อนุญาตคำขอที่ไม่ได้รับอนุญาตไปยัง Reseller API ระบบจะถือว่าคำขอไม่ได้รับอนุญาตหากไม่มีโทเค็นการให้สิทธิ์ ดูข้อมูลเพิ่มเติมได้ที่ดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์

โควต้าประเภทอื่นๆ

โควต้าประเภทอื่นๆ	ข้อจำกัดและหลักเกณฑ์
รูปแบบข้อมูล	รูปแบบข้อมูลอยู่ใน JavaScript Object Notation JSON JSON เป็นรูปแบบอินเทอร์เน็ตทั่วไปที่ให้วิธีการ แสดงโครงสร้างข้อมูลที่กำหนดเอง JSON เป็น รูปแบบข้อความที่ไม่ขึ้นอยู่กับภาษาใดๆ แต่ใช้รูปแบบ ที่คุ้นเคยสำหรับโปรแกรมเมอร์ในตระกูลภาษา C ซึ่งรวมถึง C, C++, C#, Java, JavaScript, Perl และ Python
รูปแบบเวลา	วันที่และเวลาทั้งหมดอยู่ในตัวแปลง Epoch ในหน่วยมิลลิวินาที รูปแบบนี้ใช้กับค่าของเวลาสร้างการสมัครใช้บริการ เวลาเริ่มต้นและเวลาสิ้นสุดของสัญญาผูกมัดของแพ็กเกจ และเวลาสิ้นสุดของช่วงทดลองใช้ฟรี 30 วัน