构建 Google Workspace 插件

如要构建新的 Google Workspace 插件,请遵循以下通用条款 过程:

  1. 设置插件的项目并选择所有者 和协作者。
  2. 设计插件的外观和行为。
  3. 配置插件的项目清单或 部署资源
  4. 编写代码以定义插件的外观和行为。
  5. 验证插件的 OAuth 范围。
  6. 主机应用 扩展。
  7. 发布该插件。

设置插件的项目,并选择所有者和协作者

如果你使用 Apps 脚本构建插件, 您需要同时创建 Apps 脚本项目和 Google Cloud 项目。 如果您使用 Google Apps Script 以外的语言构建插件,则只需创建一个 Google Cloud 项目即可。

在开始开发插件之前,请选择一个用户账号来拥有项目,并确定其他哪些账号是协作者。项目的所有者会创建和管理项目文件 和相关设置,而协作者可以协助编码和测试。

Apps 脚本项目

您可以在共享云端硬盘中构建插件所需的 Apps 脚本项目文件,以便所有账号均拥有所有权。将您的插件脚本文件放在共享云端硬盘中可确保多个协作者可以访问脚本项目。

发布插件时,单个用户账号会充当发布商。发布账号必须拥有脚本的修改权限 项目,但不必是所有者。

如需创建 Apps 脚本项目,请参阅脚本项目

Google Cloud 项目

我们建议您向插件对应的 Cloud 项目添加协作者。这有助于确保您团队中的人员始终都能访问 插件的云设置

如需创建 Google Cloud 项目,请参阅创建 Google Cloud 项目

设计插件外观和行为

确定插件的外观和外观 它应该能够正常运行思考哪些应用场景 插件应该尝试为其提供解决方案。开始 以便先处理好这些素材资源,然后再进行更多优化。

请参阅 Google Workspace 插件样式指南 获取有关设计插件用户的指南。 体验。

配置插件项目清单

在 Apps 脚本项目中,项目清单是一种特殊的 JSON 文件。它会指定项目的各种详细信息,例如其库依赖项。对于 Google Workspace 插件,清单还会提供 显示 插件。

请参阅清单,详细了解如何配置您的 插件的清单。

向插件添加代码和功能时,请根据需要修改清单,以生成所需的插件外观和行为。

编写插件代码

您必须为该插件实现基于卡片的接口。使用 Apps 脚本的卡片服务;如果您使用其他代码语言编写,请返回格式正确的 JSON,以便界面将其呈现为卡片。

此外,您还必须实现任何触发器 函数中指定的 插件清单如果您的 插件连接到第三方非 Google 服务 您必须为其配置 OAuth 服务

构建卡片

您可以通过创建 Card 对象并将其填充 widget 来定义插件界面。触发下列函数中指定的函数: 您的清单必须返回 Card 对象或 Card 对象,用于表示 不同“网页”插件界面中您的 插件也可以在 Google Cloud 控制台中 响应用户操作。

在 Apps 脚本中,您可以使用 CardBuilder 类创建卡片。每个 卡要求 CardHeader 以及一个或多个 CardSections。您应使用构成插件界面的各个 widget 填充每个卡片部分。互动 widget 通常与操作相关联,以定义其互动行为。

通过卡片的 CardBuilder 将所有版块和 widget 添加到卡片后,您必须调用 CardBuilder.build() 来创建相应的 Card 对象。

您可以使用其他内置 Apps 脚本服务(例如 CalendarApp)检索要在您构建的插件卡片中显示的信息。您可以使用从非 Google 服务中提取的数据。

如果您的插件需要访问 则必须配置并连接到该服务 - 请参阅 “关联到非 Google 服务”指南 了解详情。

施工订单

构建卡片时,必须从上往下构建。也就是说, 构建顺序:

  1. 构建 widget。
  2. 将微件添加到卡片部分。
  3. 重复上述步骤,直到卡片部分包含所有微件。
  4. 将卡片部分添加到卡片中。

这是必填字段,因为当您将微件添加到卡片或卡片部分时, 实际上是在添加该 widget 的副本。您对微件所做的任何更改 对象不会反映在最终的卡片中。

通用操作

您可以使用通用操作来提供与上下文无关的功能。通用操作是指菜单项 无论哪种卡 。所有已定义的通用操作始终会显示在该插件卡片菜单中。

如需了解详情,请参阅通用操作

验证插件 OAuth 范围

范围定义了 允许插件代表用户执行操作。最佳实践是,插件应仅具有其正常运行所必需的操作的范围,而不要超出这一范畴。

在插件项目中,明确设置插件作用域,以确保插件使用的是一组权限最小的作用域。您可以定义插件在哪些范围中使用 插件 manifest 的文件。

如需了解详情,请参阅镜重

测试插件

要测试未发布的插件,您可以先安装 未发布 插件。 安装并授权后,您就可以在自己的账号中使用该插件,并在其扩展的托管应用中测试其外观和行为。您应验证该插件的行为是否 用于上下文和用户操作。

如需了解详情,请参阅测试 Google Workspace 插件

发布插件

插件发布后,他人便可使用 公开或仅限您网域中的用户。开始发布前的准备工作 流程,请务必查看发布内容概览。发布是一个复杂的过程, 准备和完成所需的时间

Google Workspace 插件会发布到 Google Workspace Marketplace。可公开访问 插件必须先完成应用审核,然后才能 发布状态

请参阅发布 Google Workspace 插件,获取以下内容: 。