如何在Google Apps Script中基于对象数组绘制散点图

在Google Apps Script（GAS）中，本身没有直接的绘图API，通常需要借助Google Sheets的图表服务来实现散点图绘制。核心思路是先把对象数组转换成Sheets支持的二维表格数据，再通过Sheets的图表工具生成散点图，以下是针对你提供的对象数组的完整实现步骤：

步骤1：将对象数组转换为Sheets兼容的二维数组 #

Google Sheets的数据以行/列的二维数组形式存储，我们需要先把对象的键作为表头，每个对象的属性值作为一行数据：

var Data = [{ID:1, X:2, Y:2},{ID:2, X:3, Y:3},{ID:3, X:4, Y:4}];

// 构建包含表头的二维数组
var sheetData = [["ID", "X", "Y"]];
Data.forEach(item => {
  sheetData.push([item.ID, item.X, item.Y]);
});

步骤2：创建/打开工作表并写入数据 #

接下来需要创建一个新的Google Sheets文件（或打开已有文件），把转换好的数据写入工作表：

// 创建新的Spreadsheet文件
var spreadsheet = SpreadsheetApp.create("散点图数据");
var sheet = spreadsheet.getActiveSheet();

// 将二维数组写入工作表，自动适配数据范围
sheet.getRange(1, 1, sheetData.length, sheetData[0].length).setValues(sheetData);

步骤3：生成并插入散点图 #

使用Sheets的Charts服务创建散点图配置，然后插入到工作表中：

// 构建散点图配置
var chart = sheet.newChart()
  .setChartType(Charts.ChartType.SCATTER) // 指定图表类型为散点图
  .addRange(sheet.getRange(2, 2, sheetData.length - 1, 2)) // 选择X、Y列的数据（跳过表头）
  .setPosition(5, 1, 0, 0) // 设置图表在工作表中的位置：第5行第1列
  .setOption("title", "X-Y 散点图") // 设置图表标题
  .setOption("hAxis", {title: "X 值"}) // 设置X轴标题
  .setOption("vAxis", {title: "Y 值"}) // 设置Y轴标题
  .build();

// 将图表插入到工作表
sheet.insertChart(chart);

完整代码示例 #

把以上步骤整合，完整的可运行代码如下：

function createScatterPlot() {
  var Data = [{ID:1, X:2, Y:2},{ID:2, X:3, Y:3},{ID:3, X:4, Y:4}];

  // 转换数据格式
  var sheetData = [["ID", "X", "Y"]];
  Data.forEach(item => {
    sheetData.push([item.ID, item.X, item.Y]);
  });

  // 创建工作表并写入数据
  var spreadsheet = SpreadsheetApp.create("散点图数据");
  var sheet = spreadsheet.getActiveSheet();
  sheet.getRange(1, 1, sheetData.length, sheetData[0].length).setValues(sheetData);

  // 创建并插入散点图
  var chart = sheet.newChart()
    .setChartType(Charts.ChartType.SCATTER)
    .addRange(sheet.getRange(2, 2, sheetData.length - 1, 2))
    .setPosition(5, 1, 0, 0)
    .setOption("title", "X-Y 散点图")
    .setOption("hAxis", {title: "X 值"})
    .setOption("vAxis", {title: "Y 值"})
    .build();

  sheet.insertChart(chart);
}

运行这个函数后，你会在Google云端硬盘中看到一个名为「散点图数据」的表格文件，里面包含原始数据和生成的散点图。

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