Объект, проверяющий, предоставил ли пользователь разрешение на необходимые области действия скрипта. Объект также предоставляет URL-адрес авторизации, позволяющий пользователям предоставлять эти разрешения.
Некоторые скрипты могут запускаться без согласия пользователя на использование всех необходимых областей видимости, применяемых скриптом. Информация в этом объекте позволяет контролировать доступ к участкам кода, требующим определенных областей видимости, и запрашивать разрешение на использование этих областей видимости для последующих запусков.
Этот объект возвращается методом Script App.getAuthorizationInfo(authMode) . Практически во всех случаях скриптам следует вызывать Script App.getAuthorizationInfo(ScriptApp.AuthMode.FULL) , поскольку ни один другой режим авторизации не требует от пользователей предоставления разрешения.
Методы
| Метод | Тип возвращаемого значения | Краткое описание |
|---|---|---|
get Authorization Status() | Authorization Status | Получает значение, указывающее, нужно ли пользователю авторизовать этот скрипт для использования одной или нескольких служб (например, Script App.AuthorizationStatus.REQUIRED ). |
get Authorization Url() | String|null | Получает URL-адрес авторизации, который можно использовать для предоставления доступа к скрипту. |
get Authorized Scopes() | String[]|null | Получает список разрешенных областей действия для скрипта. |
Подробная документация
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|null — URL-адрес, который можно использовать для авторизации скрипта.
get Authorized Scopes()
Получает список разрешенных областей действия для скрипта. Если запрашивается информация об авторизации для указанного списка областей действия, возвращает разрешенные области действия из указанного списка.
// Logs which scopes in the specified list have been authorized for the script. const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL, [ 'https: //www.googleapis.com/auth/documents', 'https: //www.googleapis.com/auth/spreadsheets', ]); Logger.log(authInfo.getAuthorizedScopes());
Возвращаться
String[]|null — Список разрешенных областей действия.