Google Sheets自定义函数调用Gmail获最新邮件遇权限错误

我有一份过往联系人列表，想在Google Sheets里提取他们发来的最新邮件。参考教程实现从收件箱获取邮件的功能后，我把代码改成了带参数的函数：

function findLastEmail(text){
  var threads = GmailApp.search('from:"'+text+'"');
  var messages = threads[threads.length - 1].getMessages();
  var msgCount = threads[threads.length - 1].getMessageCount();
  message = messages[messages.length - 1];
  extractDetails(message,msgCount)
}

但在Google Sheets里用自定义函数=findLastEmail("abc@gmail.com")调用时，触发权限错误：

Exception: The script does not have permission to perform that action. Required permissions: (https://www.googleapis.com/auth/gmail.metadata || https://www.googleapis.com/auth/gmail.readonly || https://www.googleapis.com/auth/gmail.modify || https://mail.google.com/)
at findLastEmail(Code:25:24)

如果在Apps Script里手动把函数内的搜索条件写死为from:"abc@gmail.com"再运行，就没有错误。

这是因为Google Sheets的单元格自定义函数处于权限沙箱限制中，无法访问需要OAuth授权的服务（比如GmailApp）。而在脚本编辑器中直接运行函数时，是在已完成授权的环境下执行，所以能正常调用Gmail相关接口。

方案1：通过自定义菜单/按钮触发函数 #

绕开单元格自定义函数的沙箱限制，改用菜单或按钮在授权环境下执行函数：

// 打开表格时创建自定义菜单
function onOpen() {
  const ui = SpreadsheetApp.getUi();
  ui.createMenu('邮件提取工具')
    .addItem('提取选中联系人最新邮件', 'executeFindLastEmail')
    .addToUi();
}

// 执行逻辑：读取选中单元格的邮箱并调用原函数
function executeFindLastEmail() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const selectedCell = sheet.getActiveRange();
  const targetEmail = selectedCell.getValue();
  
  if (!targetEmail || !targetEmail.includes('@')) {
    SpreadsheetApp.getUi().alert('请选中包含有效邮箱的单元格');
    return;
  }
  
  findLastEmail(targetEmail);
}

// 保留原函数，新增空结果判断避免报错
function findLastEmail(text){
  var threads = GmailApp.search('from:"'+text+'"');
  
  if (threads.length === 0) {
    SpreadsheetApp.getUi().alert('未找到该联系人的邮件记录');
    return;
  }
  
  var lastThread = threads[threads.length - 1];
  var messages = lastThread.getMessages();
  var msgCount = lastThread.getMessageCount();
  var lastMessage = messages[messages.length - 1];
  
  extractDetails(lastMessage, msgCount);
}

操作步骤：

1. 保存代码后刷新Google Sheets，顶部会出现「邮件提取工具」菜单
2. 选中表格中包含目标邮箱的单元格
3. 点击菜单中的「提取选中联系人最新邮件」即可执行

方案2：使用宏功能 #

将函数保存为Google Sheets宏，通过快捷键或插入绘图按钮触发，本质和菜单方案一致，都是在授权环境下执行，避免沙箱限制。

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