日历清单资源

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

日历

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

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 日历中提供上下文活动更新界面。日历中事件更新触发器的触发器规范。

eventAttachmentTrigger

object (EventAttachmentTrigger)

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

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 脚本函数的名称。您必须为此插件支持的每个会议解决方案 实现此函数

EventOpenTrigger

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

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

string

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

EventUpdateTrigger

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

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

string

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

EventAttachmentTrigger

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

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

string

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

string

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