Google Sheets插件使用CardService报错：无法读取newCardHeader属性

你犯了两个核心错误：

1. CardService 的卡片不能直接传给 showDialog()
SpreadsheetApp.getUi().showDialog() 只接受 HtmlOutput 对象（由 HtmlService 创建），根本不支持 CardService 生成的卡片。这也是 CardService 看似未定义的间接原因——当前执行环境（普通对话框调用链）没有加载 CardService 相关上下文，导致对象未初始化。
2. CardService 的使用场景错了
   CardService 是用来构建 Google Workspace 插件的侧边栏、插件面板或Gmail/Calendar 类原生卡片界面的，不是普通弹窗对话框。

方案1：改用 HtmlService 实现普通对话框 #

如果只是要弹出简单的帮助弹窗，直接用 HtmlService 替代 CardService：

const ui = SpreadsheetApp.getUi();

const onOpen = e => {
  ui.createAddonMenu()
    .addItem('帮助', 'showHelp')
    .addToUi();
}

const showHelp = () => {
  // 用HtmlService构建对话框内容
  const html = HtmlService.createHtmlOutput('<h3>帮助中心</h3><p>这是插件的帮助内容</p>')
    .setWidth(400)
    .setHeight(300);
  ui.showDialog(html, '帮助');
}

方案2：用 CardService 构建插件侧边栏 #

如果你确实需要 CardService 的原生卡片组件（比如复杂交互、统一的插件样式），改成显示侧边栏而非对话框：

const ui = SpreadsheetApp.getUi();

const onOpen = e => {
  ui.createAddonMenu()
    .addItem('打开帮助侧边栏', 'showHelpSidebar')
    .addToUi();
}

const buildCard = () => {
  const header = CardService.newCardHeader().setTitle("帮助中心");
  const card = CardService.newCardBuilder().setHeader(header).build();
  return card;
}

const showHelpSidebar = () => {
  const card = buildCard();
  // 用CardService构建侧边栏UI，再传给showSidebar
  const sidebarUi = CardService.newUi().addCard(card).build();
  ui.showSidebar(sidebarUi);
}

• 若开发需提交到插件商店的正式 Google Workspace 插件，还需在 appsscript.json 中配置插件清单文件，确保 CardService 能正确加载。
• 不要在普通对话框的调用逻辑里混用 CardService，两种 API 的执行环境完全不同。

内容的提问来源于stack exchange，提问作者Let Me Tink About It