如何用Google Apps Script API编程重命名复制后的Google Sheets Table？

数据老陈

2026-6-18

如何通过Google Apps Script重命名复制后的Table

可行，目前Google Apps Script的原生SpreadsheetApp服务暂未提供直接操作Table的API，但可以通过**Google Sheets Advanced Service（即Sheets API）**实现Table重命名，具体步骤和示例如下：

1. 启用Sheets Advanced Service

在Google Apps Script编辑器中：

点击左侧菜单栏的「服务」按钮
点击「添加服务」
找到「Google Sheets API」，点击「添加」完成启用

2. 核心实现逻辑

通过Sheets API的batchUpdate方法，发送UpdateTableRequest请求，修改目标Table的名称属性。

示例代码

function renameCopiedTable() {
  const activeSs = SpreadsheetApp.getActiveSpreadsheet();
  const ssId = activeSs.getId();
  // 复制后的目标工作表名称
  const targetSheetName = "Copy of SourceSheet";
  // 想要设置的新Table名称
  const newTableName = "MyNewTableName";

  // 获取工作表及其中的Table信息
  const sheetData = Sheets.Spreadsheets.get(ssId, {
    fields: "sheets(properties(title),tables(tableId,name))"
  });

  // 定位目标工作表中的Table
  const targetSheet = sheetData.sheets.find(sheet => sheet.properties.title === targetSheetName);
  if (!targetSheet || !targetSheet.tables?.length) {
    throw new Error("未在目标工作表中找到Table");
  }

  // 假设仅需修改第一个Table，若多个Table可通过名称前缀筛选（如原名称+_x）
  const targetTable = targetSheet.tables[0];

  // 构造更新请求
  const updateRequests = [{
    updateTable: {
      table: {
        tableId: targetTable.tableId,
        name: newTableName
      },
      fields: "name"
    }
  }];

  // 执行更新
  Sheets.Spreadsheets.batchUpdate({ requests: updateRequests }, ssId);
}