日历资源清单

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

用于定义 Google 日历中的Google Workspace 插件内容和行为的资源配置。Google Workspace 如果扩展清单,插件清单必须将所有组件都标记为必需

日历

Google Workspace Google 日历扩展程序的插件清单配置。 如需了解详情,请参阅使用 Google Workspace 插件扩展日历

JSON 表示法
{
  "createSettingsUrlFunction": string,
  "conferenceSolution": [
    {
      object (ConferenceSolution)
    }
  ],
  "currentEventAccess": string,
  "eventOpenTrigger": {
    object (EventOpenTrigger)
  },
  "eventUpdateTrigger": {
    object (EventUpdateTrigger)
  },
  "eventAttachmentTrigger": {
    object (EventAttachmentTrigger)
  },
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
字段
createSettingsUrlFunction

string

仅在插件提供会议解决方案时使用。 (可选)用于生成指向插件设置页的网址的 Apps 脚本函数的名称。

有关详情,请参阅添加会议插件设置
conferenceSolution[]

object (ConferenceSolution)

仅当插件提供会议解决方案时,才应使用;如果提供,必须至少定义一个解决方案。 插件提供的会议解决方案列表。每种解决方案都有相应的会议选项,具体显示在 Google 日历的修改活动界面中。
currentEventAccess

string

确定该插件对用户生成的数据事件数据的访问权限级别。如果未提供,系统不会将事件元数据传递给该插件。 有效设置如下:

  • METADATA 表示该插件只能访问基本事件元数据。
  • READ 表示除了基本事件元数据之外,该插件还可以读取用户生成的事件数据。
  • WRITE 表示该插件可以写入用户生成的事件数据。
  • READ_WRITE 表示该插件可以读取和写入用户生成的事件数据,以及读取基本元数据。

如果设置为 READREAD_WRITE,插件必须具有 https://www.googleapis.com/auth/calendar.addons.current.event.read 范围

如果设置为 WRITEREAD_WRITE,则插件必须具有 https://www.googleapis.com/auth/calendar.addons.current.event.write 范围

eventOpenTrigger

object (EventOpenTrigger)

Google 日历中活动打开触发器的触发器规范。

eventUpdateTrigger

object (EventUpdateTrigger)

必需,以便在 Google 日历中提供上下文事件更新接口。Google 日历中事件更新触发器的触发器规范。

eventAttachmentTrigger

object (EventAttachmentTrigger)

Google 日历中事件附件触发器的触发器规范。

homepageTrigger

object (HomepageTrigger)

在日历主机中创建插件首页的触发器函数规范。这会替换 addOns.common.homepageTrigger

会议解决方案

插件提供的会议解决方案的配置。每个解决方案在 Google 日历修改活动界面中都有相应的会议选项。

JSON 表示法
{
  "id": string,
  "logoUrl": string,
  "name": string,
  "onCreateFunction": string
}
字段
id

string

强制要求。会议解决方案的标识符。在提供的一系列会议解决方案中,此名称必须是唯一的。 选择 ID 后,就不能再更改。
logoUrl

string

指向代表解决方案的图标的链接。 图片尺寸应为 96 x 96 dp。

此值不能是任意网址 - 图片必须托管在 Google 的基础架构上。如需了解详情,请参阅提供会议解决方案徽标

如果提供,此图片可能与插件 calendar.logoUrl 不同,因为图片曾在所扩展的主机应用中用于代表插件。如果没有为特定解决方案提供徽标图片,则改用 calendar.logoUrl
name

string

强制要求。用户创建或修改活动时,Google 日历界面中显示的会议解决方案的名称。
onCreateFunction

string

强制要求。当 Google 日历尝试创建此类会议时调用的 Apps 脚本函数的名称。您必须为插件支持的每个会议解决方案实现此函数

事件打开触发器

用户打开 Google 日历活动时触发的上下文触发器的配置。如需了解详情,请参阅扩展日历活动界面

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

string

用户打开日历活动进行查看或修改时运行的 Apps 脚本函数的名称。如果指定,您必须实现此函数,以构建并返回 Card 对象的数组,使其显示在插件界面中。

EventUpdateTrigger 类

用户修改并保存 Google 日历活动时触发的上下文触发器的配置。如需了解详情,请参阅更新日历活动

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

string

在用户修改并保存日历活动时运行的 Apps 脚本函数的名称。如果指定,您必须实现此函数,以构建并返回 Card 对象的数组,使其显示在插件界面中。

EventAttachmentTrigger 类

当用户点击 Google 日历下拉菜单中的插件附件提供程序时触发的上下文触发器的配置。

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

string

必需。用户在“日历”下拉菜单中选择插件附件提供程序时运行的 Apps 脚本函数的名称。您必须实现此函数以构建并返回 Card 对象数组,使其显示在插件界面中。
label

string

必需。日历下拉菜单中显示用于标识此附件提供程序的文字。