如何使用Apps Script将Gmail邮件链接中的CSV文件导入Google Sheet

该需求完全可通过Apps Script实现，整体实现逻辑分为筛选指定邮件、提取CSV下载链接、拉取CSV内容、解析写入表格四个核心步骤，以下是可直接复用的实现示例及说明：

前置权限说明 #

运行脚本前需要在Apps Script编辑器中授权对应权限：

• Gmail读取权限，用于筛选和读取目标邮件
• UrlFetch访问权限，用于请求CSV链接获取内容
• Google Sheet编辑权限，用于写入解析后的CSV数据
• 若CSV链接为第三方站点资源，需确认链接无访问限制，或在请求中补充对应鉴权信息

完整实现代码 #

// 配置项，根据实际需求修改
const GMAIL_SEARCH_QUERY = 'subject:数据报表 发件人:data@example.com newer_than:1d'; // Gmail搜索规则，支持发件人、主题、时间等筛选条件
const TARGET_SPREADSHEET_ID = '替换为你的Google Sheet ID'; // 目标表格ID，可从表格URL中获取
const TARGET_SHEET_NAME = '导入数据'; // 要写入的工作表名称
const CSV_LINK_REGEX = /https?:\/\/[^\s<>"]+\.csv/gi; // CSV链接匹配正则，可根据实际链接格式调整

function importCsvFromGmailLink() {
  // 1. 搜索匹配的Gmail邮件
  const threads = GmailApp.search(GMAIL_SEARCH_QUERY, 0, 1); // 取最新的1条匹配邮件，可调整返回数量
  if (threads.length === 0) {
    console.log('未找到匹配的邮件');
    return;
  }
  const message = threads[0].getMessages()[0]; // 取线程内最新的一封邮件，可调整为遍历所有邮件
  const mailBody = message.getBody(); // 若需要提取纯文本正文的链接，可替换为getPlainBody()

  // 2. 提取邮件中的CSV下载链接
  const csvLinks = mailBody.match(CSV_LINK_REGEX);
  if (!csvLinks || csvLinks.length === 0) {
    console.log('邮件中未找到匹配的CSV链接');
    return;
  }
  const targetCsvLink = csvLinks[0]; // 取第一个匹配的CSV链接，可根据需求调整选取逻辑
  console.log('提取到CSV链接：', targetCsvLink);

  // 3. 请求获取CSV文件内容
  // 若链接需要鉴权，可在fetch的第二个参数中补充headers、muteHttpExceptions等配置
  const response = UrlFetchApp.fetch(targetCsvLink);
  const csvContent = response.getContentText('UTF-8'); // 可根据CSV实际编码调整字符集

  // 4. 解析CSV并写入Google Sheet
  const parsedData = Utilities.parseCsv(csvContent);
  const sheet = SpreadsheetApp.openById(TARGET_SPREADSHEET_ID).getSheetByName(TARGET_SHEET_NAME);
  // 清空原有数据后写入，若需要追加数据可替换为获取表格最后一行的逻辑
  sheet.clearContents();
  sheet.getRange(1, 1, parsedData.length, parsedData[0].length).setValues(parsedData);
  console.log('CSV数据导入完成，共写入' + parsedData.length + '行数据');
}

注意事项 #

• 首次运行前请先修改代码开头的配置参数，匹配你的实际业务场景
• 如果CSV下载链接需要登录校验，可在UrlFetchApp.fetch的第二个参数中补充对应的Cookie、Token等鉴权信息
• 若CSV使用非逗号的特殊分隔符，可在Utilities.parseCsv的第二个参数中指定分隔符，例如Utilities.parseCsv(csvContent, ';')
• 可在Apps Script中添加时间驱动触发器，实现脚本定时自动运行，无需手动触发执行

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