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

ขีดจำกัดและโควต้าจะปกป้องโครงสร้างพื้นฐานของ 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 503 ใช้อัลกอริทึม Exponential Backoff เมื่อลองส่งคำขออีกครั้ง

ข้อจำกัดประเภทอื่นๆ ข้อจำกัดและหลักเกณฑ์
รูปแบบข้อมูล (ค่าเริ่มต้น) รูปแบบข้อมูลเริ่มต้นคือ JSON
คำขอที่ไม่ได้รับอนุญาต Google ไม่อนุญาตคำขอที่ไม่ได้รับอนุญาตไปยัง API นี้ ระบบจะถือว่าคำขอไม่ได้รับอนุญาตหากไม่มีการให้โทเค็นการให้สิทธิ์ ดูข้อมูลเพิ่มเติมได้ที่การให้สิทธิ์คำขอ

ขอเพิ่มโควต้าต่อโปรเจ็กต์

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

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

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