使用R与Google Sheets API修改图表标题时遇ChartSourceRange错误

问题原因 #

你的代码直接复用了从API获取的完整图表spec，但Google Sheets API返回的原始spec中，部分数据源相关字段（比如basicChart.domains[].sourceRange或series[].sourceRange）在R的列表解析/序列化过程中可能丢失了必填的sources数组结构，导致提交的spec被API判定为数据源无效——哪怕你只修改了标题，API仍会校验整个spec的完整性。

核心解决方案 #

不要提交完整的图表spec，而是通过updateChartSpec的fields参数明确指定只更新title字段，这样只需要传递修改后的标题和图表ID，无需处理复杂的数据源结构，彻底规避校验问题。

修改后的代码 #

update_title <- function(ssid, chart_num, new_title) {
  
  # 获取目标图表ID
  chart_ids <- find_chart_ids(ssid)
  target_chart_id <- chart_ids[chart_num]
  
  # 构建仅更新标题的请求，指定fields参数
  title_req <- list(
    updateChartSpec = list(
      chartId = target_chart_id,
      spec = list(title = new_title),
      fields = "title"  # 关键：告诉API只更新title字段
    )
  )

  req <- request_generate(
    "sheets.spreadsheets.batchUpdate",
    params = list(
      spreadsheetId = ssid,
      requests = title_req
    )
  )

  # 执行请求
  resp_raw <- request_make(req)
  response <- gargle::response_process(resp_raw)
}

# 调用示例
update_title("<ssid>", 8, "Test Title")

额外验证要点 #

1. 确认find_chart_ids返回的图表ID正确对应目标图表
2. 如果一定要复用完整spec，检查chart_spec$basicChart$domains和chart_spec$basicChart$series下的每个sourceRange是否包含非空的sources数组，结构应为：

   # 正确的sourceRange结构示例
   list(
     sources = list(
       list(
         sheetId = 123456,
         startRowIndex = 0,
         endRowIndex = 10,
         startColumnIndex = 0,
         endColumnIndex = 2
       )
     )
   )
   

   若存在空的sources数组，手动补全后再提交。

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