如何在Apps Script中仅调用一次API即可提取多字段值存入Google Sheet

你可以通过缓存复用API返回值或者单函数返回多字段数组两种方式实现需求，不用再为每个字段单独写函数、重复请求接口：

方案1：保留单单元格调用习惯，用内置缓存复用请求 #

基于Apps Script自带的CacheService存储API返回结果，首次调用请求API，后续同批次调用直接读取缓存，仅需1个通用函数即可适配所有字段取值：

// 通用取值函数，传入字段名即可返回对应值
function getApiData(field) {
  // 初始化缓存，设置缓存过期时间（单位秒，最大支持21600秒即6小时）
  const cache = CacheService.getScriptCache();
  const CACHE_KEY = "api_full_response";
  const CACHE_EXPIRE = 300; // 这里设为5分钟，可根据你的实时性需求调整
  
  // 先尝试从缓存取完整数据
  let cachedData = cache.get(CACHE_KEY);
  let responseJson;
  
  if (cachedData) {
    // 缓存存在直接解析
    responseJson = JSON.parse(cachedData);
  } else {
    // 缓存不存在才发起API请求
    const url = "*****************";
    const apiRequest = UrlFetchApp.fetch(url);
    responseJson = JSON.parse(apiRequest);
    // 把完整响应存入缓存
    cache.put(CACHE_KEY, JSON.stringify(responseJson), CACHE_EXPIRE);
  }
  
  // 返回对应字段值，字段不存在返回空
  return responseJson[field] || "";
}

使用方法 #

在单元格中按需传入字段名即可：

• 取name：输入=getApiData("name")
• 取age：输入=getApiData("age")
• 取gender：输入=getApiData("gender")
• 取price：输入=getApiData("price")

方案2：一次性返回所有字段，效率最高 #

如果四个字段需要放在连续的相邻单元格，直接让函数返回数组，Google Sheet会自动溢出填充所有单元格，全程仅调用1次API，无需缓存：

function getAllApiData() {
  const url = "*****************";
  const apiRequest = UrlFetchApp.fetch(url);
  const responseJson = JSON.parse(apiRequest);
  // 按你需要的顺序返回字段数组，会自动横向填充到4个单元格
  return [responseJson.name, responseJson.age, responseJson.gender, responseJson.price];
}

使用方法 #

在第一个要放name的单元格输入=getAllApiData()，右侧三个单元格会自动填充age、gender、price的对应值。

兼容原有公式的改造方案 #

如果你不想修改已经填在单元格里的getName()/getAge()等公式，只需要加一个公共的缓存请求函数，原有四个函数调用这个公共函数即可：

// 公共请求+缓存逻辑
function getFullApiResponse() {
  const cache = CacheService.getScriptCache();
  const CACHE_KEY = "api_full_response";
  const CACHE_EXPIRE = 300;
  
  let cachedData = cache.get(CACHE_KEY);
  if (cachedData) return JSON.parse(cachedData);
  
  const url = "*****************";
  const apiRequest = UrlFetchApp.fetch(url);
  const responseJson = JSON.parse(apiRequest);
  cache.put(CACHE_KEY, JSON.stringify(responseJson), CACHE_EXPIRE);
  return responseJson;
}

// 原有四个函数不用改名字，直接调用公共逻辑即可
function getName() {
  return getFullApiResponse().name;
}
function getAge() {
  return getFullApiResponse().age;
}
function getGender() {
  return getFullApiResponse().gender;
}
function getPrice() {
  return getFullApiResponse().price;
}

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