Gmail 清单资源

资源配置 Google Workspace 插件 Gmail 中的内容和行为。 Google Workspace 插件清单必须包含 所有标记为必需的组件(如果它们扩展了 Gmail)。

Gmail

以下各项的 Google Workspace 插件清单配置: Gmail 扩展程序。请参阅 使用 Google Workspace 插件扩展 Gmail

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

string

已弃用。执行 Apps 脚本函数的名称 第三方授权要求检查。此函数称为 调用 Google Workspace 插件。

此函数已废弃,以避免不必要的执行延迟。 相反,该插件应在主 调用的方法,如此 示例

composeTrigger

object (ComposeTrigger)

撰写操作必需。定义可用的界面集 在撰写电子邮件时向用户显示

请参阅 如需了解详情,请使用 Compose 操作扩展 Compose 界面

contextualTriggers[]

object (ContextualTrigger)

必需。在打开邮件时触发的触发器列表 。当触发器触发时,它会执行特定的 Apps 脚本功能,通常用于创建新卡片和更新界面。
homepageTrigger

object (HomepageTrigger)

用于创建插件的触发器函数规范 首页中的 Gmail 主机。这会覆盖 <ph type="x-smartling-placeholder"></ph> addOns.common.homepageTrigger

ComposeTrigger

撰写操作的配置。请参阅 扩展 Compose 界面

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

string

定义 Compose 触发器可用的数据访问权限级别 函数。有效选项包括:

  • NONE,默认设置。这会导致 该对象主要是传递给 Compose 触发器函数的 为空。
  • METADATA,用于填充传递的事件对象 发送到 Compose 触发器函数,其中包含 消息。此设置要求该插件包含 gmail.addons.current.message.metadata <ph type="x-smartling-placeholder"></ph> 范围
selectActions[]

object (SelectAction)

用于创建 Compose 界面的 Compose 操作列表;然而, 列表仅限每个插件执行一项操作。撰写 操作在 Gmail 撰写窗口中显示相应的图标。 该图标由 gmail.logoUrl 指定。

ContextualTrigger

用户打开 Gmail 邮件时触发的触发器的配置 且该消息符合特定条件请参阅 扩展消息界面

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

string

对于每个上下文触发器而言都是必需的。应用的名称 在触发器触发时执行的脚本函数。

请参阅 上下文触发器函数,详细了解如何定义此变量。 函数。

unconditional

object

对于每个上下文触发器而言都是必需的。用于指定 上下文触发器会为所有 Gmail 邮件启用 已打开。目前,这是唯一的选项,因此,应始终将 空对象。

SelectAction

Compose 操作配置,用于定义在 用户选择撰写操作。

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

string

撰写操作必需。Apps 脚本的名称 函数。这个 Compose 触发器函数用于构建插件 Compose 界面。

请参阅 Compose 触发器函数

text

string

撰写操作必需。此内容的简短文字说明 撰写操作。