如何将Google Sheets v4 API输出转换为标准JavaScript对象数组？

我之前也碰到过一模一样的问题——想把Google Sheets当轻量JSON后端用，搜了半天结果要么是针对旧版API的，要么解决的是完全不相关的问题。刚好我折腾过batchGet这个方法，给你分享下怎么处理它的返回格式，把它转成好用的JSON结构：

首先，咱们先看batchGet返回的原始格式（就是你调用那个链接得到的结构）：

{
  "spreadsheetId": "1kEhCvvbHt-9BZgKKp-eQsy7l0AkFtZ9_7cIhvyVGLZ8",
  "valueRanges": [
    {
      "range": "data!A1:Z1000",
      "majorDimension": "ROWS",
      "values": [
        ["id", "title", "content"],
        ["1", "First Item", "Hello World"],
        ["2", "Second Item", "Another Entry"]
      ]
    }
  ]
}

这个原始结构里，真正有用的数据在valueRanges[0].values里：第一行是表头，后面的行是具体数据。要把它转成标准的JSON对象数组，只需要写个简单的转换函数就行，比如用JavaScript的话：

function transformSheetData(response) {
  // 取出表头和数据行
  const [headerRow, ...dataRows] = response.valueRanges[0].values;
  
  // 把每行数据映射成以表头为键的对象
  return dataRows.map(row => {
    const item = {};
    headerRow.forEach((header, index) => {
      item[header] = row[index] || ''; // 处理空单元格的情况
    });
    return item;
  });
}

调用这个函数后，你就能得到这样的标准JSON结构：

[
  {"id": "1", "title": "First Item", "content": "Hello World"},
  {"id": "2", "title": "Second Item", "content": "Another Entry"}
]

另外还有几个需要注意的点：

• 一定要确保你的Google表格设置了正确的共享权限，比如改成“知道链接的人可以查看”，否则API调用会返回权限错误
• 可以通过调整ranges参数来限定返回的区域，比如ranges=data!A1:C10，避免返回大量空行
• 如果需要同时获取多个工作表的数据，只需要在请求里加多个ranges参数（比如ranges=data&ranges=config），然后遍历valueRanges数组分别处理就行

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