使用Google Sheets API读取合并单元格的取值补全问题咨询

问题原因 #

谷歌表格API返回单元格数据时，合并区域仅左上角位置会返回实际数值，其余位置默认返回空值，所以会出现拿到的二维数组行长度不一致、对应位置缺值的情况。

实现步骤 #

1. 调整API请求参数，获取合并单元格元数据 #

原先使用的spreadsheets.values.get接口无法返回合并范围信息，需要改为调用spreadsheets.get接口，同时请求单元格值和合并范围字段：

// 替换为你自己的表格ID和读取范围
gapi.client.sheets.spreadsheets.get({
  spreadsheetId: '<YOUR_SPREADSHEET_ID>',
  ranges: 'Sheet1!A1:B3',
  fields: 'sheets.data.rowData.values.formattedValue,sheets.merges'
}).then(res => {
  const rawSheet = res.result.sheets[0];
  // 提取原始二维值数组
  const rawValues = rawSheet.data[0].rowData.map(row => 
    row.values?.map(cell => cell.formattedValue || '') || []
  );
  // 提取合并范围配置
  const mergeRanges = rawSheet.merges || [];
  // 调用处理函数得到填充后的结果
  const result = fillMergedCells(rawValues, mergeRanges);
  console.log(result); // 输出符合预期的二维数组
})

2. 实现合并单元格填充函数 #

按如下逻辑编写填充工具函数，自动把合并区域所有位置填充为左上角的值：

function fillMergedCells(rawValues, mergeRanges) {
  // 补全所有行到相同长度，避免索引越界
  const maxColumnCount = Math.max(...rawValues.map(row => row.length), 0);
  const processedValues = rawValues.map(row => {
    const fullRow = [...row];
    while(fullRow.length < maxColumnCount) fullRow.push('');
    return fullRow;
  });

  // 遍历所有合并范围，填充对应位置
  mergeRanges.forEach(range => {
    const { startRowIndex, endRowIndex, startColumnIndex, endColumnIndex } = range;
    // 取合并区域左上角的值作为填充值
    const fillValue = processedValues[startRowIndex][startColumnIndex];
    // 遍历合并区域所有单元格赋值
    for (let row = startRowIndex; row < endRowIndex; row++) {
      for (let col = startColumnIndex; col < endColumnIndex; col++) {
        processedValues[row][col] = fillValue;
      }
    }
  });

  return processedValues;
}

效果验证 #

针对你给出的示例，处理后会自动把第三行第二列的空值填充为25，和你期望的输出完全一致。

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