Google Workspace用户创建负载测试遇412错误咨询

问题场景 #

用Python脚本Google_add.py做用户创建的负载测试，目标是创建100个Google Workspace用户，结果碰到这个错误：

googleapiclient.errors.HttpError: <HttpError 412 when requesting https://admin.googleapis.com/admin/directory/v1/users?alt=json returned "Domain user limit reached. Contact Support.">

测试情况：

• 一次创建50个用户：成功
• 一次创建100个用户：仅前10个成功，其余触发上述错误
  使用许可证：Google Workspace Business Starter（官方标称支持最多300个用户）

1. 什么是"Domain user limit"？ #

这个限制不是你的许可证总用户上限（该套餐确实支持300个用户），而是Google针对Directory API设置的短期速率限制——简单说就是在某个短时间窗口内，你调用用户创建API的次数/创建用户的数量被限制了，目的是防止恶意刷请求或突发流量影响服务稳定性，和你的总用户额度无关。

2. 怎么避免这个错误？ #

给你几个实用的解决办法：

• 添加请求延迟：在脚本里每次创建用户后，增加1-2秒的休眠，避免短时间内批量发起请求。示例代码片段：

  import time
  # 执行用户创建的API调用代码
  time.sleep(1.5)  # 每次创建后等待1.5秒再发起下一个请求
  

• 使用批量请求：不要单个调用API，改用Google API的批量请求机制，把多个创建请求打包成一个批量请求发送，减少请求频次，降低触发限制的概率。
• 核对实际用户数：登录Google Workspace Admin控制台，确认当前已有的用户数加上待创建的100个，没有超过套餐的总用户上限（避免因残留的已删除用户占用额度）。
• 联系Google支持：如果以上方法都无效，可能是你的域名被设置了特殊的临时限制，直接联系Google Workspace支持团队申诉调整即可。

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