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