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