安装插件并向其授权

用户必须先安装插件并向其授权,然后才能 可以打开并使用它。由于这些步骤是 插件用户体验,您应该了解它们 然后再开始创建自己的插件。

本文档部分介绍了用户如何安装、授权和 开始使用插件。

安装插件

您必须先安装插件,然后才能使用该插件。 安装后,即可在 Google Workspace 主机应用 扩展。

您可以从以下位置安装已发布的插件: Google Workspace 托管应用或从 Google Workspace Marketplace。 网域管理员也可以代表自己的 Google Workspace Marketplace 中的用户。您还可以 安装未发布的插件 以便对其进行测试在使用已安装的 您必须 授权

有关详情,请参阅 发布插件

为插件授权

插件安装完毕后,就可以在 Google Workspace 主机应用 扩展。用户首次尝试使用 插件会向托管应用 授权卡或对话框。这张卡片说明了 插件需要用户执行相关操作的权限,例如 访问当前 Google 表格的内容。然后,用户可以 然后允许该插件继续操作。如果 用户拒绝插件 因此不能使用插件

编辑器插件使用的授权模型不同于 Google Workspace 插件。 由于编辑器插件是针对 Google 云端硬盘文件运行, 编辑器授权模型定义了 插件适用于单独的文件。在开发 请务必了解 以及插件是如何在两者之间移动的。

为已发布的插件授权

安装已发布的插件后,授权流程将立即开始:

  1. 系统会提示您选择账号以安装插件。
  2. 然后,您会看到该插件的授权列表 这样,您就会知道它试图做什么。评价此内容 如果仍然想授权 点击允许。这样该插件就可以使用了。
  3. 现在,您可以从 主机应用 扩展。如果应用已在浏览器标签页中打开,您可以 您需要先刷新该标签页,然后才能使用该插件。

如果您安装的插件后来又更新,并且需要安装 则系统会提示您提供 权限。

授权未发布的 Google Workspace 插件

插件授权卡

未发布的插件与已发布的插件不同,授权流程不同 因为它们尚未在 Google Workspace Marketplace 中上架。更新后 安装未发布的插件; 系统不会立即要求您授权相反,授权流程 在您首次尝试使用该插件时开始计时。

运行插件时,它会确定是否需要任何用户授权。如果 插件会显示授权卡。 插件在首次执行时始终需要授权, 如果插件的新版本使用以前未启用的服务,则必须提交 授权。授权访问按钮提供了一个对话框窗口,供您 允许或拒绝对该插件进行授权。

授权非 Google 服务使用 Google Workspace 插件

Google Workspace 插件可以连接到 本身需要授权的第三方服务。 与此类服务关联的 Google Workspace 插件 需要用户执行两项不同的操作:

  • 在安装插件或首次使用时对插件本身进行授权 。
  • 首次访问非 Google 服务时对该服务的授权。

如果您正在开发某个 Google Workspace 插件的需求 要使用 OAuth 访问非 Google 服务,您必须 配置连接 创建插件时所需的资源

如需了解详情,请参阅 将您的 Google Workspace 插件与第三方服务相关联

第三方会议系统

可扩展 Google 日历的 Google Workspace 插件 还可以添加其他 会议解决方案 让用户可以在修改会议时选择第三方会议系统 Google 日历活动。如果您的插件提供 要求用户登录,您的插件必须允许用户 。

如果用户在没有必要的权限的情况下尝试使用您的插件创建会议, 登录,会议解决方案的 onCreateFunction 方法 应返回一个 ConferenceData 该对象包含 ConferenceError 以及 身份验证网址

收到此对象后,Google 日历会在 链接到插件提供的身份验证网址的事件修改界面。 然后,用户可在以下日期之前使用此按钮登录第三方系统: 。

请参阅创建第三方会议 详细了解如何使用 ConferenceError 处理授权。

授权未发布的编辑器插件

最佳做法是测试编辑器插件 会有所帮助授权流程 已发布的编辑器插件 在您首次尝试测试该插件时开始计时。如果您以后重新测试 插件,系统不会再次提示您进行授权。

为插件取消授权

开发插件时,不妨取消插件授权,以便重新测试 授权流程

您可以通过执行以下操作来取消对插件的授权:

  1. 打开账号安全控制台
  2. 找到并点击您要取消授权的插件。
  3. 点击撤消访问权限

当您在取消对插件的授权后再次运行该插件时,授权流程 再次显示时