Apps 脚本服务对某些功能设有每日配额和限制。如果超出配额或限制,脚本会抛出异常,并且执行会停止。
重要提示:某些功能还受其所关联的 Google 产品的额外配额限制。使用产品的 Apps Script 服务会计入所有相关的配额预留。如果您达到了任何关联配额,相应功能将无法使用。
当前配额
消费者(例如 gmail.com)或 G Suite 免费版(已停用)账号和 Google Workspace 账号的用户分别设置了不同级别的配额。配额按用户分配,并会在首次请求 24 小时后重置。
请使用以下配额来帮助测试您的脚本。Google 有权随时取消、减少或更改所有配额,恕不另行通知。
功能 | 个人账号(例如 gmail.com)和 G Suite 免费版 (旧版) |
Google Workspace 账号 |
---|---|---|
创建的日历活动数 | 5,000 次 / 天 | 10,000 次 / 天 |
创建的联系人数 | 1,000 个 / 天 | 2,000 个 / 天 |
已创建文档 | 250 个 / 天 | 1,500 次 / 天 |
已转换的文件数 | 2,000 次 / 天 | 4,000 次 / 天 |
每日电子邮件收件人数 | 100* / 天 | 1,500* / 天 |
网域内每天的电子邮件收件人数量 | 100* / 天 | 2,000 次 / 天 |
电子邮件读写(不包括发送) | 20,000 个 / 天 | 5 万次 / 天 |
群组读取次数 | 2,000 次 / 天 | 10,000 次 / 天 |
JDBC 连接数 | 10,000 次 / 天 | 5 万次 / 天 |
JDBC 连接失败次数 | 100 次 / 天 | 500 次 / 天 |
已创建演示文稿 | 250 个 / 天 | 1,500 次 / 天 |
属性读写 | 5 万次 / 天 | 500,000 个 / 天 |
已创建的幻灯片数 | 250 次 / 天 | 1,500 次 / 天 |
创建的电子表格数 | 250 个 / 天 | 3,200 次 / 天 |
触发器总运行时间 | 90 分钟 / 天 | 6 小时 / 天 |
网址提取调用次数 | 20,000 次 / 天 | 10 万 / 天 |
静态地图渲染 | 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 / 用户 |
每个脚本同时执行的次数 | 1000 | 1000 |
电子邮件附件 | 250 个 / 消息 | 250 个 / 消息 |
电子邮件正文大小 | 200 KB / 消息 | 400 KB / 消息 |
每封电子邮件的收件人数 | 50 个 / 邮件 | 50 个 / 邮件 |
电子邮件附件的总大小 | 25 MB / 消息 | 25 MB / 邮件 |
属性值大小 | 9 KB / 值 | 9 KB / val |
媒体资源总存储空间 | 500 KB / 属性存储区 | 500 KB / 媒体资源存储空间 |
触发器 | 20 个 / 用户 / 脚本 | 20 / 用户 / 脚本 |
网址 Fetch 响应大小 | 50 MB / 调用 | 50 MB / 调用 |
网址 Fetch Header | 100 次 / 通话 | 100 次 / 通话 |
网址 Fetch Header 大小 | 8 KB / 调用 | 8 KB / 调用 |
网址 Fetch POST 大小 | 50 MB / 调用 | 50 MB / 调用 |
网址 Fetch 网址长度 | 2 KB / 调用 | 2 KB / 调用 |
版本 | 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.
这表示您同时执行的脚本过多,但不一定是同一脚本。与上述异常一样,这种情况最常发生在单个电子表格中反复调用的自定义函数中。