ขีดจำกัดการใช้งาน

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

หากใช้โควต้าเกิน โดยทั่วไปคุณจะได้รับ429: Too many requestsการตอบกลับรหัสสถานะ HTTP หากเกิดกรณีเช่นนี้ คุณควรใช้อัลกอริทึม Exponential Backoff แล้วลองอีกครั้งในภายหลัง

ตารางต่อไปนี้แสดงรายละเอียดขีดจํากัดของคําขอ

โควต้า
คำขอที่อ่าน	ต่อนาทีต่อโปรเจ็กต์ 3000 ต่อนาทีต่อผู้ใช้ต่อโปรเจ็กต์ 300
คำขอที่เขียน	ต่อนาทีต่อโปรเจ็กต์ 600 ต่อนาทีต่อผู้ใช้ต่อโปรเจ็กต์ 60

แก้ไขข้อผิดพลาดเกี่ยวกับโควต้าตามเวลา

สำหรับข้อผิดพลาดทั้งหมดตามเวลา (คำขอสูงสุด N รายการต่อ X นาที) เราขอแนะนำให้โค้ดของคุณจับข้อยกเว้นและใช้การหน่วงเวลาแบบทวีคูณแบบตัดเศษเพื่อให้อุปกรณ์ไม่สร้างภาระมากเกินไป

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

ตัวอย่างอัลกอริทึม

อัลกอริทึม Exponential Backoff จะส่งคำขอซ้ำแบบทวีคูณ โดยจะเพิ่มเวลารอระหว่างการส่งซ้ำสูงสุดถึงเวลา Backoff สูงสุด เช่น

1. ส่งคำขอไปยัง Google Docs API
2. หากคำขอไม่สำเร็จ ให้รอ 1 + random_number_milliseconds แล้วลองส่งคำขออีกครั้ง
3. หากคำขอไม่สำเร็จ ให้รอ 2 + random_number_milliseconds แล้วลองส่งคำขออีกครั้ง
4. หากคำขอไม่สำเร็จ ให้รอ 4 + random_number_milliseconds แล้วลองส่งคำขออีกครั้ง
5. และอื่นๆ สูงสุด maximum_backoff ครั้ง
6. รอต่อไปและลองใหม่จนถึงจำนวนครั้งสูงสุด แต่อย่าเพิ่มระยะเวลารอระหว่างการลองใหม่

where:

• เวลารออยู่ที่ min(((2^n)+random_number_milliseconds), maximum_backoff) โดย n จะเพิ่มขึ้น 1 รายการสําหรับแต่ละรอบ (คําขอ)
• random_number_milliseconds คือจำนวนมิลลิวินาทีแบบสุ่มที่น้อยกว่าหรือเท่ากับ 1,000 ซึ่งจะช่วยหลีกเลี่ยงกรณีที่ไคลเอ็นต์จำนวนมากซิงค์ข้อมูลในบางสถานการณ์ และลองใหม่ทั้งหมดพร้อมกันโดยส่งคำขอใน Wave ที่ซิงค์ ระบบจะคำนวณค่าของ random_number_milliseconds ใหม่หลังจากส่งคำขอลองอีกครั้งแต่ละครั้ง
• maximum_backoff มักจะมีความยาว 32 หรือ 64 วินาที ค่าที่เหมาะสมจะขึ้นอยู่กับกรณีการใช้งาน

ลูกค้าจะลองอีกครั้งได้หลังจากที่ถึงเวลา maximum_backoff การลองใหม่หลังจากนี้ไม่จำเป็นต้องเพิ่มเวลาพัก ตัวอย่างเช่น หากไคลเอ็นต์ใช้เวลา maximum_backoff 64 วินาที หลังจากถึงค่านี้ ไคลเอ็นต์จะลองอีกครั้งทุก 64 วินาที เมื่อถึงจุดหนึ่ง ระบบควรป้องกันไม่ให้ไคลเอ็นต์ลองอีกครั้งอย่างไม่มีกำหนด

ระยะเวลารอระหว่างการลองอีกครั้งและจำนวนครั้งที่ลองใหม่จะขึ้นอยู่กับกรณีการใช้งานและสภาพเครือข่าย

ราคา

การใช้ Google เอกสาร API ทั้งหมดจะใช้งานได้โดยไม่มีค่าใช้จ่ายเพิ่มเติม การขอโควต้าเกินขีดจํากัดจะไม่ทำให้เกิดค่าใช้จ่ายเพิ่มเติมและระบบจะไม่เรียกเก็บเงินจากบัญชีของคุณ

ขอเพิ่มโควต้า

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

โปรเจ็กต์บางรายการมีโควต้าเหมือนกันไม่ได้ เมื่อคุณใช้ Google Cloud มากขึ้นเรื่อยๆ โควต้าอาจต้องเพิ่มขึ้น หากคาดว่าจะมีการใช้งานเพิ่มขึ้นอย่างมากในอนาคต คุณขอปรับโควต้าจากหน้าโควต้าในคอนโซล Google Cloud ได้

ดูข้อมูลเพิ่มเติมได้ที่แหล่งข้อมูลต่อไปนี้

• เกี่ยวกับคำขอเพิ่มโควต้า
• ดูการใช้งานโควต้าและขีดจํากัดปัจจุบัน
• ขอเพิ่มขีดจำกัดโควต้า