Google 服务的配额

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.这表示您同时执行的脚本过多,但不一定是同一脚本。与上述异常一样,这种情况最常发生在单个电子表格中反复调用的自定义函数中。