无需点击邮件即可访问Gmail Addon的可行性问询

嗨Sebastian，好消息——这完全是可行的！你只需要正确配置插件的触发条件和manifest文件，就能让它像日历插件一样，在打开Gmail主界面时直接显示在右侧边栏，无需点击任何邮件。

下面是具体的实现步骤：

1. 配置Manifest文件的主页触发 #

在你的Google Apps Script项目中，appsscript.json（即manifest文件）是关键。你需要添加homepageTrigger配置，告诉Gmail在用户打开主页时加载你的插件。

这里是一个manifest的核心配置片段：

{
  "oauthScopes": [
    "https://www.googleapis.com/auth/gmail.addons.execute",
    "https://www.googleapis.com/auth/gmail.readonly"
  ],
  "gmail": {
    "name": "你的插件名称",
    "homepageTrigger": {
      "enabled": true,
      "runFunction": "onGmailHomepage"
    }
  },
  "runtimeVersion": "V8"
}

• homepageTrigger.enabled设为true，启用主页触发
• runFunction指定当触发时要执行的函数（比如onGmailHomepage）

2. 编写主页触发的函数 #

接下来，在你的.gs文件中实现onGmailHomepage函数，返回要显示的卡片内容：

function onGmailHomepage() {
  // 创建一个简单的卡片
  const card = CardService.newCardBuilder()
    .setHeader(CardService.newCardHeader().setTitle("我的Gmail插件"))
    .addSection(CardService.newCardSection()
      .addWidget(CardService.newTextParagraph().setText("欢迎使用！打开Gmail时我就会显示在这里～")))
    .build();
  
  // 返回卡片数组
  return [card];
}

这个函数会在用户打开Gmail主页时被调用，生成并返回你的插件UI。

3. 测试与发布 #

• 测试阶段：你可以通过Google Apps Script编辑器的“测试部署”功能，将插件添加到自己的Gmail中，验证打开Gmail时是否自动显示。
• 发布阶段：如果要分享给其他用户，需要将插件发布为Google Workspace插件（或未发布的测试插件），注意权限和审核要求。

注意事项 #

• 确保你的插件请求的OAuth权限是必要且最小的，避免不必要的权限申请。
• 如果你还需要插件在查看邮件时也显示，可以同时配置contextualTriggers，但这不会影响主页触发的功能。

这样配置后，你的Gmail Add-on就会像日历插件一样，在打开Gmail时直接出现在右侧边栏啦！

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