导入CSV至Google Sheets遇update参数弃用警告及类型错误求助

问题场景 #

使用gspread将本地CSV导入Google Sheets时，原代码的sheet.update('A1', values)触发弃用警告，按提示调整参数后又出现两类错误：

• 用命名参数时提示TypeError: update() got an unexpected keyword argument 'range'
• 仅传values时提示TypeError: update() got multiple values for argument 'values'

原代码中CSV数据转换部分存在格式错误，同时update方法的参数使用不符合新版本要求。

错误原因分析 #

1. 参数顺序/命名错误：gspread新版本的update()方法已调整参数顺序，要求先传values再传range_name；命名参数需用range_name=而非range=。
2. 数据格式错误：原代码中values = [[cell] for row in csv_data for cell in row]将CSV的二维列表（行+列）错误转换为所有单元格单独成行的结构，既不符合表格排版需求，也可能引发参数解析问题。

解决方案 #

1. 修正CSV数据格式 #

csv.reader返回的csv_data本身就是符合gspread要求的二维列表（每行对应一个子列表），无需额外转换：

# 读取CSV后直接使用csv_data
with open(csv_file_path, mode='r') as file:
    reader = csv.reader(file)
    values = list(reader)  # 直接赋值给values，跳过错误的转换步骤

2. 正确调用update方法 #

两种合法调用方式任选其一：

方式一：调整参数顺序（values在前，range_name在后）

sheet.update(values, 'A1')

方式二：使用命名参数（明确指定参数名）

sheet.update(values=values, range_name='A1')

完整修正后的核心代码片段 #

# 读取CSV文件并准备数据
with open(csv_file_path, mode='r') as file:
    reader = csv.reader(file)
    values = list(reader)

# 清空原有内容后更新数据
sheet.clear()
sheet.update(values=values, range_name='A1')

验证效果 #

修正后代码不会触发弃用警告，CSV数据将按原行列结构正确导入Google Sheets，同时避免参数错误。

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