此页面由 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).
var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationStatus());

AuthorizationStatus - 授权状态

`getAuthorizationUrl()`

获取可用于授予对脚本的访问权限的授权网址。此方法会返回如果不需要授权，则为 null。如果出现以下情况，该网址对应的网页将自动关闭：访问该脚本，且该脚本无需任何授权。

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

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