在Gmail插件中创建动态选项SelectionInput报错，该如何解决？

你的代码逻辑本身是合理的，报错的核心原因大概率是SelectionInput没有被添加任何有效选项，或者选项格式不符合要求，导致Gmail插件的卡片渲染引擎无法识别items属性。下面是具体的排查和修复方案：

1. 确保items数组包含有效非空元素 #

如果你的items数组是空的（比如数据源为空、展开操作得到空数组），forEach不会执行任何addItem操作，此时SelectionInput就没有任何选项，这会触发你遇到的报错。

先手动填入测试值验证：

var items = ["Item 1", "Item 2", "Item 3"]; // 先用测试值排除数据源问题

如果测试数组能正常运行，说明你的原始数据源获取逻辑有问题，需要检查从Sheet、API等渠道获取数据时是否返回了空值。

2. 确保每个选项的文本和值都是有效字符串 #

addItem的前两个参数（显示文本和提交值）必须是非空字符串，不能是null、undefined或者数字类型（数字要转成字符串）。比如：

// 错误示例：直接传入数字
var items = [1, 2, 3];
// 正确做法：转成字符串
var items = [1, 2, 3].map(String);

3. 完整的可运行卡片构建示例 #

确认你完整的卡片构建流程没有遗漏步骤，以下是一个标准的实现：

function buildDynamicSelectionCard() {
  // 模拟动态获取的选项列表
  var items = ["Project A", "Project B", "Project C"];
  
  // 创建选择输入控件
  var selectWidget = CardService.newSelectionInput()
    .setType(CardService.SelectionInputType.DROPDOWN)
    .setTitle("Select an item")
    .setFieldName("item");
  
  // 动态添加选项（过滤空值）
  items.forEach(function(item) {
    var itemStr = String(item).trim();
    if (itemStr) { // 跳过空字符串，避免无效选项
      selectWidget.addItem(itemStr, itemStr, false);
    }
  });
  
  // 组装卡片并返回
  var section = CardService.newCardSection().addWidget(selectWidget);
  var card = CardService.newCardBuilder().addSection(section).build();
  
  return card;
}

4. 额外排查点 #

• 如果你的数据源是异步获取的（比如用UrlFetchApp调用API），要确保在构建卡片前已经同步获取到数据——Gmail插件的卡片构建必须是同步操作，不能在异步回调中处理。
• 检查拼写错误：比如CardService.SelectionInputType.DROPDOWN是否正确，不要写成DROP_DOWN或其他错误形式。

按照以上步骤排查，应该能解决你遇到的items属性不存在的报错。

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