Hạn mức sử dụng Mail Admin Quarantine API

Mail Admin Quarantine API thực thi hạn mức sử dụng mỗi phút cho từng dự án trên đám mây của Google Cloud để bảo vệ cơ sở hạ tầng của Google Workspace, nơi tìm kiếm và truy xuất thư bị cách ly. Hạn mức được nhóm theo loại công việc mà một phương thức thực hiện.

Hạn mức

Bảng sau đây liệt kê các hạn mức. Mỗi hạn mức được tính mỗi phút cho mỗi dự án trên đám mây và tính tất cả các yêu cầu mà dự án đưa ra cho tất cả khách hàng Google Workspace và quản trị viên được mạo danh.

Hạn mức Giá trị Phương thức
Yêu cầu tìm kiếm và liệt kê 60 yêu cầu mỗi phút customers.quarantinedMessages.list, customers.quarantinedMessages.search
Đọc yêu cầu 1.200 yêu cầu mỗi phút customers.quarantinedMessages.get, customers.quarantines.get, customers.quarantines.list, customers.operations.get
Yêu cầu ghi 300 yêu cầu mỗi phút customers.quarantinedMessages.release, customers.quarantinedMessages.deny, customers.quarantinedMessages.batchRelease, customers.quarantinedMessages.batchDeny

Mỗi lệnh gọi API được tính là một yêu cầu, bất kể kích thước trang hoặc số lượng thông báo trong lô (đối với phương thức theo lô). Ví dụ: một yêu cầu batchRelease có 500 thông báo sẽ sử dụng một yêu cầu ghi.

Bạn có thể xem hạn mức sử dụng hiện tại của dự án trong Google Cloud Console, trong phần API và dịch vụ > API và dịch vụ đã bật > Admin Quarantine API > Hạn mức và giới hạn của hệ thống.

Giới hạn yêu cầu

Hạn chế Giá trị
Tối đa pageSize cho các yêu cầu list và search 300 tin nhắn
Số lượng tin nhắn tối đa cho mỗi yêu cầu batchRelease hoặc batchDeny 500 tin nhắn
Cửa sổ tìm kiếm và danh sách Tin nhắn nhận được trong 30 ngày qua

Giải quyết lỗi về hạn mức

Khi dự án của bạn vượt quá hạn mức, API sẽ trả về lỗi HTTP 429 kèm theo trạng thái 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"
  }
}

Để không vượt quá hạn mức, hãy làm như sau:

  • Thử lại với thời gian đợi luỹ thừa. Khi bạn nhận được lỗi 429, hãy đợi trước khi thử lại và tăng thời gian chờ sau mỗi lần thử không thành công. Để biết thông tin chi tiết, hãy xem phần Thuật toán thời gian đợi luỹ thừa.
  • Sử dụng kích thước trang hữu ích lớn nhất. Yêu cầu tìm kiếm và liệt kê có hạn mức nhỏ nhất. Yêu cầu tối đa 300 thư mỗi trang thay vì nhiều trang nhỏ.
  • Sử dụng bộ lọc. Thu hẹp các yêu cầu search bằng filter hoặc query để chỉ truy xuất những thư bạn cần.
  • Sử dụng phương thức theo lô cho các thao tác hàng loạt. Một yêu cầu batchRelease hoặc batchDeny có thể phát hành hoặc từ chối tối đa 500 thư, so với một thư cho mỗi lệnh gọi release hoặc deny.
  • Hạn chế thăm dò ý kiến về các hoạt động. Khi bạn chờ một thao tác theo lô, hãy gọi phương thức get của tài nguyên customers.operations sau mỗi vài giây thay vì liên tục.
  • Đồng bộ hoá tăng dần. Thay vì liệt kê lại toàn bộ thư bị cách ly trong mỗi lần chạy, hãy lọc theo status = PENDING_TRIAGE và chỉ xử lý thư mới.

Bạn không thể tăng hạn mức trong giai đoạn Bản dùng trước cho nhà phát triển. Nếu trường hợp sử dụng của bạn yêu cầu hạn mức cao hơn, hãy chia sẻ ý kiến phản hồi của bạn thông qua Chương trình Bản dùng trước cho nhà phát triển của Google Workspace.