授权

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

插件需要获得用户的授权才能运行。您从 Google Workspace Marketplace 安装的已发布的插件和您自己开发的插件都是如此。

授权已发布的插件

安装已发布的插件后,授权流程会立即启动:

  1. 系统会提示您选择帐号,以安装该插件。
  2. 然后,您会看到该插件所需的授权列表,以便您了解它要执行的操作。请仔细阅读此列表,如果您仍希望授予授权,请点击 Allow。这样即可启用该插件。
  3. 您现在可以通过其扩展的主应用运行它。如果应用已在浏览器标签页中打开,您可能需要先刷新此标签页,然后才能使用插件。

如果您已安装的插件稍后进行了更新,并且需要您尚未授予的其他授权,则系统会在您下次使用该插件时提示您提供这些权限。

授权未发布的 Google Workspace 插件

插件授权卡片

未发布的插件与已发布插件的授权流程不同,因为它们尚未列入 Google Workspace Marketplace。安装未发布的插件后,系统不会立即要求您授权。而是从您首次尝试使用该插件时开始。

插件运行时,会确定是否需要任何用户授权。如果需要授权,该插件会显示授权卡。插件在首次执行时始终需要授权,如果插件的新版本使用以前未授权的服务,则可能需要授权。Authorize Access 按钮为用户提供对话框,以允许对插件进行“允许”或“拒绝”授权。

为 Google Workspace 插件授权非 Google 服务

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

  • 在安装或首次启动插件时向插件授权。
  • 首次访问非 Google 服务时的授权。

如果您要开发的 Google Workspace 插件需要使用 OAuth 访问非 Google 服务,您必须在构建插件时为该服务配置连接

如果需要对非 Google 服务进行授权,Google Workspace 插件会向用户显示该服务的授权提示卡片。您可以根据需要自定义此授权提示,也可以使用默认卡。

如需了解详情,请参阅连接到非 Google 服务指南。

第三方会议系统

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

如果用户试图使用插件创建会议,而没有必要登录,会议解决方案的 onCreateFunction 方法应返回一个 ConferenceData 对象,该对象包含具有身份验证网址ConferenceError

收到此对象后,Google 日历会在活动编辑界面中创建一个登录按钮,该按钮会链接到插件提供的身份验证网址。然后,用户可以使用此按钮登录第三方系统,再进一步使用此插件。

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

为未发布的编辑器插件授权

最佳做法是在开发插件时测试编辑器插件。授权流程与已发布编辑器的插件相同,只不过此流程会在您首次尝试测试该插件时启动。如果您稍后重新测试同一插件,系统不会再次提示您授权。

向插件授权

在开发插件时,取消授权可能会非常有用,这样您就可以重新测试授权流程。

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

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

如果您在对此插件取消授权后重新运行,则系统会再次显示授权流程。