Mail Admin Quarantine API 用量配額

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 呼叫都會計為一項要求。舉例來說，包含 500 則訊息的 batchRelease 要求會耗用一項寫入要求。

如要查看專案目前的配額用量，請前往 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"
  }
}

如要維持在配額內，請按照下列步驟操作：

  • 以指數輪詢方式重試。如果收到 429 錯誤，請稍候再重試，並在每次嘗試失敗後增加等待時間。詳情請參閱「指數輪詢」。
  • 使用最大且實用的頁面大小。搜尋和清單要求的配額最小。每頁最多要求 300 則訊息，而不是許多小頁面。
  • 使用篩選器。使用 filter 或 query 縮小 search 要求的範圍，只擷取所需訊息。
  • 使用批次方法執行大量操作。單一 batchRelease 或 batchDeny 要求最多可釋出或拒絕 500 則郵件，而每次 release 或 deny 呼叫只能處理一則郵件。
  • 盡量減少輪詢作業。等待批次作業時，請每隔幾秒呼叫 customers.operations 資源的 get 方法，而不是持續呼叫。
  • 增量同步：請篩選 status = PENDING_TRIAGE，並只處理新郵件，而不是在每次執行時重新列出整個隔離區。

開發人員預覽版期間無法提高配額。如果您的用途需要更高的配額，請透過 Google Workspace 開發人員預覽版計畫提供意見。