授权

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

为已发布的插件授权

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

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

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

授权未发布的 插件

插件授权卡片

未发布的插件不会与已发布的插件具有相同的授权流程,因为它们尚未列入 市场。安装未发布的插件后,系统不会立即要求您授权。相反,授权流程会在您首次尝试使用插件时启动。

插件运行时,会确定是否需要任何用户授权。如果需要授权,该插件会显示授权卡。首次执行插件时一律需要授权;如果插件的新版本使用了以前未授权的服务,可能还需要授权。授权访问按钮会提供对话框窗口,供用户针对插件授予或拒绝授权。

为非 Google 服务授权插件

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

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

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

当需要非 Google 服务授权时, 插件会向用户显示该服务的授权提示卡。您可以根据需要自定义此授权提示,也可以使用默认卡。

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

第三方会议系统

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

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

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

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

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

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

为插件取消授权

开发插件时,为插件取消授权会非常有用,以便您重新测试授权流程。

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

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

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