เนื่องจาก Google Forms API เป็นบริการที่ใช้ร่วมกัน เราจึงใช้โควต้าและข้อจำกัดเพื่อให้แน่ใจว่าผู้ใช้ทุกคนจะใช้งานอย่างเป็นธรรมและเพื่อปกป้องประสิทธิภาพโดยรวมของระบบ Google Workspace
หากคุณใช้งานเกินโควต้า โดยทั่วไปคุณจะได้รับการตอบกลับเป็นรหัสสถานะ HTTP 429: Too many requests หากเกิดกรณีนี้ขึ้น คุณควรใช้อัลกอริทึม Exponential Backoff แล้วลองอีกครั้งในภายหลัง หากคุณไม่ใช้เกินโควต้าต่อนาทีด้านล่าง ก็จะไม่มีการจำกัดจำนวนคำขอที่คุณทำได้ต่อวัน
หมายเหตุ: การเฝ้าติดตามแบบฟอร์มมีขีดจำกัดเพิ่มเติม ดูข้อมูลเพิ่มเติมได้ที่หัวข้อตั้งค่าและรับข้อความ Push
ตารางต่อไปนี้แสดงรายละเอียดขีดจำกัดของคำขอ
| โควต้า | |||||||
|---|---|---|---|---|---|---|---|
| คำขอที่อ่าน |
|
||||||
|
คำขออ่านที่มีค่าใช้จ่ายสูง
(ใช้สำหรับคำขอ |
|
||||||
| คำขอที่เขียน |
|
||||||
แก้ไขข้อผิดพลาดเกี่ยวกับโควต้าตามเวลา
สำหรับข้อผิดพลาดที่อิงตามเวลาทั้งหมด (คำขอสูงสุด N รายการต่อ X นาที) เราขอแนะนำให้โค้ดของคุณตรวจจับข้อยกเว้นและใช้ Truncated Exponential Backoff เพื่อให้แน่ใจว่าอุปกรณ์จะไม่สร้างภาระงานมากเกินไป
Exponential Backoff เป็นกลยุทธ์การจัดการข้อผิดพลาดมาตรฐานสำหรับแอปพลิเคชันเครือข่าย อัลกอริทึม Exponential Backoff จะลองส่งคำขออีกครั้งโดยใช้เวลารอที่เพิ่มขึ้นแบบทวีคูณระหว่างคำขอแต่ละรายการ จนถึงเวลา Backoff สูงสุด หากคำขอยังคงไม่สำเร็จ คุณต้องเพิ่มความล่าช้าระหว่างคำขอเมื่อเวลาผ่านไปจนกว่าคำขอจะสำเร็จ
ตัวอย่างอัลกอริทึม
อัลกอริทึม Exponential Backoff จะลองส่งคำขอซ้ำแบบทวีคูณ โดยเพิ่มเวลารอระหว่างการลองใหม่จนถึงเวลา Backoff สูงสุด เช่น
- ส่งคำขอไปยัง Google Forms API
- หากคำขอล้มเหลว ให้รอ 1 +
random_number_millisecondsแล้วลองส่งคำขออีกครั้ง - หากคำขอล้มเหลว ให้รอ 2 +
random_number_millisecondsแล้วลองส่งคำขออีกครั้ง - หากคำขอล้มเหลว ให้รอ 4 +
random_number_millisecondsแล้วลองส่งคำขออีกครั้ง - และอื่นๆ จนถึงครั้งที่
maximum_backoff - รอต่อไปและลองใหม่จนกว่าจะถึงจำนวนครั้งสูงสุดที่อนุญาต แต่ไม่ต้องเพิ่มระยะเวลารอระหว่างการลองใหม่แต่ละครั้ง
โดยที่
- เวลารอคือ
min(((2^n)+random_number_milliseconds), maximum_backoff)โดยnจะเพิ่มขึ้น 1 สำหรับการทำซ้ำ (คำขอ) แต่ละครั้ง random_number_millisecondsคือจำนวนมิลลิวินาทีแบบสุ่มที่น้อยกว่าหรือเท่ากับ 1,000 ซึ่งจะช่วยหลีกเลี่ยงกรณีที่ไคลเอ็นต์จำนวนมากซิงค์ข้อมูลตามสถานการณ์บางอย่างและลองใหม่ทั้งหมดพร้อมกัน โดยส่งคำขอเป็นคลื่นที่ซิงค์ข้อมูล ระบบจะคำนวณค่าของrandom_number_millisecondsใหม่หลังจากคำขอให้ลองอีกครั้งแต่ละรายการmaximum_backoffมักจะมีความยาว 32 หรือ 64 วินาที ค่าที่เหมาะสมจะขึ้นอยู่กับกรณีการใช้งาน
ไคลเอ็นต์จะลองอีกครั้งได้หลังจากถึงเวลา maximum_backoff
การลองใหม่หลังจากจุดนี้ไม่จำเป็นต้องเพิ่มเวลา Backoff ต่อไป ตัวอย่างเช่น หากไคลเอ็นต์ใช้เวลา maximum_backoff 64 วินาที หลังจากถึงค่านี้แล้ว ไคลเอ็นต์จะลองใหม่ได้ทุกๆ 64 วินาที เมื่อถึงจุดหนึ่ง คุณควรป้องกันไม่ให้ไคลเอ็นต์ลองใหม่ไปเรื่อยๆ อย่างไม่มีที่สิ้นสุด
เวลารอระหว่างการลองใหม่และจำนวนครั้งที่ลองใหม่จะขึ้นอยู่กับ Use Case และสภาพเครือข่ายของคุณ
ราคา
การใช้งาน Google Forms API แบบมาตรฐานทั้งหมดจะไม่มีค่าใช้จ่ายเพิ่มเติม เราวางแผนที่จะเรียกเก็บเงินจากบัญชีสำหรับการเรียกเก็บเงินใน Google Cloud ของคุณในภายหลังในปี 2026 หากคำขอเกินขีดจำกัดโควต้า ดูข้อมูลเพิ่มเติมได้ที่โมเดลมาตรฐานของ Google Workspace สำหรับเครื่องมือและ API ของ Agent
ขอเพิ่มโควต้า
คุณอาจต้องขอปรับโควต้า ทั้งนี้ขึ้นอยู่กับการใช้ทรัพยากรของโปรเจ็กต์ การเรียก API โดยบัญชีบริการจะถือว่าเป็นการใช้บัญชีเดียว การขอปรับโควต้าอาจไม่ได้รับการอนุมัติเสมอไป คำขอปรับโควต้าที่เพิ่มค่าโควต้าอย่างมีนัยสำคัญอาจใช้เวลานานกว่าจะได้รับอนุมัติ
โปรเจ็กต์ทั้งหมดมีโควต้าไม่เท่ากัน เมื่อคุณใช้ Google Cloud มากขึ้นเรื่อยๆ คุณอาจต้องเพิ่มค่าโควต้า หากคาดว่าการใช้งานจะเพิ่มขึ้นอย่างเห็นได้ชัดในอนาคต คุณสามารถขอปรับโควต้าล่วงหน้าได้จากหน้าโควต้าและขีดจำกัดของระบบในคอนโซล Google Cloud
ดูข้อมูลเพิ่มเติมได้ที่แหล่งข้อมูลต่อไปนี้