Google Apps Script插件卡片点击函数：重复触发与返回值异常

1. 函数被多次触发的核心原因 #

你在配置按钮onClick.action.function时，直接执行了testLogic(category)，这会导致卡片渲染、构建按钮列表的阶段就调用了testLogic函数，而非等到按钮点击时才触发。这就是还没点击按钮，函数就被多次执行的根源。

正确的做法是传递函数引用，不能直接调用函数。如果需要给函数传参，可通过闭包或bind实现：

// 方式1：闭包传递参数
function: () => testLogic(category),
// 方式2：使用bind绑定参数
function: testLogic.bind(null, category),

2. 事件处理器返回完整JSON而非动作信息的问题 #

你的动作配置存在框架规范不匹配的问题：

• 多数卡片框架（比如Google Apps Script插件）中，指定后端处理函数的字段是functionName而非function；actionMethodName并非标准配置项，属于冗余设置。
• 事件处理器handleCardClick(e)需要返回框架要求的响应格式，而非直接返回JSON。以Google Apps Script为例，需用CardService构建合法响应。

修正后的代码示例 #

function testLogic(input) {
  Logger.log("testLogic triggered" + input);
}

function buildCategoryCardV2(categories) {
  const buttons = categories.map(category => ({
    text: category,
    onClick: {
      action: {
        functionName: 'handleCardClick', // 指定正确的事件处理器函数名
        parameters: [{ key: 'category', value: category }]
      }
    }
  }));
  const card = {
    cardId: 'category_selector',
    card: {
      name: 'Category Selector',
      header: { title: 'Inventory Request', subtitle: 'Please select a category' },
      sections: [{ widgets: [{ buttonList: { buttons: buttons } }] }]
    }
  };
  return card;
}

// 符合规范的事件处理器示例（以Google Apps Script为例）
function handleCardClick(e) {
  const category = e.parameters.category;
  testLogic(category);
  // 返回框架要求的动作响应
  return CardService.newActionResponseBuilder()
    .setNotification(CardService.newNotification()
      .setText(`已选择分类：${category}`))
    .build();
}

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