Google Sheets自定义函数调用Cloud Function时Identity Token为Null

核心原因 #

Google Sheets的自定义函数运行在受限沙箱环境中，出于安全限制，无法调用需要用户OAuth授权的操作，包括ScriptApp.getIdentityToken()——这就是你在单元格中执行自定义函数时令牌返回null，但直接在App Script编辑器中运行函数时能正常生成令牌的根本原因。

自定义函数是单元格计算时自动触发的，无法弹出授权提示，因此Google限制了这类函数的权限范围，禁止获取用户身份令牌等敏感信息。

可行解决方案 #

放弃使用单元格自定义函数，改用自定义菜单+主动触发的方式实现需求，具体步骤如下：

1. 创建自定义菜单 #

在App Script中添加代码，为Sheet生成自定义菜单，让用户主动点击触发函数：

function onOpen() {
  const ui = SpreadsheetApp.getUi();
  ui.createMenu('Cloud Function操作')
    .addItem('获取数据', 'fetchCloudFunctionData')
    .addToUi();
}

2. 实现带身份令牌的Cloud Function调用 #

编写函数获取Identity Token并调用Cloud Function，执行成功后将结果写入指定单元格：

function fetchCloudFunctionData() {
  try {
    // 获取用户身份令牌
    const token = ScriptApp.getIdentityToken();
    if (!token) {
      SpreadsheetApp.getUi().alert('无法获取身份令牌，请检查权限配置');
      return;
    }

    // 调用Cloud Function
    const url = 'https://asia-south1-test-project.cloudfunctions.net/你的函数名';
    const options = {
      method: 'GET', // 根据你的函数实际需求调整请求方法
      headers: {
        'Authorization': `Bearer ${token}`
      },
      muteHttpExceptions: true // 方便查看完整错误响应
    };

    const response = UrlFetchApp.fetch(url, options);
    const responseCode = response.getResponseCode();
    
    if (responseCode === 200) {
      // 将结果写入A1单元格（可根据需求修改目标位置）
      SpreadsheetApp.getActiveSpreadsheet().getActiveSheet().getRange('A1').setValue(response.getContentText());
    } else {
      SpreadsheetApp.getUi().alert(`调用失败，状态码：${responseCode}\n响应内容：${response.getContentText()}`);
    }
  } catch (e) {
    SpreadsheetApp.getUi().alert(`执行出错：${e.message}`);
  }
}

3. 验证配置 #

• 确保App Script项目已关联到Cloud Function所在的GCP项目
• 给用户授予Cloud Function Invoker权限即可（比Admin权限更贴合需求）
• 清单文件appsscript.json中的oauth范围保持现有配置即可

为什么自定义函数不可行？ #

Google明确限制了自定义函数的能力：

• 仅能调用部分Google服务，无法触发需要授权的操作
• 无法访问用户身份令牌，执行外部HTTP请求时无法携带用户身份信息
• 执行时间受限（最长30秒），且不支持异步操作

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