如何通过编程方式获取Google Apps Script库的版本号及备注信息

算力阿峰

2026-10-7

编程获取Google Apps Script库版本信息并写入电子表格方案

前置操作

打开目标电子表格，点击顶部「扩展」>「Apps Script」进入脚本编辑器
点击左侧菜单栏「服务」旁边的+号，找到并添加Apps Script API服务，版本选择V1
确认你持有目标库的至少查看权限，私有库需要你是库的协作者才可查询

核心实现代码

function getLibraryVersionInfo() {
  // 替换为你要查询的库的脚本ID，可在库项目的设置页获取
  const LIBRARY_SCRIPT_ID = "替换为目标库的脚本ID";
  // 选择要写入数据的工作表，默认写入Sheet1
  const targetSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Sheet1");

  // 调用API拉取库的所有版本信息
  const versionList = Script.Projects.Versions.list(LIBRARY_SCRIPT_ID).versions;

  // 构造表头和行数据
  const tableHeader = ["版本号", "版本备注", "创建时间", "创建者邮箱"];
  const tableRows = versionList.map(item => [
    item.versionNumber,
    item.description || "无备注",
    new Date(item.createTime),
    item.lastModifiedUser.emailAddress
  ]);

  // 写入数据到电子表格
  targetSheet.clearContents();
  // 写入表头并设置加粗
  targetSheet.getRange(1, 1, 1, tableHeader.length)
    .setValues([tableHeader])
    .setFontWeight("bold");
  // 写入版本数据
  if (tableRows.length > 0) {
    targetSheet.getRange(2, 1, tableRows.length, tableRows[0].length)
      .setValues(tableRows);
  }
  // 自动调整列宽适配内容
  targetSheet.autoResizeColumns(1, tableHeader.length);
}