Google Drive插件setOnChangeAction响应延迟：是否正常或代码问题？

你的延迟问题是代码逻辑错误导致的，并非onChange监听器的正常行为，核心问题出在switch组件的参数传递和值设置上：

代码中的两个关键错误 #

1. 错误传递旧状态参数：在buildCard里给switchChangeAction的setParameters传入了当前的switchValue，这会导致触发onChange时，携带的是切换前的旧状态，而非最新的选中值。实际上完全不需要传这个参数，e.formInput已经能直接获取到switch的最新状态。
2. 固定设置switch的value为"true"：switch.setValue("true")会让组件无论选中还是未选中，提交的value都是"true"，导致e.formInput.switch === "true"永远为真，无法正确判断实际选中状态。

修复后的代码 #

function buildCard(switchValue) {
  // 不需要传递旧的switchValue参数
  var switchChangeAction = CardService.newAction()
      .setFunctionName("onSwitchChange");

  var switchControl = CardService.newSwitch()
      .setFieldName("switch")
      .setSelected(switchValue)
      // 给选中和未选中状态设置对应的value，也可省略setValue（默认会用布尔值的字符串形式）
      .setValue(switchValue ? "true" : "false")
      .setOnChangeAction(switchChangeAction);

  var switchDecoratedText = CardService.newDecoratedText()
      .setText("Show things")
      .setSwitchControl(switchControl);
  
  var section = CardService.newCardSection().addWidget(switchDecoratedText);

  if (switchValue) {
    // 这里添加需要展示的内容
  }

  return CardService.newCardBuilder().addSection(section).build();
}

function onSwitchChange(e) {
  // 正确获取最新的switch状态
  var switchValue = (e.formInput.switch === "true");

  var card = buildCard(switchValue);
  var nav = CardService.newNavigation().updateCard(card);
  
  return CardService.newActionResponseBuilder().setNavigation(nav).build();
}

额外优化建议 #

• 如果你的卡片内容涉及大量数据加载导致延迟，可以考虑简化服务器端处理逻辑：Google Workspace插件的CardService是服务器端渲染，所有卡片更新都需要走服务端回调，因此尽量减少回调函数中的计算和数据请求，能有效降低延迟。
• 按钮的加载状态是插件默认行为，switch组件本身没有这个状态，但修正代码后，卡片刷新的延迟会消失，不会出现多次切换才更新的情况。

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