Google Sheets BatchUpdate传对象报错，如何同时更新单元格值与格式？

先解决当前报错 #

你遇到的“Starting an object on a scalar field”错误，核心原因是userEnteredValue.stringValue要求传入字符串标量值，但你传了一个对象。把{object containing the row}替换成实际的字符串内容即可修复。

修正后的updateCells请求代码示例：

const request = [{
  updateCells: {
    range: {
      sheetId: grid.sheetId,
      startRowIndex: grid.startRow,
      endRowIndex: grid.endRow,
      startColumnIndex: grid.startCol,
      endColumnIndex: grid.endCol
    },
    rows: [
      // 每个元素对应一行数据
      {
        values: [
          // 每个元素对应该行的一个单元格
          {
            userEnteredFormat: {
              backgroundColor: {
                red: 1,
                green: 0.4,
                blue: 0.4
              }
            },
            userEnteredValue: {
              stringValue: "实际的单元格文本内容" // 这里必须是字符串，不能是对象
            }
          }
          // 该行若有多个单元格，继续添加CellData对象
        ]
      }
      // 若要更新多行，继续添加RowData对象到rows数组
    ],
    fields: "userEnteredFormat,userEnteredValue"
  }
}];

关于支持行数据数组/对象的请求类型 #

Google Sheets API的BatchUpdate中，updateCells本身就支持传入多行多列的数组数据，无需额外请求类型。只要遵循以下结构：

• rows是RowData类型的数组，每个RowData的values是CellData数组，对应该行的所有单元格配置。
• 批量更新多行时，直接在rows数组中添加多个RowData对象即可。

另外，也可以使用updateRows请求类型，它更聚焦于整行更新，结构和updateCells类似，同样支持传入RowData数组：

const request = [{
  updateRows: {
    rows: [
      {
        values: [
          {
            userEnteredFormat: { backgroundColor: { red:1, green:0.4, blue:0.4 } },
            userEnteredValue: { stringValue: "单元格内容" }
          }
        ]
      }
    ],
    sheetId: grid.sheetId,
    startRowIndex: grid.startRow,
    fields: "userEnteredFormat,userEnteredValue"
  }
}];

关键注意事项：所有标量字段（如stringValue、numberValue）必须传入对应类型的原始值，不能传对象，这是避免此类报错的核心。

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