构建编辑器插件

请按照以下常规步骤构建编辑器插件:

  1. 创建 Apps 脚本项目。
  2. 使用内置的 Apps 脚本 HTML 服务编写代码来定义插件的外观和行为。
  3. 测试插件。
  4. 发布该插件。

创建脚本项目

编辑器插件是独立的 Apps 脚本项目。独立的脚本指南提供了创建新项目的说明。您也可以直接打开新脚本。如果这样做,项目文件(初始名为 Untitled project)将放在您的根云端硬盘文件夹中。

协作

当您与他人协作开发插件时,该插件项目将归单个用户帐号所有。发布插件时,发布方使用单个用户帐号。发布帐号必须具有插件脚本项目的修改权限,但不需要是项目所有者。

请务必避免因项目所有者离开您的组织而无法访问插件的代码或设置。

为避免失去对插件代码的访问权限,我们建议您在协作处理插件时使用共享云端硬盘。将插件脚本文件放在共享云端硬盘中可确保没有任何帐号是项目的唯一所有者。

此外,我们还建议您向脚本项目的 Cloud Platform (GCP) 项目添加协作者。 这有助于确保您的团队中有人始终可以访问该插件的 Cloud 设置。

编写插件代码

创建脚本项目后,您可以开始编写代码来定义插件的外观和行为。您可以使用 Apps 脚本 HTMLService 使用传统的 HTML 和 CSS 构建插件界面(对话框和边栏)。编辑器插件还可以定义自定义菜单项

在编码时,请参阅编辑器插件样式指南,了解有关如何设计插件用户体验的准则。此外,请务必了解插件可能会遇到的不同授权生命周期状态,并对其进行编程。

测试插件

您可以在发布编辑器插件之前对其进行测试,以确保其行为符合预期。测试要求您创建测试配置并使用测试文档、电子表格、表单或演示文稿。

如需了解详情,请参阅测试编辑器插件

发布插件

插件发布后,其他人即可公开使用,或者只有您网域中的用户可使用。在开始发布流程之前,请务必查看发布内容概览

编辑器插件已发布到 Google Workspace Marketplace。公开发布的插件必须先完成插件审核,然后才能发布。

如需了解详情,请参阅发布编辑器插件