Google Sheets API append接口超2000行返回空响应问题求助

问题背景 #

调用sheets.spreadsheets.values.append接口时返回错误：API call to sheets.spreadsheets.values.append failed with error: Empty response，无详细错误信息。经测试，表格行数少于约2500行时API正常工作，行数超过2000-2500区间时，API无操作并返回空响应。由于性能需求，无法使用setValues()方法，场景为将首行公式复制到所有行，通过循环生成适配每行的公式二维数组作为API输入值。

可能原因 #

1. 请求数据量超限：当一次性append数千行公式时，公式的字符总量会让请求payload体积超出API的隐性限制，导致接口无响应。
2. 接口隐性行数限制：Google Sheets API的append接口对单次操作的行数存在未明确标注的阈值，超过阈值后会触发无响应的错误。

解决方案 #

1. 分批次调用append接口 #

将生成的公式数组拆分成多个小数组，分批发送请求，避免单次请求数据量过大。建议每次处理500-1000行，可根据实际情况调整批次大小。

2. 优化公式生成逻辑（可选） #

如果场景允许，使用数组公式替代逐行生成公式的方式，减少请求次数和数据量。例如将首行公式修改为数组公式，一次性应用到所有目标行，无需循环生成每行公式。

3. 验证目标Range有效性 #

确保append的起始Range格式正确，目标工作表不存在合并单元格、保护范围等可能干扰API操作的设置。

调整后的代码示例 #

try{
  let lastRow = sheet.getLastRow();
  let formulaRow = headers + 1; 
  let formula = getNewFormulaRange(formulaRange, formulaRow);

  let sourceFormulaRange = sheet.getRange(formula);
  const sourceFormulas = sourceFormulaRange.getFormulas()[0]; // 提取首行公式

  let formulasToBeApplied = [];

  for (let i = formulaRow+1; i <= lastRow; i++) {
      // 调整公式适配当前行
      const adjustedFormulas = sourceFormulas.map(formula => 
          formula.replace(new RegExp(`(\$?[A-Z]+)\$?${formulaRow}`, 'g'), (match, cellReference) => {
              return `${cellReference}${i}`;
          })
      );
      formulasToBeApplied.push(adjustedFormulas);
  }

  const options = {
    valueInputOption: "USER_ENTERED"
  }

  // 分批次处理，每次处理500行
  const batchSize = 500;
  for (let i = 0; i < formulasToBeApplied.length; i += batchSize) {
    const batch = formulasToBeApplied.slice(i, i + batchSize);
    const valueRange = Sheets.newValueRange();
    valueRange.values = batch;
    // 计算当前批次的起始行
    const currentStartRow = headers + 2 + i;
    const currentRange = `${sheet.getName()}!${getNewFormulaRange(formulaRange, currentStartRow)}`;
    Sheets.Spreadsheets.Values.append(valueRange, sheetId, currentRange, options);
    // 可选：添加短延迟避免请求频率超限
    Utilities.sleep(100);
  }
} catch (e) {
  console.error("API调用失败:", e);
}

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