Объект, используемый для определения того, необходимо ли пользователю авторизовать этот сценарий для использования одной или нескольких служб, а также для предоставления URL-адреса для диалогового окна авторизации. Если скрипт опубликован как надстройка , использующая устанавливаемые триггеры , эта информация может использоваться для контроля доступа к участкам кода, для которых у пользователя нет необходимой авторизации. Альтернативно, надстройка может попросить пользователя открыть URL-адрес диалогового окна авторизации, чтобы решить проблему.
Этот объект возвращается Script App.getAuthorizationInfo(authMode)
. Почти во всех случаях сценарии должны вызывать Script App.getAuthorizationInfo(ScriptApp.AuthMode.FULL)
, поскольку ни один другой режим авторизации не требует, чтобы пользователи предоставляли авторизацию.
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
get Authorization Status() | Authorization Status | Получает значение, указывающее, необходимо ли пользователю авторизовать этот сценарий для использования одной или нескольких служб (например, Script App.AuthorizationStatus.REQUIRED ). |
get Authorization Url() | String | Получает URL-адрес авторизации, который можно использовать для предоставления доступа к сценарию. |
Подробная документация
get Authorization Status()
Получает значение, указывающее, необходимо ли пользователю авторизовать этот сценарий для использования одной или нескольких служб (например, Script App.AuthorizationStatus.REQUIRED
).
// Log the authorization status (REQUIRED or NOT_REQUIRED). const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationStatus());
Возвращаться
Authorization Status
— статус авторизации.
get Authorization Url()
Получает URL-адрес авторизации, который можно использовать для предоставления доступа к сценарию. Этот метод возвращает null
если авторизация не требуется. Страница по URL-адресу закроется автоматически, если к ней есть доступ, и скрипт не требует авторизации.
// Log the URL used to grant access to the script. const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationUrl());
Возвращаться
String
— URL-адрес, который можно использовать для авторизации скрипта.