Time-Driven Triggers异常：如何为所有插件用户实现定时数据存储？

完全可以通过在用户安装插件时创建专属时间驱动触发器来解决这个问题，这是Google Workspace插件中实现用户级定时任务的标准方案。

核心思路 #

手动创建的触发器是以插件所有者身份运行的，因此Session.getActiveUser()永远返回所有者邮箱，且UserProperties也只会操作所有者的存储空间。而在用户安装插件时以用户身份创建触发器，就能让触发器运行时使用该用户的权限，从而正确获取用户信息并存储专属数据。

具体实现步骤 #

1. 编写安装触发函数 #

在用户首次安装插件时，自动为其创建定时触发器，并记录触发器ID以便后续管理：

function onInstall(e) {
  onOpen(e); // 确保插件初始化正常
  
  const triggerIdKey = "cron_fetchrootservice_trigger_id";
  const userProps = PropertiesService.getUserProperties();
  const existingTriggerId = userProps.getProperty(triggerIdKey);
  
  // 避免重复创建触发器
  if (!existingTriggerId) {
    // 创建10小时间隔的触发器，可替换为everyHours(5)或everyDays(1)
    const trigger = ScriptApp.newTrigger("cron_fetchrootservice")
      .timeBased()
      .everyHours(10)
      .create();
    
    // 存储触发器ID到用户属性
    userProps.setProperty(triggerIdKey, trigger.getUniqueId());
  }
}

2. 调整原任务函数 #

原函数逻辑基本可行，只需确保API调用基于当前用户邮箱，同时优化不必要的JSON.stringify（字符串类型无需序列化）：

function cron_fetchrootservice() {
  // 触发器以用户身份运行，Session.getActiveUser()可正确获取当前用户邮箱
  const activeUserEmail = Session.getActiveUser().getEmail();
  const storeusers = PropertiesService.getUserProperties();

  // 替换为你的API调用逻辑，根据用户邮箱获取专属数据
  const data = fetchRootServiceData(activeUserEmail);

  storeusers.setProperty("ActiveUser", activeUserEmail);
  storeusers.setProperty("rootservice_data", JSON.stringify(data));
}

// 示例API调用函数（根据实际需求修改）
function fetchRootServiceData(userEmail) {
  const apiUrl = `https://your-api-domain.com/user-data?email=${encodeURIComponent(userEmail)}`;
  const response = UrlFetchApp.fetch(apiUrl);
  return JSON.parse(response.getContentText());
}

3. 处理插件卸载（可选） #

为避免残留触发器，可添加卸载触发函数，删除用户专属触发器并清理存储：

function onUninstall(e) {
  const triggerIdKey = "cron_fetchrootservice_trigger_id";
  const userProps = PropertiesService.getUserProperties();
  const triggerId = userProps.getProperty(triggerIdKey);
  
  if (triggerId) {
    // 查找并删除触发器
    const allTriggers = ScriptApp.getProjectTriggers();
    for (const trigger of allTriggers) {
      if (trigger.getUniqueId() === triggerId) {
        ScriptApp.deleteTrigger(trigger);
        break;
      }
    }
    // 清理用户属性
    userProps.deleteProperty(triggerIdKey);
    userProps.deleteProperty("ActiveUser");
    userProps.deleteProperty("rootservice_data");
  }
}

4. 配置必要权限 #

在appsscript.json中添加创建触发器的权限：

{
  "oauthScopes": [
    "https://www.googleapis.com/auth/script.scriptapp",
    "https://www.googleapis.com/auth/script.external_request",
    "https://www.googleapis.com/auth/userinfo.email"
  ]
}

关键说明 #

• 触发器运行身份：用户安装时创建的触发器属于该用户，运行时会模拟用户的操作权限，因此Session.getActiveUser()和UserProperties都对应当前用户。
• 触发器间隔调整：将everyHours(10)替换为everyHours(5)或everyDays(1)即可实现不同的定时需求。

内容的提问来源于stack exchange，提问作者R.G.Krish