Google Apps Script 如何实现跨图表复制全量配置覆盖目标图表

需要使用chart2的全量配置项覆盖chart1的现有配置，要求复制所有配置项，包含但不限于：

• 所有格式配置
• 参考区间
• 其余全部配置项

最初尝试通过chart.getOptions()提取chart2的配置后应用到chart1，测试代码如下：

function overwriteChartOptions(chart1, chart2) {
  var options = chart2.getOptions();
  var chart1 = chart1.modify()
    .setOption(options)
    .build();

  sheet1.updateChart(chart1);
}

overwriteChartOptions(sheet.getCharts()[0], sheet.getCharts()[1])

运行后触发报错：
Exception: The parameters (String) don't match the method signature for SpreadsheetApp.EmbeddedChartBuilder.setOption.

后续尝试的其他方案均未成功：

• 尝试逐个提取单独配置项，但未找到Apps Script官方列出的完整配置项清单，仅能找到两份未涵盖所有配置项的参考文档
• 尝试将代码中的.setOption(options)修改为.setOptions(options)，触发新报错：TypeError: chartBuilder.addRange(...).setChartType(...).setOptions is not a function
• 调研过使用Sheets.Spreadsheets.batchUpdate()类的其他方法实现配置覆盖，但未梳理出可行的实现逻辑

核心问题原因 #

chart.getOptions()返回的是ChartOptions类型对象，不是EmbeddedChartBuilder支持的单键值对参数，且内置的modify()链式方法本身不支持批量传入全量配置对象，因此直接传参会触发参数不匹配的报错，也不存在setOptions()这个批量设置方法。

实现步骤 #

1. 先在Apps Script编辑器的服务列表中添加Sheets高级服务，选择v4版本启用
2. 通过Sheets接口拉取两个图表的完整底层配置，该配置包含图表所有设置项，不存在遗漏
3. 保留目标图表（chart1）原有的位置、锚定信息、绑定数据源范围，将源图表（chart2）的全量配置部分完整替换到目标图表的配置结构中
4. 调用批量更新接口提交修改，即可完成全量配置覆盖

可直接运行的代码 #

function copyFullChartConfig() {
  const activeSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const activeSheet = activeSpreadsheet.getActiveSheet();
  const allCharts = activeSheet.getCharts();
  // 按实际顺序调整索引：第一个是要被覆盖的chart1，第二个是提供配置的chart2
  const targetChart = allCharts[0];
  const sourceChart = allCharts[1];
  const targetId = targetChart.getChartId();
  const sourceId = sourceChart.getChartId();

  // 拉取当前表格下所有图表的完整配置
  const sheetData = Sheets.Spreadsheets.get(activeSpreadsheet.getId(), {
    fields: "sheets(charts)"
  });

  let targetConfig = null;
  let sourceConfig = null;
  // 遍历匹配两个图表的底层配置
  for (const singleSheet of sheetData.sheets) {
    if (!singleSheet.charts) continue;
    for (const chart of singleSheet.charts) {
      if (chart.chartId === targetId) targetConfig = chart;
      if (chart.chartId === sourceId) sourceConfig = chart;
    }
  }

  if (!targetConfig || !sourceConfig) throw new Error("未找到对应图表，请检查索引");

  // 构造更新请求：替换目标图表的全量配置spec
  const updateRequest = {
    updateChartSpec: {
      chartId: targetId,
      spec: sourceConfig.spec
    }
  };

  // 提交更新
  Sheets.Spreadsheets.batchUpdate({
    requests: [updateRequest]
  }, activeSpreadsheet.getId());
}

补充说明 #

• 该方案会1:1复制源图表的所有配置，包括格式、参考区间、坐标轴、图例、系列样式等所有在图表编辑器中可调整的设置，无配置遗漏
• 代码默认保留目标图表原有的位置和绑定的数据源范围，如果需要同步复制数据源配置，可根据需求调整替换的字段范围
• 不需要手动枚举配置项，无需依赖零散的配置说明文档

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