ขีดจำกัดและโควต้าช่วยปกป้องโครงสร้างพื้นฐานของ Google จากกระบวนการอัตโนมัติ ที่ใช้ Alert Center API ในทางที่ไม่เหมาะสม คำขอที่มากเกินไป จาก API อาจเกิดจากการพิมพ์ผิดที่ไม่มีอันตราย หรืออาจเกิดจาก ระบบที่ออกแบบมาอย่างไม่มีประสิทธิภาพซึ่งทำให้มีการเรียก API โดยไม่จำเป็น ไม่ว่าสาเหตุจะคืออะไร การบล็อกการรับส่งข้อมูลจากแหล่งที่มาที่เฉพาะเจาะจงเมื่อถึงระดับหนึ่ง เป็นสิ่งจำเป็นต่อสุขภาพโดยรวมของระบบ Google Workspace ซึ่งจะช่วย รับประกันว่าการกระทำของนักพัฒนาแอปคนหนึ่งจะไม่ส่งผลเสียต่อชุมชน ในวงกว้าง
ในกรณีที่คำขอ API ไม่สำเร็จ คุณจะได้รับการตอบกลับเป็นรหัสสถานะ HTTP
รหัสสถานะ 403 มีข้อมูลข้อผิดพลาดเกี่ยวกับการป้อนข้อมูลที่ไม่ถูกต้อง และรหัสสถานะ HTTP 503 มีข้อมูลข้อผิดพลาดที่ระบุว่าโควต้า API ใดเกิน การตอบกลับเหล่านี้ช่วยให้แอปพลิเคชันที่กำหนดเองตรวจหาข้อผิดพลาดเหล่านี้และดำเนินการที่เหมาะสมได้
หากคำขอของคุณต้องดำเนินการให้เสร็จภายในระยะเวลาที่กำหนด ให้ส่งคำขอแบบขนานหรือใช้หลายเทรดในแอปพลิเคชัน Java หรือ C# ตัวอย่างคำขอแบบขนานคือการขออีเมลเป็นชุดเล็กๆ จากผู้ใช้ที่แตกต่างกัน แทนที่จะเพิ่มหรือนำอีเมลจำนวนมากออกจากผู้ใช้รายเดียวพร้อมกัน ในกรณีของเธรด ให้ลองเริ่มต้นด้วย 10 เธรด โดยมี 1 เธรด ต่ออีเมลผู้ใช้ โปรดทราบว่าการแนะนำเทรดมีข้อดีข้อเสียและไม่เหมาะกับสถานการณ์ API ทั้งหมด หากจำนวนคำขอสูงเกินไป จะเกิดข้อผิดพลาดเกี่ยวกับโควต้า
สำหรับข้อผิดพลาดทั้งหมดที่อิงตามเวลา (สูงสุด N รายการเป็นเวลา N วินาทีต่อ เธรด) โดยเฉพาะข้อผิดพลาดรหัสสถานะ 503 เราขอแนะนำให้โค้ดของคุณตรวจจับ ข้อยกเว้นและใช้อัลกอริทึมการ หยุดชั่วคราวแบบ ทวีคูณ เพื่อรอการหน่วงเวลาเล็กน้อยก่อนที่จะลองเรียกใช้ที่ล้มเหลวอีกครั้ง ตัวอย่าง Alert Center API สำหรับ 1 เธรดคือการรอ 5 วินาทีแล้วลองเรียกที่ ล้มเหลวอีกครั้ง หากคำขอสำเร็จ ให้ทำตามรูปแบบนี้ซ้ำสำหรับเธรดอื่นๆ หากคำขอครั้งที่ 2 ไม่สำเร็จ แอปพลิเคชันควรลดความถี่ของคำขอลงจนกว่าการเรียกจะสำเร็จ เช่น เพิ่มการหน่วงเวลาเริ่มต้น 5 วินาทีเป็น 10 วินาที แล้วลองโทรอีกครั้ง นอกจากนี้ ให้กำหนดขีดจำกัดการลองอีกครั้ง เช่น ลองส่งคำขออีกครั้ง 5-7 ครั้ง โดยใช้เวลาหน่วงที่แตกต่างกันก่อนที่แอปพลิเคชันจะแสดงข้อผิดพลาดแก่ผู้ใช้
| หมวดหมู่ขีดจำกัด API | ขีดจำกัด |
|---|---|
| อัตรา QPS และ QPD ของศูนย์แจ้งเตือน | API จะจำกัดจำนวนคำขอสำหรับโปรเจ็กต์ Google Cloud
จำนวนคำขอสูงสุดต่อวินาทีของโปรเจ็กต์ API (QPS ของโปรเจ็กต์)
คือ 1,000 และจำนวนคำขอสูงสุดต่อผู้ใช้ต่อวินาที
(QPS ของผู้ใช้) คือ 150
หากเกินขีดจำกัดเหล่านี้ เซิร์ฟเวอร์จะแสดงรหัสสถานะ HTTP |
| ขีดจำกัดประเภทอื่นๆ | ข้อจำกัดและหลักเกณฑ์ |
|---|---|
| รูปแบบข้อมูล ค่าเริ่มต้น | รูปแบบข้อมูลเริ่มต้นคือ JSON |
| คำขอที่ไม่ได้รับอนุญาต | Google ไม่อนุญาตคำขอที่ไม่ได้รับอนุญาตไปยัง API นี้ ระบบจะถือว่าคำขอ ไม่ได้รับอนุญาตหากไม่มีโทเค็นการให้สิทธิ์ ดูข้อมูลเพิ่มเติมได้ที่ การให้สิทธิ์คำขอ |
ขอเพิ่มโควต้าต่อโปรเจ็กต์
คุณอาจต้องขอปรับโควต้า ทั้งนี้ขึ้นอยู่กับการใช้ทรัพยากรของโปรเจ็กต์ ระบบจะถือว่าการเรียก API โดยบัญชีบริการเป็นการใช้บัญชีเดียว การขอโควต้าที่ปรับแล้วอาจไม่ได้รับการอนุมัติเสมอไป คำขอปรับโควต้า ซึ่งจะเพิ่มค่าโควต้าอย่างมีนัยสำคัญอาจใช้เวลานานกว่าในการอนุมัติ
โปรเจ็กต์แต่ละโปรเจ็กต์อาจมีโควต้าไม่เท่ากัน เมื่อคุณใช้ Google Cloud มากขึ้นเรื่อยๆ ค่าโควต้าอาจต้องเพิ่มขึ้น หากคาดว่าการใช้งานจะเพิ่มขึ้นอย่างเห็นได้ชัดในอนาคต คุณสามารถขอปรับโควต้าล่วงหน้าได้จากหน้าโควต้าและขีดจำกัดของระบบในคอนโซล Google Cloud
ดูข้อมูลเพิ่มเติมได้ที่แหล่งข้อมูลต่อไปนี้