如何通过Google Sheets API在Python中调用randomizeRange？代码报错排查

问题重现 #

运行以下Python代码尝试随机化Google Sheets单元格范围时：

requests = {
    'randomizeRange': {
        'range': {
            'ranges': ['Sheet1!A3:A32']
        }
    }
}
request = sheet.batchUpdate(spreadsheetId=sheet_id, body=requests)
r = request.execute()
print(r)

触发错误：

Invalid JSON payload received. Unknown name "randomizeRange": Cannot find field.

问题根源 #

代码存在两个核心格式错误，完全不符合Google Sheets API的batchUpdate规范：

1. 请求体结构错误：batchUpdate要求请求体必须以requests数组作为顶级键，所有操作都要包裹在这个数组里。你直接把randomizeRange作为顶级键，API根本识别不了这个字段。
2. Range参数格式错误：randomizeRange操作只接受单个range对象（不是ranges数组），数组形式是其他批量操作的参数格式，这里用错了。

修复后的代码 #

方式1：使用A1表示法（简单直观）

# 正确构造请求体：requests是数组，包含单个randomizeRange操作
requests_body = {
    'requests': [
        {
            'randomizeRange': {
                'range': 'Sheet1!A3:A32'  # 直接传入A1格式的范围字符串
            }
        }
    ]
}
request = sheet.batchUpdate(spreadsheetId=sheet_id, body=requests_body)
r = request.execute()
print(r)

方式2：使用结构化GridRange（更稳定，不受工作表名称变更影响）

如果需要更精确的控制，建议用工作表ID和行列索引构造范围（行/列索引从0开始，endRowIndex和endColumnIndex是排他的）：

# 假设你已经通过API获取到Sheet1的sheet_id（比如sheet1_id = 123456）
requests_body = {
    'requests': [
        {
            'randomizeRange': {
                'range': {
                    'sheetId': sheet1_id,
                    'startRowIndex': 2,   # A3对应第2行索引（0开始）
                    'endRowIndex': 32,    # 到第31行（A32），end是排他的
                    'startColumnIndex': 0,
                    'endColumnIndex': 1
                }
            }
        }
    ]
}
request = sheet.batchUpdate(spreadsheetId=sheet_id, body=requests_body)
r = request.execute()
print(r)

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