如何避免Google表格自定义函数自动执行？（Google Apps Script）

我最近刚好踩过这个坑：当你在Google Sheets里写自定义函数时，表格会在**编辑操作（比如添加行/列、修改单元格内容）**时自动触发重新计算，这就会让自定义函数反复执行。如果你的函数调用了付费API，这种无意义的重复调用直接就会消耗你的API额度——而且目前确实没有直接阻止这种自动重计算的官方方法。

不过我找到一个可行的 workaround：用Google Apps Script的UserCache服务把API返回的结果缓存一段时间，我设置的是25分钟，这样当表格再次触发重计算时，函数会先去缓存里找有效结果，不用每次都调用API。

具体实现示例 #

下面是我实际用的代码结构，你可以参考：

function MY_CUSTOM_FUNCTION(input) {
  // 获取当前用户的缓存实例
  const userCache = CacheService.getUserCache();
  // 根据输入参数生成唯一缓存键，确保不同输入对应不同缓存
  const cacheKey = `paid_api_response_${JSON.stringify(input)}`;

  // 先尝试读取缓存
  const cachedData = userCache.get(cacheKey);
  if (cachedData) {
    // 缓存存在，直接解析返回
    return JSON.parse(cachedData);
  }

  // 缓存失效/不存在，调用付费API
  const apiResponse = fetchPaidAPI(input);

  // 将结果存入缓存，设置25分钟（1500秒）后过期
  userCache.put(cacheKey, JSON.stringify(apiResponse), 1500);

  // 返回API结果
  return apiResponse;
}

// 这里替换成你的实际付费API调用逻辑
function fetchPaidAPI(input) {
  // 示例API调用，实际场景替换成你的请求代码
  const response = UrlFetchApp.fetch(`https://your-paid-api-endpoint.com?input=${input}`);
  return JSON.parse(response.getContentText());
}

几个关键细节 #

• 缓存键一定要和输入参数绑定，不然不同的输入会拿到错误的缓存结果，比如用JSON.stringify(input)来生成唯一标识就很实用。
• 25分钟的缓存时长是我权衡了数据新鲜度和API消耗后的选择，你可以根据自己的需求调整（比如数据更新不频繁的话可以设更久）。
• UserCache是用户级别的缓存，不同用户的缓存相互独立，不用担心数据安全问题。

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