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

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

คำขอ API ล้มเหลว

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

ข้อผิดพลาดเกี่ยวกับเวลา

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

ข้อจำกัด

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

ข้อจำกัดประเภทอื่นๆ

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