Gmail 清单资源

用于定义 Google Workspace 插件 内容和行为的资源配置。如果 Google Workspace 插件清单扩展了 Gmail，则必须包含所有标记为必需 的组件。

Gmail

Gmail 扩展的 Google Workspace 插件清单配置。如需了解详情，请参阅 使用 Google Workspace 插件扩展 Gmail 。

JSON 表示法 
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
字段
authorizationCheckFunction

string

已弃用。执行第三方授权检查的 Apps 脚本函数的名称。 执行第三方授权检查的 Apps 脚本函数的名称。

此函数已弃用。相反，插件应从主调用中抛出异常，如非 Google OAuth 配置示例所示。
composeTrigger

object (ComposeTrigger)

对于撰写操作是必需的。定义撰写电子邮件时可用的界面。

如需了解详情，请参阅 使用撰写操作扩展撰写界面。

contextualTriggers[]

object (ContextualTrigger)

必需。在 Gmail 中打开邮件时触发的触发器列表。触发器会执行特定的 Apps 脚本函数来更新界面。
homepageTrigger

object (HomepageTrigger)

Gmail 中插件 首页的触发器函数。这会替换 addOns.common.homepageTrigger。

ComposeTrigger

撰写操作的配置。如需了解详情，请参阅 扩展撰写界面 。

JSON 表示法 
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
字段
draftAccess

string

定义撰写触发器函数的数据访问权限级别。有效选项包括：

  • NONE （默认）：事件对象大部分为空。
  • METADATA：事件对象包含收件人列表。 这需要 gmail.addons.current.message.metadata 范围。
selectActions[]

object (SelectAction)

撰写操作列表。该列表仅限每个插件执行一项操作。撰写操作在 Gmail 窗口中有一个图标 ，由 gmail.logoUrl指定。

ContextualTrigger

在用户打开 Gmail 邮件时触发的触发器的配置。如需了解详情，请参阅 扩展邮件界面 。

JSON 表示法 
{
  "onTriggerFunction": string,
  "unconditional": {},
}
字段
onTriggerFunction

string

对于每个上下文触发器都是必需的。触发器触发时执行的 Apps 脚本函数的名称。
unconditional

object

对于每个上下文触发器都是必需的。指定触发器 针对所有打开的 Gmail 邮件激活。这应始终是一个空对象。

SelectAction

撰写操作配置，用于定义在选择时运行的函数。

JSON 表示法 
{
  "runFunction": string,
  "text": string
}
字段
runFunction

string

对于撰写操作是必需的。选择时执行的 Apps 脚本函数的名称。 该函数会构建插件撰写界面。
text

string

对于撰写操作是必需的。对操作的简短说明。