此页面由 Cloud Translation API 翻译。

日历清单资源

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

日历

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) } }

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` 表示该插件可以读取和写入用户生成的事件数据，以及读取基本元数据。如果设置为 `READ` 或 `READ_WRITE`，该插件必须具有 `https://www.googleapis.com/auth/calendar.addons.current.event.read` scope。如果设置为 `WRITE` 或 `READ_WRITE`，则该插件必须具有 `https://www.googleapis.com/auth/calendar.addons.current.event.write` 作用域。注意：如需获取有关当前观看的事件的元数据，您必须将此参数设置为 `METADATA`、`READ` 或 `READ_WRITE`。
`eventOpenTrigger`	`object (EventOpenTrigger)` Google 日历中活动打开触发器的触发器规范。
`eventUpdateTrigger`	`object (EventUpdateTrigger)` 必须提供此权限，才能在 Google 日历中提供上下文相关的活动更新接口。日历中活动更新触发器的触发器规范。
`eventAttachmentTrigger`	`object (EventAttachmentTrigger)` Google 日历中活动附件触发器的触发器规范。
`homepageTrigger`	`object (HomepageTrigger)` 用于在 Google 日历主机中创建插件首页的触发器函数规范。这会替换 `addOns.common.homepageTrigger`。

ConferenceSolution

该插件提供的会议解决方案的配置。每个解决方案都有对应的会议选项，显示在 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 日历活动时触发。如需了解详情，请参阅扩展 Google 日历活动接口。

JSON 表示法
{ "runFunction": string }

字段
`runFunction`	`string` 当用户打开日历事件以进行查看或修改时运行的 Apps 脚本函数的名称。如果指定了此参数，您必须实现此函数，以构建并返回一个 `Card` 对象数组，以便在插件界面中显示。

EventUpdateTrigger

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

JSON 表示法
{ "runFunction": string }

字段
`runFunction`	`string` 用户修改和保存 Google 日历活动时运行的 Apps 脚本函数的名称。如果指定了此参数，您必须实现此函数，以构建并返回一个 `Card` 对象数组，以便在插件界面中显示。

EventAttachmentTrigger

上下文触发器的配置，该触发器会在用户点击“日历”下拉菜单中的插件附件提供程序时触发。

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

字段
`runFunction`	`string` 必需。当用户在 Google 日历下拉菜单中选择插件附件提供程序时运行的 Apps 脚本函数的名称。您必须实现此函数，以构建并返回 `Card` 对象的数组，以便在插件界面中显示。
`label`	`string` 必需。日历下拉菜单中显示的文本，用于标识此附件提供程序。