Gmail Apps Script发送邮件触发配额超限问题咨询

疑问解答 #

1. 仅发送10-15封触发配额超限且剩余配额显示-1？ #

• 触发短期速率限制而非每日配额：Google Workspace脚本的邮件服务除了每日100封的配额，还有分钟/小时级的速率限制（比如每分钟允许发送5-10封）。短时间内连续调用GmailApp.sendEmail，即使每日配额未耗尽，也会触发临时限流。此时MailApp.getRemainingDailyQuota()返回-1，是因为当前处于限流状态，并非真的用完每日配额。
• 配额统计延迟：临时限流触发时，配额统计接口可能返回不准确的-1值，代表当前操作被限制，而非实际剩余配额为负。
• 重复执行脚本：如果短时间内多次手动运行脚本，或者设置了高频时间触发器，累计发送量会快速触达速率限制阈值。

2. 剩余配额为-1时，等待10分钟后为何又能发送？ #

这是因为触发的是临时速率限制，而非每日配额耗尽。Google的临时限流会在几分钟到十几分钟后自动重置，冷却窗口过后，脚本就能重新调用邮件服务，此时每日配额其实仍有剩余。

避免问题的方案 #

1. 添加发送延迟控制速率 #

在每次发送邮件后添加延迟，避免短时间内密集调用。推荐每次延迟10-30秒，具体可根据实际调整：

function sendAutomatedEmails() {
  var drafts = GmailApp.getDrafts();
  var draftEmail = drafts.find(draft => draft.getMessage().getSubject() === "Specific Email");
  if (draftEmail) {
    var emailBody = draftEmail.getMessage().getBody();
    var emailSubject = draftEmail.getMessage().getSubject();
    GmailApp.sendEmail("123@email.com", emailSubject, '', {htmlBody: emailBody});
    // 添加30秒延迟
    Utilities.sleep(30000);
  }
}

2. 改用MailApp优化配额统计 #

MailApp的配额统计更准确，且部分场景下速率限制阈值更宽松，替换后可更清晰查看剩余配额：

function sendAutomatedEmails() {
  console.log("剩余邮件配额：" + MailApp.getRemainingDailyQuota());
  var drafts = GmailApp.getDrafts();
  var draftEmail = drafts.find(draft => draft.getMessage().getSubject() === "Specific Email");
  if (draftEmail) {
    var emailBody = draftEmail.getMessage().getBody();
    var emailSubject = draftEmail.getMessage().getSubject();
    MailApp.sendEmail("123@email.com", emailSubject, '', {htmlBody: emailBody});
    Utilities.sleep(20000);
  }
}

3. 批量发送时加入限流逻辑 #

如果需要批量发送多封邮件，建议在单个脚本循环中处理，同时加入配额检查和延迟：

function sendBatchEmails() {
  // 收件人列表示例
  var recipients = ["a@email.com", "b@email.com", "c@email.com"];
  var drafts = GmailApp.getDrafts();
  var draftEmail = drafts.find(draft => draft.getMessage().getSubject() === "Specific Email");
  
  if (!draftEmail) return;
  
  var emailBody = draftEmail.getMessage().getBody();
  var emailSubject = draftEmail.getMessage().getSubject();
  
  for (var i = 0; i < recipients.length; i++) {
    // 检查剩余配额，避免无效执行
    var remainingQuota = MailApp.getRemainingDailyQuota();
    if (remainingQuota <= 0) {
      console.log("每日配额已耗尽，停止发送");
      break;
    }
    
    MailApp.sendEmail(recipients[i], emailSubject, '', {htmlBody: emailBody});
    // 每发送一封延迟25秒（最后一封无需延迟）
    if (i !== recipients.length - 1) {
      Utilities.sleep(25000);
    }
  }
}

4. 调整脚本触发方式 #

• 避免手动连续点击运行脚本，若使用时间触发器，设置间隔至少为1分钟以上（推荐5分钟），避免高频触发。
• 不要在短时间内多次触发脚本，累计调用会快速触达速率限制。

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