如何使用Google Sheets API v4批量更新单个单元格？

你的代码存在两个核心错误导致触发接口500报错：

• setFields() 参数值非法：该参数用于指定你需要更新单元格的哪个属性，而非自定义标识，常见值如userEnteredValue（更新单元格值）、userEnteredFormat（更新单元格格式），你填写的自定义字符串BATCHUPDATE/BATCHUPDATE2不符合接口规范，直接触发后端解析错误。
• 缺少写入的具体值：UpdateCellsRequest仅配置了更新范围，没有指定需要写入的单元格内容，接口缺少必要参数触发内部错误。
• 未指定工作表ID：操作表格时需要明确指定目标工作表ID，你在构造GridRange时漏掉了该必填参数。

完全支持单次请求批量更新多个离散单元格，不需要分多次发起调用，两种常用实现方式如下：

方式1：沿用UpdateCellsRequest的批量写法 #

// 构造第一个单元格范围：第2行（索引从0开始计数）、第93列（CP列）
$range1 = new Google_Service_Sheets_GridRange();
$range1->setSheetId(你的工作表ID); // 工作表ID可从表格URL中获取
$range1->setStartRowIndex(1);
$range1->setEndRowIndex(2); // 范围规则为左闭右开，要覆盖索引1的行，结束索引需设为2
$range1->setStartColumnIndex(92);
$range1->setEndColumnIndex(93); // 列范围规则同行一致

// 构造第一个单元格的写入内容
$cellData1 = new Google_Service_Sheets_CellData();
$cellValue1 = new Google_Service_Sheets_ExtendedValue();
$cellValue1->setStringValue("第一个单元格要写入的内容");
$cellData1->setUserEnteredValue($cellValue1);

// 构造第一个更新请求
$request1 = new Google_Service_Sheets_UpdateCellsRequest();
$request1->setFields("userEnteredValue"); // 指定更新单元格值属性
$request1->setRange($range1);
$request1->setRows([new Google_Service_Sheets_RowData([
    'values' => [$cellData1]
])]);
$body1 = new Google_Service_Sheets_Request();
$body1->setUpdateCells($request1);

// 第二个单元格按相同逻辑构造
$range2 = new Google_Service_Sheets_GridRange();
$range2->setSheetId(你的工作表ID);
$range2->setStartRowIndex(5);
$range2->setEndRowIndex(6);
$range2->setStartColumnIndex(92);
$range2->setEndColumnIndex(93);

$cellData2 = new Google_Service_Sheets_CellData();
$cellValue2 = new Google_Service_Sheets_ExtendedValue();
$cellValue2->setStringValue("第二个单元格要写入的内容");
$cellData2->setUserEnteredValue($cellValue2);

$request2 = new Google_Service_Sheets_UpdateCellsRequest();
$request2->setFields("userEnteredValue");
$request2->setRange($range2);
$request2->setRows([new Google_Service_Sheets_RowData([
    'values' => [$cellData2]
])]);
$body2 = new Google_Service_Sheets_Request();
$body2->setUpdateCells($request2);

// 单次批量提交所有更新请求
$batchUpdateRequest = new \Google_Service_Sheets_BatchUpdateSpreadsheetRequest();
$batchUpdateRequest->setRequests([$body1, $body2]);
$service->spreadsheets->batchUpdate(你的表格ID, $batchUpdateRequest);

方式2：更简便的values.batchUpdate方法 #

如果仅需要更新单元格值、不需要调整格式，用该方法代码量可减少一半，直接用A1标记法指定单元格位置即可：

$body = new Google_Service_Sheets_BatchUpdateValuesRequest([
    'valueInputOption' => 'RAW', // 输入值按原始文本处理，也可设为USER_ENTERED按用户输入规则解析公式
    'data' => [
        [
            'range' => '工作表名称!CP2', // 对应第2行第93列
            'values' => [["第一个单元格内容"]]
        ],
        [
            'range' => '工作表名称!CP6', // 对应第6行第93列
            'values' => [["第二个单元格内容"]]
        ]
    ]
]);
$service->spreadsheets_values->batchUpdate(你的表格ID, $body);

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