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

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

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

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

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

ตารางต่อไปนี้แสดงรายการขีดจํากัดของ API การตรวจสอบอีเมล

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

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

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