如何通过Google Sheets API的spreadsheets.batchUpdate批量更新并跳过合并行

不用插入空列表的核心思路是直接为每个数据指定目标单元格的精确位置，而非依赖API默认的连续行填充逻辑。同时通过格式请求批量设置自动换行，无需关心合并行的索引，直接按目标位置操作即可。

具体实现步骤 #

1. 构造批量更新的数据请求
   针对你的数据列表[[0], [1], [2], [3], [4], [5], [6]]，给每个值单独指定目标单元格（比如要放到A列的第1、3、5、7、9、11、13行）。在spreadsheets.batchUpdate中使用UpdateCellsRequest，每个数据对应一个单元格范围，避免连续填充。

2. 添加自动换行格式请求
   在同一个batch请求中加入RepeatCellRequest，设置目标单元格的wrapStrategy为WRAP，实现自动换行。

代码示例（Python） #

import google.auth
from googleapiclient.discovery import build

# 初始化API客户端
creds, _ = google.auth.default()
service = build('sheets', 'v4', credentials=creds)

spreadsheet_id = "你的表格ID"
sheet_id = 你的工作表ID # 可从表格URL或API获取
sheet_name = "Sheet1"
data_list = [[0], [1], [2], [3], [4], [5], [6]]

requests = []

# 1. 批量添加数据，隔行放置
for idx, value in enumerate(data_list):
    # 计算目标行：从第1行开始，每次间隔1行
    target_row = idx * 2 + 1
    requests.append({
        "updateCells": {
            "rows": [{"values": [{"userEnteredValue": {"numberValue": value[0]}}]}],
            "range": {
                "sheetId": sheet_id,
                "startRowIndex": target_row - 1,
                "endRowIndex": target_row,
                "startColumnIndex": 0,
                "endColumnIndex": 1
            },
            "fields": "userEnteredValue"
        }
    })

# 2. 批量设置自动换行，覆盖所有目标单元格范围
requests.append({
    "repeatCell": {
        "range": {
            "sheetId": sheet_id,
            "startRowIndex": 0,
            "endRowIndex": len(data_list)*2,
            "startColumnIndex": 0,
            "endColumnIndex": 1
        },
        "cell": {
            "userEnteredFormat": {
                "wrapStrategy": "WRAP"
            }
        },
        "fields": "userEnteredFormat.wrapStrategy"
    }
})

# 发送批量请求
response = service.spreadsheets().batchUpdate(
    spreadsheetId=spreadsheet_id,
    body={"requests": requests}
).execute()

print("更新完成:", response)

关键说明 #

• 忽略合并行：直接通过行索引指定目标单元格，不管这些行是否合并，只要索引正确，数据就会填充到指定位置（若目标单元格是合并区域的左上角，数据会自动覆盖整个合并区域）。
• 灵活调整间隔：如果需要修改隔行的间隔，只需调整target_row的计算公式，比如要隔两行放数据，可改为idx * 3 + 1。
• 效率优化：将数据更新和格式设置放在同一个batchUpdate请求中，减少API调用次数，提升操作效率。

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