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

ขีดจำกัดและโควต้าจะปกป้องโครงสร้างพื้นฐานของ Google จากกระบวนการอัตโนมัติที่ใช้ API การโอนข้อมูลในลักษณะที่ไม่เหมาะสม คําขอที่มากเกินไปจาก API อาจเป็นผลมาจากการพิมพ์ผิดที่ไม่เป็นอันตราย หรืออาจเกิดจากระบบที่ออกแบบมาอย่างไม่มีประสิทธิภาพซึ่งทำการเรียก API ได้โดยจําเป็น ไม่ว่าจะเกิดจากสาเหตุใด การบล็อกการเข้าชมจากแหล่งที่มาที่เฉพาะเจาะจงเมื่อถึงระดับหนึ่งๆ จำเป็นต่อประสิทธิภาพโดยรวมของระบบ Google Workspace ทั้งนี้เพื่อให้มั่นใจว่าการดำเนินการของนักพัฒนาแอป 1 รายจะไม่ส่งผลเสียต่อชุมชนขนาดใหญ่

คำขอ API ล้มเหลว

ในกรณีที่คำขอ API ของคุณไม่สำเร็จ ซึ่งมีโอกาสเกิดขึ้นไม่บ่อยนัก แอปพลิเคชันของคุณจะได้รับการตอบกลับรหัสสถานะ HTTP รหัสสถานะของ 403 มีข้อมูลข้อผิดพลาดเกี่ยวกับอินพุตที่ไม่ถูกต้อง และรหัสสถานะ HTTP ของ 503 มีข้อมูลข้อผิดพลาดที่ระบุว่าโควต้า API ใดเกินโควต้า การตอบกลับเหล่านี้ช่วยให้แอปพลิเคชันที่กำหนดเองตรวจพบข้อผิดพลาดเหล่านี้และดำเนินการตามความเหมาะสมได้

คำขอที่เสร็จสมบูรณ์ในระยะเวลาที่กำหนด

หากต้องการดำเนินการตามคำขอให้เสร็จสมบูรณ์ภายในระยะเวลาที่กำหนด ให้ส่งคำขอพร้อมกันหรือใช้เทรดหลายรายการในแอปพลิเคชัน Java หรือ C# เช่น แยกคำขอตามเดือนหรือช่วงเวลาอื่น ในกรณีของชุดข้อความ ให้ลองเริ่มจากชุดข้อความ 10 รายการ โดยป้อน 1 ชุดข้อความต่อคําขอ คำแนะนำชุดข้อความมีข้อดีข้อเสียและไม่มีประโยชน์ต่อ API บางสถานการณ์ หากจำนวนคำขอสูงเกินไป ข้อผิดพลาดเกี่ยวกับโควต้าจะเกิดขึ้น

ข้อผิดพลาดที่อิงตามเวลา

สำหรับข้อผิดพลาดทั้งหมดที่อิงตามเวลา (ไม่เกิน N รายการเป็นเวลา X วินาทีต่อเทรด) โดยเฉพาะอย่างยิ่งข้อผิดพลาดของรหัสสถานะ 503 เราขอแนะนำให้โค้ดจับข้อยกเว้นและใช้อัลกอริทึม Exponential Backoff รอให้ระบบล่าช้าเล็กน้อยก่อนที่จะลองเรียกใช้ที่ล้มเหลวอีกครั้ง ตัวอย่าง Data Transfer API ของเทรดหนึ่งคือการรอ 5 วินาทีแล้วลองเรียกที่ล้มเหลวอีกครั้ง หากคำขอสำเร็จ ให้ใช้รูปแบบนี้ซ้ำสำหรับชุดข้อความอื่นๆ หากคำขอที่ 2 ไม่สำเร็จ แอปพลิเคชันควรปรับลดความถี่ของคำขอจนกว่าคำขอจะสำเร็จ ตัวอย่างเช่น เพิ่มการหน่วงเวลา 5 วินาทีแรกเป็น 10 วินาที แล้วลองโทรที่ไม่สำเร็จอีกครั้ง นอกจากนี้ ให้เลือกขีดจำกัดการลองอีกครั้ง เช่น ลองส่งคำขออีกครั้ง 5 ถึง 7 ครั้งโดยให้เวลาล่าช้าต่างกัน ก่อนที่แอปพลิเคชันจะแสดงข้อผิดพลาดให้แก่ผู้ใช้

ข้อจำกัด

หมวดหมู่ขีดจำกัด API	ข้อจำกัด
จำนวนคำค้นหาต่อวินาที (QPS)	โปรเจ็กต์นักพัฒนาซอฟต์แวร์จำกัดไว้ที่ 10 คำค้นหาต่อวินาที (QPS) ต่อบัญชี

โควต้า

หมวดหมู่โควต้า API	โควต้า
คำขอ API สูงสุดต่อวัน	คำขอ API สูงสุดต่อวันคือ 500,000 รายการ
การเก็บ การหมดอายุของข้อความ	ที่เก็บถาวรของกลุ่มไม่มีวันหมดอายุ ข้อความจะคงอยู่ในที่เก็บจนกว่ากลุ่มจะถูกลบ นโยบายการเก็บรักษาอีเมลจะไม่ส่งผลต่อข้อความในที่เก็บถาวรของกลุ่ม
ขนาดข้อความอีเมล	ขนาดข้อความอีเมลสูงสุดคือ 25 MB ขีดจำกัดนี้รวมถึงส่วนหัวข้อมูลเมตา เนื้อหา และไฟล์แนบทั้งหมดของข้อความ

ข้อจำกัดประเภทอื่นๆ

ข้อจำกัดประเภทอื่นๆ	ข้อจำกัดและหลักเกณฑ์
รูปแบบประเภทเนื้อหา	ข้อความอีเมลต้องอยู่ในรูปแบบข้อความ RFC 822 มาตรฐาน รูปแบบประเภทเนื้อหาของคำขอสำหรับการอัปโหลดอีเมลที่ย้ายข้อมูลแล้วจะใช้ส่วนหัว Content-type: message/rfc822
รูปแบบข้อมูลในการตอบสนองของ API	รูปแบบข้อมูลการตอบกลับคือ JavaScript Object Notation (JSON)
นโยบายตำแหน่งข้อมูล	Data Transfer API ไม่รองรับนโยบายตำแหน่งข้อมูลที่กำหนดให้มีการจัดเก็บข้อมูลในขอบเขตทางภูมิศาสตร์หรือการเมืองที่เฉพาะเจาะจงเนื่องด้วยเหตุผลทางสัญญา อย่าใช้ API การโอนข้อมูลหากต้องใช้ตำแหน่งข้อมูลสำหรับบัญชีของคุณ
การแทรกข้อความพร้อมกัน	Data Transfer API รองรับคำขอพร้อมกันสำหรับการแทรกอีเมลในที่เก็บถาวรของกลุ่มต่างๆ แต่ Data Transfer API ไม่รองรับการแทรกข้อความพร้อมกันในที่เก็บถาวรกลุ่มเดียวกัน และ API เวอร์ชันนี้ก็ไม่รองรับคำขอแบบกลุ่มเช่นกัน
คำขอที่ไม่ได้รับอนุญาต	Data Transfer API จะไม่ยอมรับคำขอที่ไม่ได้รับอนุญาต ระบบจะถือว่าคำขอไม่ได้รับอนุญาตหากไม่มีการให้โทเค็นการให้สิทธิ์