内部未验证应用调用Gmail API创建过滤器触发用户速率限制问询

触发用户速率限制的可能原因如下： #

• 短窗口单用户配额被耗尽：官方公开的250 units/秒是项目级总配额，单用户的速率限制采用分钟级滚动窗口计算，你设置的5秒间隔只是平均速率，若同个用户的Gmail接口同时有其他应用调用，叠加后短时间内就会超过单用户的配额阈值触发429。
• filters.create接口配额消耗超预期：该接口属于写操作，单请求消耗的配额单位远高于读接口，并非你默认的1 unit/次，40次调用的总配额消耗可能已经超过单用户短窗口的配额上限。
• Google Workspace Legacy版本专属配额限制：公开配额文档的数值是新版付费Workspace的标准，Legacy版本的API配额默认更低，且针对过滤器、转发规则这类修改用户配置的操作有额外的未公开限制，更容易触发限流。
• 未验证内部应用的风控限流：虽然内部应用无需强制验证，但未验证的应用高频发起修改类操作时，会触发Google风控系统的临时限流，这类限流的冷却期通常就是24小时左右，和你遇到的故障持续时间完全吻合。
• 项目总配额被其他调用占用：如果同一Google Cloud项目下还有其他任务在调用Gmail API，所有请求共享项目总配额，叠加你的40次filters.create调用后会导致总配额被耗尽。
• 带转发规则的过滤器数量限制：报错信息明确提到Forwarding rules，说明你创建的过滤器关联了转发逻辑，Gmail对单用户24小时内可创建的带转发规则的过滤器有单独的未公开硬限制，阈值通常为30-50个，你触发的是这项特殊限制而非通用API速率限制。

内容的提问来源于stack exchange，提问作者TonyL