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

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

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

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

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

ตารางต่อไปนี้แสดงขีดจำกัดสำหรับ Email Audit API

หมวดหมู่ขีดจำกัด API	จำกัดสูงสุด
การสร้างไฟล์กล่องจดหมายที่เข้ารหัส	การสร้างไฟล์กล่องจดหมายที่เข้ารหัสอาจใช้เวลาหลายวันในการเตรียมระบบ ทั้งนี้ขึ้นอยู่กับขนาด
ไฟล์กล่องจดหมายที่เข้ารหัส ข้อผิดพลาดเกี่ยวกับการลบ	เมื่อ ลบ กล่องจดหมายที่เข้ารหัสและเกิดข้อผิดพลาด ระบบจะกำหนดสถานะ MARKED_DELETE ให้กับคำขอ Google จะนำข้อมูลสรุปและไฟล์ที่ส่งออกเหล่านี้ กลับไปลบอีกครั้งโดยอัตโนมัติภายใน 24 ชั่วโมง (พร้อมไฟล์ที่อาจเหลืออยู่) หากระบบแสดงสถานะ MARKED_DELETE อย่างต่อเนื่อง ให้ลองใช้ กลยุทธ์ Exponential Backoff

ตารางต่อไปนี้แสดงโควต้าสำหรับ Email Audit API

หมวดหมู่โควต้า API	โควต้า
โทเค็นการตรวจสอบสิทธิ์ ClientLogin	ใช้ได้ 24 ชั่วโมง ข้อผิดพลาดคือ 401 token expired
รูปแบบวันที่	แปลงวันที่ทั้งหมดเป็นรูปแบบเวลาสากลเชิงพิกัด (UTC) ก่อนที่จะใช้กับ Email Audit API ดูข้อมูลเพิ่มเติมได้ที่ ตัวแปลง UTC
ไฟล์กล่องจดหมายที่เข้ารหัส สรุป EXPIRED และไฟล์ส่งออก	Google จะเก็บไฟล์กล่องจดหมายที่เข้ารหัสไว้เป็นเวลา 3 สัปดาห์ หลังจากนั้น ระบบจะลบข้อมูลดังกล่าว ผู้ดูแลระบบโดเมนมีหน้าที่รับผิดชอบในการดาวน์โหลดไฟล์กล่องจดหมายเหล่านี้ภายในระยะเวลาดังกล่าว
ไฟล์กล่องจดหมายที่เข้ารหัส รูปแบบ	ไฟล์กล่องจดหมายที่เข้ารหัสจะอยู่ในรูปแบบ mbox
ไฟล์กล่องจดหมายที่เข้ารหัส คำขอสร้างสูงสุด	คำขอสร้างการส่งออกกล่องจดหมายสูงสุดต่อวันคือ 100 คำขอจากผู้ดูแลระบบทั้งหมดในโดเมน
สถานะไฟล์กล่องจดหมายที่เข้ารหัส การแบ่งหน้า	เมื่อขอสถานะของคำขอในกล่องจดหมายทั้งหมด คำตอบอาจ แสดงข้อมูลจำนวนมาก API การตรวจสอบอีเมลจะจัดกลุ่มข้อมูลนี้เป็นหน้าๆ โดยแต่ละหน้าจะมีรายการได้สูงสุด 100 รายการ และมี URI ในแท็ก link rel='next' ที่ชี้ไปยังหน้าผลลัพธ์ถัดไป เมื่อพัฒนาแอปพลิเคชันไคลเอ็นต์ โค้ดของคุณต้องจัดการผลลัพธ์เพิ่มเติมเหล่านี้
การตรวจสอบอีเมล	จำนวนคำขอตรวจสอบอีเมลสูงสุดต่อวันคือ 1,500 รายการ โดยขีดจำกัดนี้มีผลกับโดเมนและรวมถึงคำขอทั้งหมดที่ผู้ดูแลระบบ ส่งในระหว่างวัน
คีย์สาธารณะ	Email Audit API รองรับคีย์เดียวเท่านั้น คีย์สาธารณะใช้ซอฟต์แวร์ GNU Privacy Guard (GPG) โดยอยู่ในรูปแบบ PGP และเป็นคีย์การเข้ารหัส RSA ที่เข้ารหัส ASCII ก่อนอัปโหลด คีย์สาธารณะ คุณต้องแปลงคีย์ดังกล่าวเป็นสตริงที่เข้ารหัส Base64 ก่อน ไฟล์คีย์สาธารณะควรอ่านด้วยชุดอักขระ US-ASCII (IANA ชื่อชุดอักขระที่ต้องการสำหรับ ASCII)
การค้นหา	พารามิเตอร์ searchQuery และ includeDeleted จะใช้พร้อมกันไม่ได้ คุณจะค้นหาไม่ได้หาก includeDeleted="true"