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

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