如何在Node.js中使用batchUpdate操作Google表格？

我一直使用以下JavaScript方法访问Google表格，实现单行数据插入：

const Sheets = require("@googleapis/sheets");
const jwt = new Sheets.auth.JWT(xxemailxx, null, xxprivate keyxx, [...]);
await jwt.authorize();

const sheets = Sheets.sheets("v4");
sheets.spreadsheets.values.append({
    auth: jwt,
    spreadsheetId: "xxxxxxx",
    range: "Sheet1",
    resource: { values: [[1,2,3,4]]}
  }, (err, response) => {
   // ...回调逻辑
   }
});

注：我通过传入JWT进行API调用，该方法已稳定运行多年。现在想使用batchUpdate追加多行数据，但找不到针对Node.js的相关文档。@googleapis/sheets仓库中的链接指向Web服务API文档，尝试多种传入requestbody的方式均未成功。

请问：使用batchUpdate API的可行方法是什么？是否有针对Node.js的batchUpdate专属文档？

一、batchUpdate批量追加多行的代码实现 #

要通过batchUpdate批量追加数据，核心是构造requests数组，使用AppendCellsRequest指定插入的行数据。以下是适配你现有JWT授权方式的完整代码：

const Sheets = require("@googleapis/sheets");
const jwt = new Sheets.auth.JWT(xxemailxx, null, xxprivate keyxx, ["https://www.googleapis.com/auth/spreadsheets"]);
await jwt.authorize();

const sheets = Sheets.sheets("v4");

// 要批量插入的多行数据
const rows = [
  ["数据1-1", "数据1-2", "数据1-3"],
  ["数据2-1", "数据2-2", "数据2-3"],
  ["数据3-1", "数据3-2", "数据3-3"]
];

sheets.spreadsheets.batchUpdate({
  auth: jwt,
  spreadsheetId: "xxxxxxx",
  resource: {
    requests: [
      {
        appendCells: {
          sheetId: 0, // 注意：这里是工作表的数字ID，不是名称。Sheet1默认ID为0，可从表格URL的#gid=后获取
          rows: rows.map(row => ({
            values: row.map(cell => ({ userEnteredValue: { stringValue: cell } }))
          })),
          fields: "userEnteredValue" // 指定要更新的字段，仅需值时填这个即可
        }
      }
    ]
  }
}, (err, response) => {
  if (err) {
    console.error("批量插入失败:", err);
    return;
  }
  console.log("批量插入成功:", response.data);
});

二、关键注意事项 #

• 工作表ID（sheetId）：必须传入数字类型的工作表ID，而非名称。可通过Google Sheets URL（#gid=后的数字）或spreadsheets.get接口查询获取。
• 数据格式转换：batchUpdate要求每个单元格数据包装为userEnteredValue对象，不同数据类型对应不同属性：
  • 字符串用stringValue
  • 数字用numberValue
  • 布尔值用boolValue
• 权限范围：确保JWT授权的权限范围包含https://www.googleapis.com/auth/spreadsheets，读写数据用这个范围足够。

三、关于Node.js专属文档 #

目前@googleapis/sheets没有单独的Node.js版batchUpdate文档，但可以直接参考官方Web API的batchUpdate参数结构，按Node.js客户端规则调整传入方式：

• Node.js客户端的resource字段对应Web API的请求体，requests数组的结构和Web API完全一致。
• Web API定义的所有请求类型（如AppendCellsRequest、UpdateCellsRequest等），都可直接在Node.js客户端的requests数组中使用。

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