如何使用Google Sheets API v4将新数据插入谷歌表格顶部？

我明白你想要把新订单放在Google Sheets的顶部，而不是默认追加到末尾的需求～ 之前用AppendValuesResponse的方法是往最后一行追加数据，要实现最新订单在顶部的效果，我们可以通过「先插入空行，再写入数据」的方式来完成，下面是和你之前使用的Java客户端匹配的具体实现：

步骤1：在顶部插入空行 #

如果你的表格第一行是表头，我们需要在表头下方（第2行）插入新行；如果没有表头，直接在第1行插入即可。这里以有表头的场景为例：

import com.google.api.services.sheets.v4.model.*;
import java.util.Collections;

// 替换为你的表格ID
String spreadsheetId = "你的Google Sheets文档ID";
// 替换为目标工作表的ID（默认第一个工作表是0）
int sheetId = 0;

// 创建插入行的请求：在第2行（索引1）插入1行
InsertDimensionRequest insertRowRequest = new InsertDimensionRequest()
    .setRange(new DimensionRange()
        .setSheetId(sheetId)
        .setDimension("ROWS")
        .setStartIndex(1) // 起始行索引（0对应第1行，1对应第2行）
        .setEndIndex(2)); // 结束行索引，Start和End差1表示插入1行

// 打包成批量更新请求
BatchUpdateSpreadsheetRequest batchUpdate = new BatchUpdateSpreadsheetRequest()
    .setRequests(Collections.singletonList(new Request().setInsertDimension(insertRowRequest)));

// 执行插入操作
service.spreadsheets().batchUpdate(spreadsheetId, batchUpdate).execute();

步骤2：将订单数据写入新插入的行 #

插入空行后，我们把订单数据写入这一行（也就是现在的第2行）：

import java.util.Arrays;
import java.util.List;

// 准备你的订单数据，按列顺序排列
List<List<Object>> orderData = Arrays.asList(
    Arrays.asList("ORD-20240520-001", "2024-05-20", "无线耳机", "299", "张三")
);

// 定义写入范围：Sheet1的A2到E2（根据你的列数调整）
ValueRange body = new ValueRange()
    .setRange("Sheet1!A2:E2") // 替换为你的工作表名称和对应列范围
    .setValues(orderData)
    .setMajorDimension("ROWS");

// 执行写入操作，USER_ENTERED会自动处理数据格式（比如日期、数字）
UpdateValuesResponse updateResponse = service.spreadsheets().values()
    .update(spreadsheetId, "Sheet1!A2:E2", body)
    .setValueInputOption("USER_ENTERED")
    .execute();

// 可选：打印写入结果确认
System.out.println("写入了 " + updateResponse.getUpdatedCells() + " 个单元格");

关键注意事项 #

• 如果你的表格没有表头，只需要把插入行的StartIndex设为0，EndIndex设为1，写入范围改成Sheet1!A1:E1即可。
• 确保你的Google Sheets API服务账号拥有目标文档的编辑权限。
• setValueInputOption参数：选RAW会直接写入原始值，选USER_ENTERED会模拟手动输入的格式（比如自动识别日期、货币格式），根据你的需求选择。

内容的提问来源于stack exchange，提问作者S.O.S