Class AuthorizationInfo

授权信息

用于确定用户是否需要授权此脚本使用一项或多项服务,以及提供授权对话框的网址的对象。如果脚本作为使用可安装触发器插件发布,则可以使用此信息来控制对用户缺少必要授权的代码部分的访问权限。或者,该插件也可以要求用户打开授权对话框的网址以解决此问题。

此对象由 ScriptApp.getAuthorizationInfo(authMode) 返回。在几乎所有情况下,脚本都应调用 ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL),因为没有其他授权模式需要用户授予授权。

方法

方法返回类型简介
getAuthorizationStatus()AuthorizationStatus获取一个值,该值表示用户是否需要授权此脚本使用一个或多个服务(例如 ScriptApp.AuthorizationStatus.REQUIRED)。
getAuthorizationUrl()String获取可用于授予对脚本的访问权限的授权网址。

详细文档

getAuthorizationStatus()

获取一个值,该值表示用户是否需要授权此脚本使用一个或多个服务(例如 ScriptApp.AuthorizationStatus.REQUIRED)。

// Log the authorization status (REQUIRED or NOT_REQUIRED).
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationStatus());

返回

AuthorizationStatus - 授权状态


getAuthorizationUrl()

获取可用于授予对脚本的访问权限的授权网址。如果无需授权,此方法会返回 null。如果网址被访问且脚本不需要任何授权,该网址对应的页面将自动关闭。

// Log the URL used to grant access to the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationUrl());

返回

String - 可用于授权脚本的网址