Google 服务的配额

Apps 脚本服务对某些功能有每日配额和限制。如果您超出配额或限制,脚本会抛出异常并停止执行。

重要提示:与某些功能相关的 Google 产品具有额外的配额。使用产品的 Apps 脚本服务将计入所有关联的配额预留。如果您达到任何相关配额,某项功能将变为不可用。

当前配额

消费者(例如 gmail.com)或 G Suite 免费版(已停用)帐号和 Google Workspace 帐号的用户分别设置了不同级别的配额。配额按用户计算,并在第一个请求发出 24 小时后重置。

使用下面的配额有助于测试您的脚本。我们随时可能会取消、减少或更改所有配额,恕不另行通知。

特征 个人用户版(例如 gmail.com)和
G Suite 免费版
旧版
Google Workspace
账号
创建的日历活动数 5,000 个 / 天 10,000 个 / 天
创建的联系人数 1,000 个 / 天 2,000 个 / 天
已创建文档 250 个 / 天 1500 个 / 天
文件已转换 2,000 个 / 天 4,000 个 / 天
每日电子邮件收件人数 100* / 天 1500* / 天
网域内每天的电子邮件收件人数量 100* / 天 2,000 个 / 天
电子邮件读/写(不包括发送) 20,000 个 / 天 50,000 个 / 天
群组读取次数 2,000 个 / 天 10,000 个 / 天
JDBC 连接数 10,000 个 / 天 50,000 个 / 天
JDBC 连接失败次数 100 个 / 天 500 个 / 天
已创建演示文稿 250 个 / 天 1500 个 / 天
属性读/写 50,000 个 / 天 500,000 个 / 天
已创建的幻灯片数 250 个 / 天 1500 个 / 天
创建的电子表格数 250 个 / 天 3,200 个 / 天
触发器总运行时间 90 分钟 / 天 6 小时 / 天
网址提取调用次数 20,000 个 / 天 100,000 次 / 天
静态地图渲染 1,000 个 / 天 10,000 个 / 天
“Google 地图方向”查询 1,000 个 / 天 10,000 个 / 天
Google 地图地理编码调用 1,000 个 / 天 10,000 个 / 天
翻译通话内容 5,000 个 / 天 20,000 个 / 天
Google 地图海拔示例查询 1,000 个 / 天 10,000 个 / 天
Apps 脚本项目 50 个 / 天 50 个 / 天

当前限制

请使用以下限制来帮助测试您的脚本。所有限制随时可能消除、减少或更改,恕不另行通知。

特征 个人用户版(例如 gmail.com)和
G Suite 免费版
旧版
Google Workspace
账号
脚本运行时 每次执行 6 分钟 每次执行 6 分钟
自定义函数运行时 每次执行 30 秒 每次执行 30 秒
Google Workspace 插件运行时 每次执行 30 秒 每次执行 30 秒
每位用户同时执行的次数 30 / 用户 30 / 用户
每个脚本的同时执行次数 1,000 1,000
电子邮件附件 250 / 邮件 250 / 邮件
电子邮件正文大小 200 KB / 邮件 400 KB / 邮件
每封邮件的电子邮件收件人数量 50 个 / 邮件 50 个 / 邮件
电子邮件附件的总大小 25 MB / 邮件 25 MB / 邮件
属性值大小 9 KB / 值 9 KB / 值
媒体资源总存储空间 500 KB / 属性存储区 500 KB / 属性存储区
触发器 20 / 用户 / 脚本 20 / 用户 / 脚本
网址提取响应大小 50 MB / 调用 50 MB / 调用
网址提取标头 100 个 / 通话 100 个 / 通话
网址提取标头大小 每次调用 8 KB 每次调用 8 KB
网址提取 POST 大小 50 MB / 调用 50 MB / 调用
网址提取网址长度 每次调用 2 KB 每次调用 2 KB
Versions 200 / 脚本 200 / 脚本

异常消息

如果脚本达到配额或限制,则会抛出异常,并显示类似如下的消息:

  • Limit exceeded: Email Attachments Per Message. 这表示脚本超出了上面列出的某项配额或限制。
  • Service invoked too many times: Calendar. 这表示脚本在一天内调用指定服务的次数过多。
  • Service invoked too many times in a short time: Calendar. Try Utilities.sleep(1000) between calls. 这表示脚本在短时间内调用指定服务的次数过多。
  • Service using too much computer time for one day. 这表示脚本超出了一天允许的总执行时间。这最常发生在针对触发器运行的脚本上,这些触发器的每日限额比手动执行的脚本低。
  • Script invoked too many times per second for this Google user account. 这表示脚本在短时间内开始执行的次数过多。单个电子表格中重复调用的自定义函数最常出现这种情况。为避免此错误,请对自定义函数进行编码,使每个数据范围只需调用一次这些函数,如自定义函数指南中所述。
  • There are too many scripts running simultaneously for this Google user account. 这表示您同时执行的脚本过多,但未必是同一脚本。与上述异常一样,这种情况通常出现在单个电子表格中重复调用的自定义函数中。