如何用Google App Script获取谷歌表格图表的标题、轴标题及数据范围？

开发者阿泽

2026-7-9

解决Google App Script获取图表信息的问题

你遇到的getOptions('title')参数不匹配错误，是因为EmbeddedChart.getOptions()方法不接受任何参数，它会返回一个完整的ChartOptions对象，你需要从这个对象里提取所需的配置项。

获取图表核心信息的方法

图表标题：调用chart.getOptions().get('title')
X轴（水平轴）标题：常规图表用chart.getOptions().get('hAxis.title')
Y轴（垂直轴）标题：常规图表用chart.getOptions().get('vAxis.title')
数据来源范围：调用chart.getRanges()，返回Range对象数组，可通过getA1Notation()转换为易读的A1格式范围字符串

完整示例代码

function verifyChart() {
  // 目标工作表
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Present Strength");
  // 获取工作表中所有嵌入式图表
  const charts = sheet.getCharts();
  
  if (charts.length === 0) {
    console.log("当前工作表无图表");
    return;
  }

  // 取第一个图表（可根据需求调整索引或筛选目标图表）
  const chart = charts[0];
  const options = chart.getOptions();

  // 输出图表标题
  console.log("图表标题：", options.get('title'));
  // 输出X轴标题
  console.log("X轴标题：", options.get('hAxis.title'));
  // 输出Y轴标题
  console.log("Y轴标题：", options.get('vAxis.title'));

  // 输出数据来源范围
  console.log("数据来源：");
  chart.getRanges().forEach((range, idx) => {
    console.log(`${idx+1}. ${range.getA1Notation()}`);
  });
}