如何在Apps Script创建的数据验证中启用「允许多选」功能？

问题背景 #

使用SpreadsheetApp.newDataValidation().requireValueInList()创建下拉数据验证时，找不到开启允许多选的配置项，但手动通过「数据>数据验证」菜单可以设置该功能：

截图1：通过Apps Script创建的数据验证（无多选配置选项）
截图2：通过菜单栏「数据>数据验证」创建的数据验证界面（中文翻译后：可勾选「允许多选」选项）

核心原因 #

Google Apps Script的基础SpreadsheetApp服务暂未封装数据验证的多选配置项，必须借助Advanced Sheets Service才能实现该功能。

实现步骤与代码 #

1. 启用Advanced Sheets Service
   打开脚本编辑器 → 点击「扩展>Apps Script」→ 进入脚本界面后点击「服务+」→ 找到「Sheets API」并启用。

2. 代码示例

function addMultiSelectDropdown() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName("你的工作表名称"); // 替换为目标工作表名
  const targetRange = sheet.getRange(4, index + 1); // 对应你原代码的目标单元格
  
  // 从服务器获取选项（替换为你的接口请求逻辑）
  const serverOptions = ['Yes', 'No', '待定'];
  
  // 构建批量更新请求
  const validationRequest = {
    setDataValidation: {
      range: {
        sheetId: sheet.getSheetId(),
        startRowIndex: targetRange.getRow() - 1,
        endRowIndex: targetRange.getRow(),
        startColumnIndex: targetRange.getColumn() - 1,
        endColumnIndex: targetRange.getColumn()
      },
      rule: {
        condition: {
          type: 'ONE_OF_LIST',
          values: serverOptions.map(opt => ({ userEnteredValue: opt }))
        },
        showCustomUi: true, // 显示下拉箭头，对应原代码的第二个true参数
        allowInvalid: false, // 禁止输入列表外内容
        multiSelect: true // 开启允许多选
      }
    }
  };
  
  // 应用数据验证规则
  Sheets.Spreadsheets.batchUpdate({ requests: [validationRequest] }, ss.getId());
}

关键说明 #

• multiSelect: true是开启多选的核心配置，这是Advanced Sheets Service独有的参数
• 若需要动态从服务器拉取选项，只需将serverOptions替换为你的接口返回数据即可
• showCustomUi: true对应原代码中requireValueInList的第二个参数，控制是否显示下拉箭头

内容的提问来源于stack exchange，提问作者Đắc Phú Huỳnh