插件类型

本页将简要介绍您可以构建的两种类型的插件：Google Workspace 插件和编辑器插件。这些插件类型在扩展的应用、创建方式和限制方面有所不同。

Google Workspace 插件

Google Workspace 插件是新一代插件，提供多种功能，包括：

  • 只需为多个 Google Workspace 应用构建一个插件：您可以构建和管理一个可在 Google Workspace 中使用的 Google Workspace 插件，而无需为每个 Google Workspace 应用分别创建插件。Google Workspace 插件可以扩展以下托管应用：

    • Gmail
    • Google 日历
    • Google Chat（开发者预览版）
    • Google 文档
    • Google 云端硬盘
    • Google 表格
    • Google 幻灯片

  • 提高品牌认知度：插件图标默认显示在插件托管应用的右侧面板中。

  • 打造首页体验：您可以为您的插件扩展的每个 Google Workspace 应用创建单独的首页，也可以为多个应用使用相同的首页。

  • 在您的插件中反映用户的上下文：您可以设计 Google Workspace 插件，以显示特定于插件宿主应用的界面。例如，您的插件可以显示电子邮件或日历活动中的信息，或根据当前的 Google Workspace 应用页面建议操作。

  • 使用标准化接口：使用 Google Apps 脚本 Card 服务提供的内置 widget 元素构建界面。您无需具备任何 HTML 或 CSS 专业知识，即可定义这些接口。

  • 扩展 Gmail 的桌面版和移动版客户端：如果 Google Workspace 插件扩展了 Gmail，您可以在桌面版和移动版 Gmail 中使用该插件。如果您构建的 Google Workspace 插件旨在扩展 Gmail 的功能，则无需单独设计移动版插件。所有位置都使用相同的接口。

  • 使用您的首选运行时。您可以使用首选的托管基础架构、开发工具链、源代码控制系统、编码语言和代码库开发 Google Workspace 插件。

编辑器插件

编辑器插件可扩展 Google 编辑器应用（例如文档、表格、幻灯片或表单）的功能。每种 Google 表格编辑器插件类型（例如 Google 表格插件）都有自己的一组类型专用功能、限制和注意事项。构建编辑器插件时，请务必了解这些特定于编辑器的详细信息。如需详细了解特定编辑器的插件，请参阅相应部分：

编辑器插件可以自动执行常见的编辑器任务，例如创建文件、编辑、设置格式以及在应用之间移动数据。编辑器插件界面可根据手头的任务进行高度自定义。

编辑器插件非常适合用于在 Google 文档、表格、幻灯片或表单中自动执行任务，供个人或内部使用。对于需要处理大量用户、需要低延迟或需要完全控制基础架构的大型功能插件，不妨考虑在其他运行时环境中构建 Google Workspace 插件，以便更好地控制基础架构、部署和发布流程。

编辑器插件与 Google Workspace 插件的行为方式存在以下差异：

  • 编辑器插件可以创建由菜单项、对话框和边栏组成的界面。插件对话框和边栏使用标准 HTML 和 CSS 进行定义。
  • 由于 Google 文档编辑器插件会在 Google 云端硬盘中创建、修改或以其他方式与文件互动，因此具有特殊的授权规则。在开发编辑器插件时，请务必了解编辑器插件授权生命周期。
  • 在每个编辑器中创建和更新的文件都有特定的结构。例如，Google 幻灯片演示文稿由页面组成，这些页面可以是幻灯片、母版或布局。您应了解这些文件结构，因为插件在读取或修改文件时通常会与这些文件结构进行交互。
  • 编辑器插件仅适用于桌面客户端，不适用于 Android 或 iOS。
  • 编辑器插件必须在 Apps 脚本中实现。