Google Workspace 插件会在宿主应用界面的边栏中显示信息和用户控件。插件由一个主识别工具栏以及一张或多张卡片组成。
每张卡片都代表插件界面中的特定“页面”,导航到新卡片通常只是创建该卡片并将其推送到内部卡片堆栈的过程。您可以定义卡片之间的导航流程,以提供丰富的互动体验。
卡片可以是非内容相关的卡片,也可以是内容相关的卡片。当托管应用在特定上下文中时,系统会向用户显示上下文卡片。例如,打开 Gmail 邮件或日历活动时。在主机的特定上下文之外向用户显示非内容卡片(例如首页)。例如,当用户查看 Gmail 收件箱、云端硬盘文件夹主文件夹或日历时。
Apps 脚本中内置的 Google Workspace 插件使用 Card 服务基于卡片创建界面。以其他语言构建的插件必须返回格式正确的 JSON,接口才能呈现为卡片。
每张卡片均由一个标题以及一个或多个卡片部分组成。每个部分均由一组微件组成。widget 会向用户显示信息,或提供按钮等互动控件。
基于卡片的接口具有以下优势:
- 您无需了解 HTML 或 CSS 即可创建基于卡片的界面。
- 系统会自动设置卡片和微件的样式,以便与它们扩展的 Google Workspace 应用完美配合。
基于卡片的界面同时适用于桌面设备和移动设备,但您只需定义一次接口。
创建基于卡的接口
构建基于卡片的插件时,了解某些概念和设计模式非常重要。以下指南提供了构建有效的卡片式插件所需的信息:
在创建卡片和实现界面行为时,请参阅这些页面。以下其他示例也有助于您在实现插件时参考:
-
此插件示例展示了包含多个页面和首页的简单 Google Workspace 插件界面。
-
此插件示例展示了一个 Google Workspace 插件,该插件可让用户在文档、表格和幻灯片中翻译文本。
-
此插件示例展示了更复杂的 Google Workspace 插件示例,其中会显示有关 Gmail 邮件收件人、云端硬盘文件编辑器或日历活动参加者的用户信息。此插件只能在网域内使用,因为它使用 Directory API 检索用户信息。