如何通过可安装onEdit触发器更新Google Sheets插件卡片？

核心结论 #

直接通过可安装onEdit触发器主动更新已打开的侧边栏卡片是不可行的。Google Workspace插件的卡片渲染依赖前端上下文触发的事件（比如用户点击插件界面组件、打开插件），后台运行的触发器没有界面上下文权限，无法主动推送卡片更新。

可行替代方案 #

1. 用户手动触发刷新

在卡片中添加一个「刷新」按钮，点击时触发卡片重构逻辑，从DocumentProperties读取最新的编辑行列信息并生成新卡片。这是最贴合插件交互模型的方案，实现简单且稳定。

function buildRefreshCard() {
  const props = PropertiesService.getDocumentProperties();
  const lastEditRow = props.getProperty('lastEditRow');
  const lastEditCol = props.getProperty('lastEditCol');
  
  // 构建包含最新信息的卡片
  return CardService.newCardBuilder()
    .addSection(CardService.newCardSection()
      .addWidget(CardService.newTextParagraph().setText(`最新编辑行：${lastEditRow}`))
      .addWidget(CardService.newTextParagraph().setText(`最新编辑列：${lastEditCol}`))
      .addWidget(CardService.newTextButton()
        .setText('刷新')
        .setOnClickAction(CardService.newAction()
          .setFunctionName('buildRefreshCard'))))
    .build();
}

2. 客户端定时自动刷新

在卡片中嵌入客户端JavaScript逻辑，定时调用服务器端函数获取最新数据，再通过插件的客户端API更新卡片内容。注意控制刷新频率，避免触发API调用限制。

• 实现思路：使用CardService.newAction().setFunctionName()绑定客户端脚本，在脚本中用setInterval定时执行google.script.run获取DocumentProperties中的数据，然后更新卡片部件。

3. 利用插件界面激活事件刷新

当用户重新打开插件或切换回插件侧边栏时，自动触发卡片重构。在插件的首页构建函数（如onHomepage）中，每次都读取DocumentProperties的最新数据，确保用户看到的是最新内容。

补充说明 #

你尝试的「从onEdit触发器返回卡片」的方式无效，因为触发器的后台执行环境与前端卡片的渲染环境完全隔离，返回的卡片结构无法传递到已打开的用户界面中。必须通过前端触发的交互事件，才能触发卡片的重新渲染。

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