插件需要获得用户授权才能运行。您从 Marketplace 安装的已发布插件以及您自行开发的插件都是如此。
为已发布的插件授权
安装已发布的插件后,系统会立即开始授权流程:
- 系统会提示您选择帐号,以安装插件。
- 然后,您会看到该插件所需的授权列表,以便您了解它要执行的操作。请仔细阅读此列表,如果您仍希望授权,请点击 Allow。此操作会启用该插件。
- 您现在可以从其扩展的主应用运行它。如果应用已在浏览器标签页中打开,您可能需要先刷新标签页,然后插件才能使用。
如果您已安装的插件之后进行了更新,并且需要您尚未授予的其他授权,则系统会在您下次使用该插件时提示您提供这些权限。
授权未发布的 插件
未发布的插件不会与已发布的插件具有相同的授权流程,因为它们尚未列入 市场。安装未发布的插件后,系统不会立即要求您授权。相反,授权流程会在您首次尝试使用插件时启动。
插件运行时,会确定是否需要任何用户授权。如果需要授权,该插件会显示授权卡。首次执行插件时一律需要授权;如果插件的新版本使用了以前未授权的服务,可能还需要授权。授权访问按钮会提供对话框窗口,供用户针对插件授予或拒绝授权。
为非 Google 服务授权插件
插件可能会关联到本身需要授权的第三方服务。 连接到此类服务的插件需要用户执行两项单独的操作:
- 在安装或首次启动插件时授权插件本身。
- 首次访问非 Google 服务时的授权。
如果您要开发的插件需要使用 OAuth 访问非 Google 服务,您必须在构建插件时为该服务配置连接。
当需要非 Google 服务授权时, 插件会向用户显示该服务的授权提示卡。您可以根据需要自定义此授权提示,也可以使用默认卡。
如需了解详情,请参阅连接到非 Google 服务指南。
第三方会议系统
扩展 Google 日历的插件也可以添加其他会议解决方案,让用户在修改 Google 日历活动时选择第三方会议系统。如果您的插件提供了要求用户登录的会议选项,则该插件必须允许用户执行此操作。
如果用户在没有必要登录的情况下尝试使用插件创建会议,会议解决方案的 onCreateFunction
方法应返回一个 ConferenceData
对象,该对象包含具有身份验证网址的 ConferenceError
。
收到此对象后,Google 日历会在活动修改界面中创建一个登录按钮,该按钮会链接到该插件提供的身份验证网址。然后,用户可以使用此按钮登录第三方系统,然后再进一步使用此插件。
如需详细了解如何使用 ConferenceError
处理授权,请参阅创建第三方会议。
为未发布的编辑器插件授权
最佳做法是在开发插件时测试编辑器插件。授权流程与已发布插件的授权流程相同,唯一的区别在于,该流程会在您首次尝试测试插件时启动。如果您以后重新测试同一插件,系统不会再次提示您授权。
为插件取消授权
开发插件时,为插件取消授权会非常有用,以便您重新测试授权流程。
您可以通过执行以下操作,为插件取消授权:
- 打开帐号安全控制台。
- 找到并点击您要取消授权的插件。
- 点击撤消访问权限。
如果您在取消授权后重新运行插件,则系统会再次显示授权流程。