通过App Script将谷歌表格Checkbox值转换为自定义文字的实现问题

你当前的安卓上传逻辑为勾选传1、未勾选传3到谷歌表格，可通过以下两种方案实现值的自动转换：

方案1：使用可安装onChange触发器（推荐，适配安卓端API上传场景） #

安卓端通过API写入表格的操作不会触发普通onEdit触发器，需要配置可安装的「更改」事件触发器才能捕获外部写入操作，代码如下：

function convertCheckboxValue(e) {
  // 替换为你要监听的工作表名称
  const SHEET_NAME = "Sheet1";
  // 替换为存储复选框值的列号，A列为1、B列为2，以此类推
  const TARGET_COLUMN = 2;

  const activeSheet = e.source.getActiveSheet();
  // 非目标工作表直接跳过
  if (activeSheet.getName() !== SHEET_NAME) return;
  const modifiedRange = e.range;
  // 非目标列的修改直接跳过
  if (modifiedRange.getColumn() !== TARGET_COLUMN) return;

  const cellValues = modifiedRange.getValues();
  const convertedValues = cellValues.map(row => {
    return row.map(cell => {
      if (cell === 1) return "Done";
      if (cell === 3) return "Undone";
      // 其他值保持原始内容不变
      return cell;
    })
  })

  modifiedRange.setValues(convertedValues);
}

触发器配置步骤：

• 打开目标谷歌表格，点击顶部菜单栏「扩展程序」>「Apps Script」进入脚本编辑器
• 粘贴上述代码，修改SHEET_NAME和TARGET_COLUMN为你的实际配置后保存项目
• 点击脚本编辑器左侧的「触发器」（闹钟图标），选择「添加触发器」
• 按以下参数配置：
  • 选择运行的函数：convertCheckboxValue
  • 选择事件来源：电子表格
  • 选择事件类型：更改
• 保存后按照页面提示完成脚本的表格访问权限授权即可

方案2：批量转换历史数据脚本 #

如果表格中已经存在大量历史的1/3数值需要一次性转换，可以使用以下脚本：

function batchConvertHistoryData() {
  const SHEET_NAME = "Sheet1";
  const TARGET_COLUMN = 2;
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(SHEET_NAME);
  const lastRow = sheet.getLastRow();
  const targetRange = sheet.getRange(1, TARGET_COLUMN, lastRow, 1);
  const values = targetRange.getValues();

  const convertedValues = values.map(row => {
    return [row[0] === 1 ? "Done" : row[0] === 3 ? "Undone" : row[0]]
  })

  targetRange.setValues(convertedValues);
  SpreadsheetApp.getUi().alert("批量转换完成");
}

注意事项 #

• 如果后续需要保留原始的1/3数值做统计，建议新增单独的状态展示列，不要直接覆盖原始值列
• 触发器配置需要使用和表格所有者权限一致的谷歌账号操作，避免权限不足导致脚本不生效

内容的提问来源于stack exchange，提问作者P.J