Gmail带标签消息日志到Sheets遇重复等问题及脚本优化需求

原脚本功能概述 #

原脚本可记录带有指定标签「Label1」的Gmail消息日期与主题，随后移除该线程的对应标签；但无需记录含"RE:"的回复类消息或"FWD:"的转发类消息。目前存在以下待解决问题：

• 脚本仅支持手动运行，需设置为每30分钟至1小时自动执行
• 每次拉取带标签消息至表格时会生成重复数据，需实现仅记录新增数据
• 移除旧标签后需添加新标签，以便识别已处理的消息

修改后的完整脚本 #

function processGmailLabels() {
  const ss = SpreadsheetApp.getActiveSheet();
  const targetLabel = GmailApp.getUserLabelByName("Label1");
  const processedLabelName = "已处理"; // 可自定义已处理标签名称
  let processedLabel = GmailApp.getUserLabelByName(processedLabelName);

  // 若"已处理"标签不存在则自动创建
  if (!processedLabel) {
    processedLabel = GmailApp.createLabel(processedLabelName);
  }

  // 提取表格中已记录的消息ID，用于去重
  const existingMessageIds = new Set();
  const dataRange = ss.getDataRange();
  const allRows = dataRange.getValues();
  // 假设第三列用来存储消息唯一ID（新增列）
  for (let i = 1; i < allRows.length; i++) {
    if (allRows[i][2]) {
      existingMessageIds.add(allRows[i][2]);
    }
  }

  const threads = targetLabel.getThreads();
  for (let i = 0; i < threads.length; i++) {
    const messages = threads[i].getMessages();
    for (let j = 0; j < messages.length; j++) {
      const message = messages[j];
      const subject = message.getSubject();
      const date = message.getDate();
      const messageId = message.getId();

      // 跳过回复、转发类消息，以及已记录过的消息
      if (subject.startsWith("RE:") || subject.startsWith("FWD:") || existingMessageIds.has(messageId)) {
        continue;
      }

      // 写入日期、主题、消息ID到表格
      ss.appendRow([date, subject, messageId]);
    }
    // 移除原标签，添加已处理标签
    threads[i].removeLabel(targetLabel);
    threads[i].addLabel(processedLabel);
  }
}

各问题的解决说明 #

1. 设置自动执行（每30分钟-1小时） #

在Google Apps Script编辑器中操作：

• 点击左侧菜单栏的「触发器」图标
• 点击「添加触发器」按钮
• 配置触发器参数：
  • 要运行的函数：选择processGmailLabels
  • 部署类型：选择「基于时间的触发器」
  • 时间驱动类型：选择「分钟计时器」
  • 间隔：选择「每30分钟」或「每60分钟」
• 完成配置后保存即可

2. 避免重复数据 #

核心修改逻辑：

• 在表格中新增第三列存储消息的唯一ID（通过message.getId()获取），每次运行脚本时先读取所有已存在的消息ID存入集合
• 处理消息时，先判断该消息ID是否已在集合中，若已存在则跳过写入操作

3. 添加已处理标签 #

核心修改逻辑：

• 脚本中新增对「已处理」标签的判断，若标签不存在则自动创建
• 移除原「Label1」标签后，为线程添加「已处理」标签，方便快速识别已处理的消息

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