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