โควต้าการใช้งาน Mail Admin Quarantine API

เวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์: พร้อมใช้งานเป็นส่วนหนึ่งของโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ Google Workspace ซึ่งให้สิทธิ์ทดลองใช้ฟีเจอร์บางอย่างก่อนเปิดตัว

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

โควต้า

ตารางต่อไปนี้แสดงโควต้า โควต้าแต่ละรายการจะนับต่อนาทีต่อโปรเจ็กต์ที่อยู่ในระบบคลาวด์ และนับคำขอทั้งหมดที่โปรเจ็กต์ส่งจากลูกค้า Google Workspace และผู้ดูแลระบบที่ถูกแอบอ้างทั้งหมด

โควต้า	ค่า	เมธอด
คำขอค้นหาและแสดงรายการ	60 คำขอต่อนาที	customers.quarantinedMessages.list, customers.quarantinedMessages.search
คำขอที่อ่าน	คำขอ 1,200 รายการต่อนาที	customers.quarantinedMessages.get, customers.quarantines.get, customers.quarantines.list, customers.operations.get
คำขอที่เขียน	300 คำขอต่อนาที	customers.quarantinedMessages.release, customers.quarantinedMessages.deny, customers.quarantinedMessages.batchRelease, customers.quarantinedMessages.batchDeny

การเรียก API แต่ละครั้งจะนับเป็น 1 คำขอ ไม่ว่าขนาดหน้าจะเป็นเท่าใด หรือสำหรับเมธอดแบบกลุ่ม จำนวนข้อความในกลุ่มจะเป็นเท่าใดก็ตาม ตัวอย่างเช่น คำขอ batchRelease ที่มีข้อความ 500 รายการจะใช้คำขอเขียน 1 รายการ

คุณสามารถดูการใช้โควต้าปัจจุบันของโปรเจ็กต์ได้ในคอนโซล Google Cloud ในส่วนAPI และบริการ > API และบริการที่เปิดใช้ > Admin Quarantine API > โควต้าและขีดจำกัดของระบบ

ข้อจำกัดของคำขอ

ข้อจำกัด	ค่า
คำขอ list และ search สูงสุด pageSize รายการ	300 ข้อความ
จำนวนข้อความสูงสุดต่อคำขอ batchRelease หรือ batchDeny	500 ข้อความ
หน้าต่างการค้นหาและรายการ	ข้อความที่ได้รับในช่วง 30 วันที่ผ่านมา

แก้ไขข้อผิดพลาดเกี่ยวกับโควต้า

เมื่อโปรเจ็กต์ของคุณเกินโควต้า API จะแสดงข้อผิดพลาด HTTP 429 พร้อมสถานะ RESOURCE_EXHAUSTED ดังนี้

{
  "error": {
    "code": 429,
    "message": "Quota exceeded for quota metric 'Search and list quarantined messages requests' and limit 'Search and list requests per minute per project' of service 'mailadminquarantine.googleapis.com' for consumer 'project_number:123456789012'.",
    "status": "RESOURCE_EXHAUSTED"
  }
}

วิธีคงอยู่ภายในโควต้า

• ลองอีกครั้งโดยใช้ Exponential Backoff เมื่อได้รับข้อผิดพลาด 429 ให้รอก่อนที่จะลองอีกครั้ง และเพิ่มเวลารอหลังจากที่ดำเนินการไม่สำเร็จแต่ละครั้ง โปรดดูรายละเอียดที่หัวข้อ Exponential Backoff
• ใช้ขนาดหน้าเว็บที่มีประโยชน์มากที่สุด คำขอค้นหาและคำขอรายการมีโควต้าน้อยที่สุด ขอข้อความสูงสุด 300 ข้อความต่อหน้าแทนที่จะเป็นหน้าเล็กๆ หลายหน้า
• ใช้ตัวกรอง จำกัดคำขอ search ด้วย filter หรือ query เพื่อให้คุณเรียกดูเฉพาะข้อความที่ต้องการได้
• ใช้วิธีการแบบกลุ่มสำหรับการดำเนินการแบบกลุ่ม คำขอ batchRelease หรือ batchDeny รายการเดียวสามารถปล่อยหรือปฏิเสธข้อความได้สูงสุด 500 ข้อความ เทียบกับข้อความ 1 ข้อความต่อการเรียก release หรือ deny 1 ครั้ง
• สำรวจการดำเนินการเท่าที่จำเป็น เมื่อรอการดำเนินการแบบกลุ่ม ให้เรียกใช้เมธอด get ของทรัพยากร customers.operations ทุกๆ 2-3 วินาทีแทนที่จะเรียกใช้อย่างต่อเนื่อง
• ซิงค์แบบเพิ่มขึ้นทีละน้อย แทนที่จะแสดงรายการเขตกักเก็บทั้งหมดอีกครั้งในการเรียกใช้แต่ละครั้ง ให้กรอง status = PENDING_TRIAGE และประมวลผลเฉพาะข้อความใหม่เท่านั้น

การเพิ่มโควต้าไม่พร้อมใช้งานในเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ หากกรณีการใช้งานของคุณต้องการโควต้าที่สูงขึ้น โปรดแชร์ความคิดเห็นผ่านโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ Google Workspace