Google Apps Script邮件归档脚本报错：Gmail服务日调用超限

我在Google脚本控制台添加了一个自定义脚本，用于根据发件人过滤邮件并归档，脚本如下（为简洁起见已将原始发件人替换为xyz、abc等）：

function labelAndArchiveEmails() {
  var threads = GmailApp.search('(xyz.github.com OR abc.github.com OR alpha.github.com OR beta.github.com)');
  var label = GmailApp.getUserLabelByName("GitHub") || GmailApp.createLabel("GitHub");

  for (var i = 0; i < threads.length; i++) {
    threads[i].addLabel(label);
    threads[i].moveToArchive(); // This removes from Inbox
  }
}

const emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log(`Remaining email quota: ${emailQuotaRemaining}`);

该脚本最初运行正常，但现在收到错误邮件，手动运行时也提示相同错误：

Exception: Service invoked too many times for one day:

错误统计如下：

但我查询剩余邮件配额时显示为100：

const emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log(`Remaining email quota: ${emailQuotaRemaining}`);

请问该脚本报错的原因是什么？

你遇到的错误和MailApp的邮件发送配额无关，而是触发了Gmail服务的每日调用次数限制，以及单次执行时间限制：

• Gmail服务调用超限：Google Apps Script对GmailApp的每日调用次数有配额限制（普通用户每日约1000次）。你的脚本在循环中对每个邮件线程分别调用addLabel()和moveToArchive()，每个调用都会消耗一次Gmail服务配额。如果匹配到的邮件线程数量较多，会快速耗尽每日配额，触发Service invoked too many times for one day: gmail错误。
• 执行时间超限：Google Apps Script的单次脚本执行有最长时间限制（当前为6分钟）。如果匹配到的邮件线程数量过多，循环处理的时间会超过这个限制，导致Exceeded maximum execution time错误。

另外你查询的MailApp.getRemainingDailyQuota()是邮件发送配额，和Gmail服务的读写操作配额是完全独立的两个指标，所以即使发送配额剩余100，也不影响Gmail服务的操作配额。

通过批量操作减少Gmail服务调用次数，避免配额耗尽和超时：

function labelAndArchiveEmails() {
  var threads = GmailApp.search('(xyz.github.com OR abc.github.com OR alpha.github.com OR beta.github.com)');
  var label = GmailApp.getUserLabelByName("GitHub") || GmailApp.createLabel("GitHub");

  if (threads.length > 0) {
    // 批量给所有线程添加标签
    label.addToThreads(threads);
    // 批量归档所有线程
    GmailApp.moveThreadsToArchive(threads);
  }
}

批量方法addToThreads()和moveThreadsToArchive()不管处理多少线程，都只消耗1次服务调用配额，能大幅降低配额消耗，同时提升执行速度，避免超时。

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