Google Sheets Apps Script自定义函数自动重复执行问题求助

首先明确：Google Sheets自定义函数的执行时机并非完全由输入参数决定，当函数调用外部API时，Sheets的缓存机制、服务端内部刷新逻辑都可能触发函数自动重新执行，哪怕参数未变更。以下是几种可行的解决方式：

1. 新增显性触发参数，手动控制刷新 #

给函数添加一个仅用于触发刷新的参数（比如版本号、时间戳），只有手动修改这个参数时，函数才会重新执行逻辑。修改后的函数示例：

function TEST_APP(ticker, token, refreshFlag) {
  // 核心逻辑仅在refreshFlag变更时才重新计算
  return [ticker + ticker];
}

使用时在单元格输入=TEST_APP("AAPL", "your_token", C1)，将C1设为手动触发开关——需要刷新时，修改C1的值（比如从1改成2）即可。

2. 放弃自定义函数，改用触发器完全掌控执行时机 #

自定义函数的执行逻辑受Sheets限制，改用可安装触发器或手动按钮触发，彻底避免自动执行：

• 编写直接操作单元格的函数：

function fetchTDData() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  // 从指定单元格读取参数
  const ticker = sheet.getRange("A1").getValue();
  const token = sheet.getRange("A2").getValue();
  // 执行TD Ameritrade API请求逻辑
  const result = ticker + ticker;
  // 将结果写入目标单元格
  sheet.getRange("A3").setValue(result);
}

• 在Apps Script编辑器中，点击「编辑」→「当前项目的触发器」，添加手动触发（绑定到工作表按钮）或定时触发的规则，完全控制数据刷新时机。

3. 利用缓存服务限制API请求频率 #

如果需要保留自定义函数形式，通过CacheService缓存API返回结果，避免重复执行请求：

function TEST_APP(ticker, token) {
  const cache = CacheService.getUserCache();
  // 用ticker和token生成唯一缓存键
  const cacheKey = `td_api_${ticker}_${token}`;
  const cachedData = cache.get(cacheKey);

  // 缓存存在则直接返回，不执行API请求
  if (cachedData) {
    return [cachedData];
  }

  // 执行API请求逻辑
  const result = ticker + ticker;
  // 设置缓存过期时间（示例为3600秒，即1小时，可按需调整）
  cache.put(cacheKey, result, 3600);
  return [result];
}

这种方式下，即使Sheets自动触发函数执行，只要缓存未过期，就会直接返回缓存数据，不会重复调用API。

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