如何在Gmail中仅导入带特定标签单封邮件的CSV附件？

问题根源 #

原脚本通过GmailApp.search获取邮件线程，而所有目标邮件同属一个线程，导致每次都会读取线程内的第一封邮件，而非对应标签的单封邮件。改用Gmail API的Gmail.Users.Messages.list可以直接获取符合条件的单封邮件，绕过线程限制。

前置操作 #

1. 在脚本编辑器中启用Gmail API：
   • 点击顶部菜单「扩展」→「Apps 脚本」
   • 在左侧菜单选择「服务」→ 点击「添加服务」
   • 找到「Gmail API」并添加，点击「确定」

修改后的脚本（以CapTemp05为例） #

function importCapTemp05() {
  var labelName = "CapTemp05";
  var sheetId = "1SRo3iBaza4l0G9mlg-jZ589lwaORtx_jfPgX3gR73P0";
  var sheetName = "CapTemp05_G";
  
  // 获取指定标签的ID
  var label = GmailApp.getUserLabelByName(labelName);
  if (!label) {
    console.log(`标签 ${labelName} 不存在`);
    return;
  }
  var labelId = label.getId();
  
  // 查询未读且带指定标签的单封邮件
  var response = Gmail.Users.Messages.list('me', {
    q: 'is:unread',
    labelIds: [labelId],
    maxResults: 1 // 只获取1封邮件
  });
  
  var messages = response.messages;
  if (!messages || messages.length === 0) {
    console.log(`没有找到未读的 ${labelName} 邮件`);
    return;
  }
  
  // 获取邮件详情
  var message = Gmail.Users.Messages.get('me', messages[0].id);
  var messageId = messages[0].id;
  
  // 查找CSV附件
  var csvAttachment = null;
  if (message.payload.parts) {
    for (var i = 0; i < message.payload.parts.length; i++) {
      var part = message.payload.parts[i];
      if (part.mimeType === 'text/csv' && part.filename) {
        csvAttachment = part;
        break;
      }
    }
  }
  
  if (!csvAttachment) {
    console.log(`邮件中没有找到CSV附件`);
    return;
  }
  
  // 下载并解析CSV内容
  var attachmentData = Gmail.Users.Messages.Attachments.get('me', messageId, csvAttachment.body.attachmentId);
  var csvContent = Utilities.newBlob(Utilities.base64Decode(attachmentData.data)).getDataAsString();
  var csvData = Utilities.parseCsv(csvContent, ',').slice(1); // 跳过表头
  
  // 将数据写入表格
  var sheet = SpreadsheetApp.openById(sheetId).getSheetByName(sheetName);
  if (!sheet) {
    console.log(`表格 ${sheetName} 不存在`);
    return;
  }
  
  // 清空原有数据并写入新数据
  sheet.clearContents();
  sheet.getRange(1, 1, csvData.length, csvData[0].length).setValues(csvData);
  
  // 处理B列格式（替换小数点为逗号）
  var columnB = sheet.getRange("B2:B" + (csvData.length + 1));
  columnB.setNumberFormat("@");
  var data = columnB.getValues();
  for (var row = 0; row < data.length; row++) {
    if (data[row][0]) {
      data[row][0] = data[row][0].toString().replace(".", ",");
    }
  }
  columnB.setValues(data);
  
  // 标记邮件为已读
  Gmail.Users.Messages.modify({removeLabelIds: ['UNREAD']}, 'me', messageId);
  console.log(`成功导入 ${labelName} 的CSV数据`);
}

核心改进点 #

• 直接通过Gmail API获取单封未读且带指定标签的邮件，完全绕过线程关联问题
• 精准定位CSV附件，避免处理非目标附件
• 添加了基础错误处理，避免因标签/表格/附件缺失导致脚本崩溃
• 使用API的modify方法标记邮件为已读，操作更精准

批量复用说明 #

对于CapTemp01到CapTemp12，只需复制上述函数，修改labelName、sheetName两个变量即可快速创建12个对应函数。

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