如何使用pygsheets批量验证与格式化单元格？

批量设置数据验证规则 #

pygsheets没有直接的批量API，但可以通过本地构造含验证规则的单元格对象列表，再用update_cells批量提交，避免逐个单元格发起API请求。示例如下：

import pygsheets

# 初始化连接（已完成授权前提下）
gc = pygsheets.authorize(service_file='credentials.json')
sheet = gc.open('目标表格名').sheet1

# 定义数据验证规则（以下拉列表为例）
dv_rule = pygsheets.DataValidation(
    type='LIST',
    values=['选项A', '选项B', '选项C'],
    showCustomUi=True
)

# 选中目标单元格范围（如A1:A20）
cell_range = sheet.range('A1:A20')
# 本地为每个单元格绑定验证规则
for cell in cell_range:
    cell.data_validation = dv_rule

# 批量提交验证规则，指定仅更新dataValidation字段
sheet.update_cells(cell_range, fields='dataValidation')

批量设置单元格格式（加粗、灰色背景） #

同样通过本地构造格式属性，一次性提交格式修改：

# 选中目标单元格范围（如B1:B20）
cell_range = sheet.range('B1:B20')

# 批量设置格式：加粗+浅灰色背景
for cell in cell_range:
    # 开启加粗
    cell.text_format['bold'] = True
    # 设置RGB背景色（浅灰色）
    cell.background_color = (0.9, 0.9, 0.9, 1)

# 批量提交格式修改，指定更新textFormat和backgroundColor字段
sheet.update_cells(cell_range, fields='textFormat,backgroundColor')

自适应列宽 #

pygsheets的Worksheet对象自带批量调整列宽的方法，无需逐个列处理：

# 调整A至C列宽度为自适应内容
sheet.adjust_column_width(start=1, end=3, pixel_size=None)

# 若需固定宽度，可指定pixel_size值（如180像素）
# sheet.adjust_column_width(start=1, end=3, pixel_size=180)

补充说明 #

上述代码中的循环仅在本地构造单元格属性，最终仅发起1次API请求，和逐个单元格调用API的性能差异极大。如果处理超大规模单元格范围（如上万行），可分块拆分范围后批量提交，避免单次请求数据量超限。

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