AddOns 清单资源

用于定义 Google Workspace 插件内容和行为的资源配置。Google Workspace 插件清单必须将所有组件标记为必需

插件

Google Workspace 插件清单配置的顶层。

JSON 表示法
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "drive": {
    object (Drive)
  },
  "gmail": {
    object (Gmail)
  },
  "docs": {
    object (Docs)
  },
  "sheets": {
    object (Sheets)
  },
  "slides": {
    object (Slides)
  }
}
字段
common

object (Common)

必需。定义每个主机应用通用的 Google Workspace 插件的值。 如果省略了特定主机的特定值,则此处定义的某些值将用作默认值。

calendar

object (Calendar)

如果 Google Workspace 插件扩展了 Google 日历,则必须启用。 Google Workspace 插件在 Google 日历托管应用中的外观和行为配置。如果省略此字段,则该插件会在 Google 日历中停用。

drive

object (Drive)

如果 Google Workspace 插件扩展了 Google 云端硬盘,则必须提供。 在 Google 云端硬盘主机应用中配置 Google Workspace 插件的外观和行为。如果省略此字段,则 Google 云端硬盘会停用相应插件。

gmail

object (Gmail)

如果 Google Workspace 插件扩展了 Gmail 服务,则为必需项。 适用于 Gmail 托管应用中的 Google Workspace 插件外观和行为的配置。如果省略此字段,则该插件会在 Gmail 中停用。

docs

object (Docs)

如果 Google Workspace 插件扩展了 Google 文档,则为必需参数。 Google Workspace 插件在文档托管应用中的外观和行为的配置。如果省略此字段,则插件会在 Google 文档中停用。

sheets

object (Sheets)

如果 Google Workspace 插件扩展了 Google 表格,则必须提供此参数。 Google Workspace 插件在表格托管应用的外观和行为方面的配置。如果省略此字段,则插件会在 Google 表格中停用。

slides

object (Slides)

如果 Google Workspace 插件扩展 Google 幻灯片,则必须提供。 关于 Google Workspace 插件在幻灯片托管应用中的外观和行为的配置。如果省略此字段,则该插件会在 Google 幻灯片中停用。

常见

每个托管应用通用的参数清单配置。如果省略了特定主机的特定值,则此处定义的某些值将用作默认值。

JSON 表示法
{
  "homepageTrigger": {
    object (HomepageTrigger)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "logoUrl": string,
  "name": string,
  "openLinkUrlPrefixes": [
    string
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "useLocaleFromApp": boolean
}
字段
homepageTrigger

object (HomepageTrigger)

用于创建插件首页的默认触发器函数规范。如果未定义主机专用首页触发器,则可以使用此规范。如果省略了该值,则会构建通用首页卡片,并根据需要使用该卡片。
layoutProperties

object (LayoutProperties)

用于插件工具栏和按钮的颜色配置。
logoUrl

string

必需。工具栏中显示的图片的网址。网址必须公开。

name

string

必需。工具栏中显示的插件名称。

openLinkUrlPrefixes[]

string

如果插件显示任何出站链接(无论是使用 OpenLink 的 widget 还是使用 HTML 锚标记的文本 widget),则需要。HTTPS 网址前缀列表。为了保护用户数据,该插件呈现的任何链接都必须与此列表中的某个前缀匹配。

如需了解详情,请参阅 许可名单网址

universalActions[]

object (UniversalAction)

始终在插件界面中提供的通用操作列表。
useLocaleFromApp

boolean

如果为 true,传递给 操作回调函数或触发器函数的附加 事件对象将包含用户的语言区域和时区信息。默认值为 false

如需了解详情,请参阅 访问用户语言区域和时区

布局属性

此配置用于控制 Google Workspace插件工具栏和按钮的颜色和外观。

JSON 表示法
{
  "primaryColor": string,
  "secondaryColor": string
}
字段
primaryColor

string

工具栏的颜色。默认值为灰色 (#424242)。
secondaryColor

string

按钮的默认颜色。默认为主要颜色(如果已设置);否则默认为蓝色 (#2196F3)。

通用操作

通用操作的配置。 选中此选项后,通用操作会打开指定的网址链接或运行指定的 Apps 脚本函数。

JSON 表示法
{
  "label": string,

  // Union field rule can be only one of the following:
  "openLink": string,
  "runFunction": string,
  // End of list of possible types for union field rule.

}
字段
label

string

每个通用操作都必须提供此参数。此操作的界面菜单中显示的文本。
runFunction

string

如果没有 openLink,则每个通用操作都必须提供此参数。如果已提供,则会在用户选择此操作时执行的 Apps 脚本函数的名称。

如需了解详情,请参阅 通用操作指南。