如何实现Google Sheet异步批量调用API并写入响应？

问题分析 #

你当前的代码中，UrlFetchApp.fetch()是同步阻塞方法，即便将函数声明为async，内部也没有真正的异步逻辑——循环会逐个等待API请求完成才继续执行，导致所有数据要等全部请求结束后才会写入，无法实现“哪个API响应先到就先写入表格”的需求。

解决方案 #

通过将API请求包装为Promise，让多个请求并行发起，每个请求完成后立即执行表格写入操作，无需等待其他请求。

修改后的异步请求函数 #

将API调用和表格写入逻辑封装为返回Promise的函数，确保每个请求完成后能立即处理结果：

function insertApiResponseIntoCell(input, sheet) {
  return new Promise((resolve, reject) => {
    try {
      // 替换为实际API地址，按需拼接input参数
      const apiUrl = `YOUR_API_URL_HERE?input=${encodeURIComponent(input)}`;
      const response = UrlFetchApp.fetch(apiUrl);
      const responseBody = response.getContentText();
      const responseData = JSON.parse(responseBody);
      
      // 获取当前表格最后一行，写入响应数据
      const lastRow = sheet.getLastRow() + 1;
      const targetRange = sheet.getRange(lastRow, 1, 1, responseData.length);
      // 注意：setValues接受二维数组，直接传入[responseData]即可展开为一行
      targetRange.setValues([responseData]);
      
      resolve(`已写入input: ${input}`);
    } catch (error) {
      reject(`处理input: ${input}失败: ${error.message}`);
    }
  });
}

主处理函数 #

遍历数组并行发起所有请求，每个请求完成后自动写入表格：

function processAllRequests() {
  const input_data = ["value1", "value2", /* ... */ "value30"];
  const mySheet = SpreadsheetApp.openById('YOUR_SHEET_ID').getActiveSheet();
  
  // 遍历数组，为每个元素发起异步请求
  input_data.forEach(each => {
    insertApiResponseIntoCell(each, mySheet)
      .then(msg => console.log(msg))
      .catch(err => console.error(err));
  });
}

注意事项 #

• Google Apps Script是单线程环境，但通过Promise可以实现UrlFetchApp请求的并行发起（底层会建立多个HTTP连接），从而达到响应先到先写入的效果。
• 注意GAS的请求配额限制，同时发起的请求数量建议控制在合理范围内（30个属于安全阈值）。
• 若API需要传递input参数，务必用encodeURIComponent()处理，避免URL编码错误。
• 写入表格时，setValues()要求传入二维数组，若responseData是一维数组，直接使用[responseData]即可，不要嵌套成[[responseData]]（否则会把整个数组存入单个单元格）。

内容的提问来源于stack exchange，提问作者G Madhabananda Patra