如何从HTML模态对话框刷新Google Workspace插件的Card卡片？

• 你直接在google.script.run调用的服务端函数里返回CardService实例无效的原因是：只有Google Workspace插件自身触发上下文（比如点击卡片按钮、插件初始化、插件可见性变更等事件触发的函数）的返回值，才会被宿主应用（比如Google Sheets）识别为卡片更新指令，普通google.script.run调用的函数返回值只会传递给前端的success handler，不会被宿主处理。
• 你之前尝试的ActionResponseBuilder、setStateChanged等API同样只在插件触发上下文的返回场景下生效，普通服务端调用返回无效。

方案1：从模态框触发卡片刷新（完全满足需求） #

步骤如下：

1. 调整服务端onAppsScriptFunction逻辑，处理完p1、p2参数后，把新卡片需要的配置数据存入用户属性存储，不需要返回Card实例：

function onAppsScriptFunction(p1, p2) {
  console.log(p1 + p2);
  // 存储新卡片需要的数据
  const userProps = PropertiesService.getUserProperties();
  userProps.setProperty('cardCustomText', 'This will appear after refresh');
  return 'success';
}

2. 修改你的插件主入口函数（比如onHomepageTrigger对应的函数），每次生成卡片前优先读取存储的自定义配置：

function getHomepageCard() {
  const userProps = PropertiesService.getUserProperties();
  const customText = userProps.getProperty('cardCustomText') || '默认文本';
  return CardService.newCardBuilder()
    .addSection(
      CardService.newCardSection().addWidget(
        CardService.newTextParagraph().setText(customText)
      )
    )
    .build();
}

3. 在插件的manifest.json中注册可见性变更事件监听：

"sheets": {
  "homepageTrigger": {
    "runFunction": "getHomepageCard"
  },
  "onVisibilityChangedTrigger": {
    "runFunction": "getHomepageCard"
  }
}

4. 调整模态框前端的success handler，关闭模态框后，插件侧边栏恢复可见时会自动触发onVisibilityChangedTrigger，读取最新配置重新渲染卡片：

function closeThisWindow(res) {
  if(res === 'success') {
    google.script.host.close();
  }
}

方案2：仅关闭模态框后给出视觉反馈（轻量实现） #

不需要修改卡片逻辑，直接在服务端onAppsScriptFunction处理完逻辑后调用宿主的提示API即可：

• 吐司提示（3秒自动消失，不打断操作）：

SpreadsheetApp.getActiveSpreadsheet().toast("操作已完成", "提示", 3);

• 弹窗提示：

SpreadsheetApp.getUi().alert("数据处理完成，卡片已更新");

如果你后续有大量模态框和卡片交互的需求，建议放弃SpreadsheetApp.getUi().showModalDialog，改用Workspace插件原生的弹窗API：CardService.newAction().setOpenDialog()，这种方式弹出的模态框触发的服务端回调可以直接返回ActionResponse实例更新卡片，不需要绕存储的逻辑。

内容的提问来源于stack exchange，提问作者Maris B.