Google 服务的配额

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

某些功能还有其关联 Google 产品的额外配额。使用产品的 Apps 脚本服务会占用所有关联的配额储备。如果您达到任何关联的配额,相应功能将无法使用。

当前配额

消费者账号(例如 gmail.com)和 Google Workspace 账号的用户配额设置在不同级别。 配额按用户计算,并在首次请求 24 小时后重置。

您可以使用以下配额来帮助测试脚本。Google 有权随时取消、减少或更改所有配额,恕不另行通知。

功能 消费者账号(例如 gmail.com) Google Workspace
账号
创建的日历活动数 5,000 个 / 天 10,000 个 / 天
创建的联系人数 1,000 个 / 天 2,000 个 / 天
已创建文档 250 个 / 天 1,500 个 / 天
转换的文件数 2,000 个 / 天 4,000 个 / 天
每天的电子邮件收件人数(例如使用 MailApp) 100个* / 天 1,500个* / 天
网域内每天的电子邮件收件人数(例如使用 MailApp) 100个* / 天 2,000 个 / 天
电子邮件读/写(不包括发送) 20,000 个 / 天 50,000 个 / 天
群组读取次数 2,000 次 / 天 10,000 次 / 天
JDBC 连接数 10,000 个 / 天 50,000 个 / 天
JDBC 连接失败次数 100 次 / 天 500 次 / 天
已创建演示文稿 250 个 / 天 1,500 个 / 天
属性读/写 50,000 次 / 天 500,000 次 / 天
已创建幻灯片 250 个 / 天 1,500 个 / 天
创建的电子表格数 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 个 / 天

试用账号有额外的限制。当您将免费试用账号转换为付费订阅后,如果满足以下两个条件,您账号的限制会自动提高:

  • 您的网域累计支付的金额已至少达到 100 美元(或等值金额)。
  • 达到该付款最低限额已至少 60 天。

当前限制

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

功能 消费者账号(例如 gmail.com) 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 / 次调用
网址提取 Header 100 个 / 次调用 100 个 / 次调用
网址提取 Header 大小 8 KB / 次调用 8 KB / 次调用
网址提取 POST 大小 50 MB / 次调用 50 MB / 次调用
网址提取网址长度 2 KB / 次调用 2 KB / 次调用
版本 200 个 / 脚本 200 个 / 脚本

监控配额使用情况

如需监控脚本的配额消耗情况和执行健康状况,请使用以下方法:

  • 电子邮件配额:使用 MailApp.getRemainingDailyQuota() 检查您在 当天剩余时间内可以发送的电子邮件收件人数量。
  • 执行监控:使用 Apps 脚本信息中心查看 脚本的执行历史记录和健康状况。我的执行 页面会显示每次脚本执行的状态(例如 CompletedFailedRunning)。您可以按 StatusRunning 的执行情况进行过滤,以监控并发执行次数。
  • Google Cloud 控制台:如果您的 Apps 脚本项目使用 标准 Google Cloud 项目, 您可以在 Google Cloud 控制台中监控特定于服务的配额和 API 使用情况。

异常消息

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