如何使用batchUpdate在顶部插入新行，然后插入5个数据单元格？

Question

我正在使用Google Sheets客户端库将新行插入到电子表格中，然后在顶部行（但在标题行下方）中写入一些数据。

batchUpdate方法应该允许那些使用它的人以这样的方式组合操作：如果一个操作失败，其他操作也会失败。这在我的情况下是最好的，因为我不想在第2行插入数据，除非我已经成功地在第一行的顶部插入了新行。

然而，我不太明白如何正确使用应用编程接口。结果是在顶部插入了一个新行，但我的数据点中只有一个正在写入第一个单元格，但不是行中的所有5个单元格。这里是API调用：

const sheets = google.sheets({ version: 'v4', auth });
sheets.spreadsheets.batchUpdate({
    spreadsheetId: SHEET_ID,
    "resource": {
        "requests": [
            {
                "insertDimension": {
                    "range": {
                        "sheetId": 0,
                        "dimension": "ROWS",
                        "startIndex": 1,
                        "endIndex": 2
                    },
                    "inheritFromBefore": false
                }
            },
            {
                "updateCells": {

                    "rows": 
                        {
                            values: [{
                                "userEnteredValue": {
                                    stringValue: "Dec 14-Sep 20"
                                },
                                "userEnteredValue": {
                                    numberValue: 10
                                },
                                "userEnteredValue": {
                                    numberValue: 5
                                },
                                "userEnteredValue": {
                                    numberValue: 1
                                },
                                "userEnteredValue": {
                                    numberValue: 0.2
                                },
                            }]
                        }
                    ,
                    "fields": "*",
                    // "start": {
                    //     "sheetId": 0,
                    //     "rowIndex": 1,
                    //     "columnIndex": 4
                    // },
                    "range": {
                        "sheetId": 0,
                        "startRowIndex": 1,  // I want to write to second row only
                        "endRowIndex": 2,
                        "startColumnIndex": 0, // start at first column
                        "endColumnIndex": 5   // end at 5th column
                    }
                }
            }
        ]
    }
}, (err, res) => {
    if (err) return console.log('The API returned an error: ' + err);
    } else {
        console.log('No data found.');
    }
});

如您所见，我指定了一个范围，但是数据；具体来说，数据数组中的最后一个值0.2正在写入工作表中的第一列。我还尝试使用“开始”网格坐标而不是“范围”网格范围，但结果是一样的。

我需要修改什么才能将数据数组中的所有5个值写入工作表中，一次一行，一列？

Answer 1

问题不在开始或范围属性中；相反，问题是传递到rows数组的对象的格式不正确。

现在，谷歌确实让使用batchUpdate修改单元格的API变得相当复杂。首先，在UpdateCellsRequest的文档中，我们看到rows[]数组接受一个RowData对象。RowData是一个具有键“values”的对象，其中包含CellData对象数组，但每个CellData对象都必须包装在一组{}中。

CellData对象由一个或多个属性组成，在本例中，我们选择“userEnteredValue”。它包含一个ExtendedValue对象，可以是number、string、bool、formula或error，它是这个复杂的嵌套对象系列中的最后一个。

上面代码的问题是，在文档中，row属性被标记为数组，但它实际上是一个包含数组的对象；因此，您错过了“row”后面的花括号。

以下是你应该拥有的：

           {
                "updateCells": {
                    "rows":
                    {
                        values: [
                            {
                                "userEnteredValue": {
                                    stringValue: "Dec 14-Sep 20"
                                }
                            },
                            {
                                "userEnteredValue": {
                                    numberValue: 10
                                }
                            },
                            {
                                "userEnteredValue": {
                                    numberValue: 5
                                }
                            },
                            {
                                "userEnteredValue": {
                                    numberValue: 1
                                }
                            },
                            {
                                "userEnteredValue": {
                                    numberValue: 0.2
                                }
                            }
                        ]
                    }
                    ,
                    "fields": "*",
                    "range": {
                        "sheetId": 0,
                        "startRowIndex": 1,
                        "endRowIndex": 2,
                        "startColumnIndex": 0,
                        "endColumnIndex": 5
                    }
                }
            }