Google Workspace插件cats快速入门示例报userTimezone未定义错误如何解决？

这个错误的本质是代码中引用的事件对象e为undefined，导致无法读取其下的userTimezone属性，常见触发场景有两种：

1. 直接在Google Apps Script编辑器中手动执行onHomepage函数：onHomepage是Google Workspace插件的主页触发器回调函数，只有插件在宿主应用（Gmail/文档/表格等）中被唤起时，Google平台才会自动注入包含userTimezone、hostApp等属性的事件参数e，手动执行时没有传入参数，e自然为undefined。
2. 宿主应用中唤起插件时报错：说明插件的清单配置存在问题，平台没有正确注入事件对象。

分场景处理：

场景1：编辑器手动调试触发报错 #

这是正常现象，不要直接执行onHomepage，可以通过两种方式调试：

• 把插件部署为测试版本，在对应的Google Workspace宿主应用中打开插件触发执行
• 编写测试用函数传入模拟的事件对象，示例如下：

function testOnHomepage() {
  // 构造模拟事件参数
  const mockEvent = {
    userTimezone: { id: Session.getScriptTimeZone() },
    hostApp: 'gmail' // 替换为你开发的对应宿主，如docs、sheets等
  }
  const card = onHomepage(mockEvent);
  console.log(card);
}

执行testOnHomepage即可完成逻辑调试。

场景2：宿主应用中唤起插件报错 #

按顺序检查配置并做兼容处理：

• 检查appsscript.json清单文件中对应宿主的homepageTrigger配置是否正确，示例Gmail配置如下：

{
  "addOns": {
    "gmail": {
      "homepageTrigger": {
        "runFunction": "onHomepage"
      }
    }
  }
}

• 对onHomepage函数增加兜底兼容逻辑，避免事件对象异常时直接报错，修改后代码如下：

function onHomepage(e) {
  console.log(e);
  // 增加参数兜底
  e = e || {};
  const timezone = e.userTimezone?.id || Session.getScriptTimeZone();
  const hostApp = e.hostApp || 'Workspace';
  var hour = Number(Utilities.formatDate(new Date(), timezone, 'H'));
  var message;
  if (hour >= 6 && hour < 12) {
    message = 'Good morning';
  } else if (hour >= 12 && hour < 18) {
    message = 'Good afternoon';
  } else {
    message = 'Good night';
  }
  message += ' ' + hostApp;
  return createCatCard(message, true);
}

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