如何用pygsheets更新Google Sheets折线图的属性与数据范围？

核心思路 #

pygsheets的Chart对象内部封装了Google Charts API的JSON结构，可直接修改_chart属性对应的JSON字段，再调用update()方法提交变更，无需依赖domain参数是否存在。

1. 创建新图表时配置属性 #

创建图表后，直接修改chart_obj._chart的JSON字段，再执行update()保存配置：

import pygsheets

# 假设已完成授权并获取wks工作表对象
chart_title = "每日数据趋势"
chart_range = [('F6', 'L6'), ('F7', 'L7'), ('F8', 'L8'), ('F9', 'L9')]
chart_anchor_cell = 'F2'
chart_domain = None

found_charts = wks.get_charts(chart_title)
if len(found_charts) == 0:
    print("创建新图表...")
    chart_obj = wks.add_chart(
        domain=chart_domain,
        ranges=chart_range,
        title=chart_title,
        chart_type=pygsheets.ChartType.LINE,
        anchor_cell=chart_anchor_cell
    )
    
    # 设置X/Y轴标题
    chart_obj._chart['axes']['axis'] = [
        {"position": "BOTTOM", "title": "日期"},
        {"position": "LEFT", "title": "数值"}
    ]
    # 设置图例位置（顶部居中）
    chart_obj._chart['legend']['position'] = "TOP_CENTER"
    # 设置图表大小
    chart_obj._chart['size']['width'] = 800
    chart_obj._chart['size']['height'] = 400
    
    # 提交变更
    chart_obj.update()

2. 更新已有图表的属性 #

找到目标图表后，修改_chart字段并调用update()：

found_charts = wks.get_charts(chart_title)
if len(found_charts) != 0:
    print("更新现有图表...")
    chart_obj = found_charts[0]
    
    # 更新数据范围：替换series里的range值
    new_ranges = [('F6', 'M6'), ('F7', 'M7'), ('F8', 'M8'), ('F9', 'M9')]
    sheet_id = wks.id
    for idx, (start, end) in enumerate(new_ranges):
        # 转换为Google API的0起始索引格式
        chart_obj._chart['spec']['series'][idx]['range'] = {
            "sheetId": sheet_id,
            "startRowIndex": int(start[1:])-1,
            "endRowIndex": int(start[1:]),
            "startColumnIndex": ord(start[0])-ord('A'),
            "endColumnIndex": ord(end[0])-ord('A')+1
        }
    
    # 更新图表标题
    chart_obj._chart['title'] = "更新后的每日数据趋势"
    # 隐藏图例
    chart_obj._chart['legend']['position'] = "NONE"
    
    # 提交变更
    chart_obj.update()

关键说明 #

• 核心可修改字段参考：
  • axes：配置坐标轴标题、显示位置
  • legend：控制图例位置、是否显示
  • size：设置图表宽高
  • spec.series：更新系列数据范围
• 索引转换注意：Google Sheets API使用0起始索引，需将pygsheets的1起始单元格地址手动转换（例如F6对应行索引5、列索引5）
• 无论domain参数是否为None，修改_chart后调用update()即可生效

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