此页面由 Cloud Translation API 翻译。

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 - 可用于授权脚本的网址