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 开发者预览版计划分享您的反馈。