通过onEdit()触发器更新Google Apps Script插件卡片失败求助

你的代码无法生效的核心原因是：简单触发器onEdit无法直接返回ActionResponse来更新插件的Card。onEdit属于简单触发器，它的执行上下文和插件UI的运行环境相互隔离，没有权限触发插件界面的更新操作。

可行解决方案 #

要实现表格值变化时切换插件Card，需要结合可安装触发器和状态存储/UI刷新机制，步骤如下：

1. 创建可安装的onChange触发器
   可安装触发器拥有更高权限，能捕获表格的编辑事件，且可与插件UI交互：

   function createOnChangeTrigger() {
     const ss = SpreadsheetApp.getActiveSpreadsheet();
     ScriptApp.newTrigger('onSpreadsheetChange')
       .forSpreadsheet(ss)
       .onChange()
       .create();
   }
   

2. 处理表格变化并存储更新标记
   当表格发生编辑时，通过PropertiesService存储一个更新标记，告知插件需要刷新Card：

   function onSpreadsheetChange(e) {
     if (e.changeType === 'EDIT') {
       PropertiesService.getUserProperties().setProperty('NEED_CARD_UPDATE', 'true');
     }
   }
   

3. 插件侧边栏实现定时刷新逻辑
   让插件侧边栏定期检查更新标记，一旦检测到需要更新，就加载新的Card内容：

   function showSidebar() {
     const html = HtmlService.createHtmlOutput(`
       <script>
         setInterval(() => {
           google.script.run.withSuccessHandler(shouldUpdate => {
             if (shouldUpdate) {
               google.script.run.withSuccessHandler(html => {
                 document.getElementById('card-container').innerHTML = html;
                 google.script.run.resetUpdateFlag();
               }).getUpdatedCardHtml();
             }
           }).checkForCardUpdate();
         }, 2000);
       </script>
       <div id="card-container"></div>
     `).setTitle('我的插件');
     SpreadsheetApp.getUi().showSidebar(html);
   }
   
   function checkForCardUpdate() {
     const needUpdate = PropertiesService.getUserProperties().getProperty('NEED_CARD_UPDATE');
     return needUpdate === 'true';
   }
   
   function resetUpdateFlag() {
     PropertiesService.getUserProperties().setProperty('NEED_CARD_UPDATE', 'false');
   }
   
   function getUpdatedCardHtml() {
     const card = CardService.newCardBuilder()
       .setHeader(CardService.newCardHeader()
         .setTitle('更新后的Card')
         .setSubtitle('表格内容已变化')
         .setImageStyle(CardService.ImageStyle.SQUARE)
         .setImageUrl('https://www.example.com/images/headerImage.png'))
       .addSection(CardService.newCardSection()
         .setHeader('内容已更新')
         .addWidget(CardService.newTextParagraph().setText('表格中的值已经发生变化，这是新的Card内容。')))
       .addCardAction(CardService.newCardAction().setText('Gmail').setOpenLink(
         CardService.newOpenLink().setUrl('https://mail.google.com/mail')))
       .build();
   
     return CardService.newHtmlOutputBuilder().addCard(card).build().getContent();
   }
   

关键说明 #

• 简单触发器（如onEdit）受限于权限和执行环境，无法直接操作插件UI，必须使用可安装触发器替代。
• 通过PropertiesService传递更新状态，是因为触发器和插件UI运行在不同的上下文，需要一个中间存储来传递信号。
• 定时刷新是目前实现自动更新的可靠方式，Google Apps Script暂不支持主动推送UI更新的机制。

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