Class AuthorizationInfo

AuthorizationInfo

Un objeto que verifica si el usuario otorgó autorización para los permisos obligatorios de la secuencia de comandos. El objeto también proporciona una URL de autorización para que los usuarios otorguen esos permisos.

Algunas ejecuciones de secuencias de comandos pueden iniciarse sin el consentimiento del usuario para todos los permisos obligatorios que usa la secuencia de comandos. La información de este objeto te permite controlar el acceso a las secciones de código que requieren ciertos permisos y solicitar la autorización de esos permisos para ejecuciones posteriores.

ScriptApp.getAuthorizationInfo(authMode) devuelve este objeto. En casi todos los casos, las secuencias de comandos deben llamar a ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL), ya que ningún otro modo de autorización requiere que los usuarios otorguen autorización.

Métodos

Método	Tipo de datos que se devuelve	Descripción breve
getAuthorizationStatus()	AuthorizationStatus	Obtiene un valor que indica si el usuario debe autorizar esta secuencia de comandos para usar uno o más servicios (por ejemplo, ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()	String|null	Obtiene la URL de autorización que se puede usar para otorgar acceso a la secuencia de comandos.
getAuthorizedScopes()	String[]|null	Obtiene una lista de los permisos autorizados para la secuencia de comandos.

Documentación detallada

getAuthorizationStatus()

Obtiene un valor que indica si el usuario debe autorizar esta secuencia de comandos para usar uno o más servicios (por ejemplo, ScriptApp.AuthorizationStatus.REQUIRED).

// Log the authorization status (REQUIRED or NOT_REQUIRED).
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationStatus());

Volver

AuthorizationStatus: El estado de autorización.

---

getAuthorizationUrl()

Obtiene la URL de autorización que se puede usar para otorgar acceso a la secuencia de comandos. Este método muestra null si no se requiere autorización. La página de la URL se cierra automáticamente si se accede a ella y la secuencia de comandos no requiere ninguna autorización.

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

Volver

String|null: Una URL que se puede usar para autorizar la secuencia de comandos.

---

getAuthorizedScopes()

Obtiene una lista de los permisos autorizados para la secuencia de comandos. Si se solicita información de autorización para una lista de permisos especificada, se muestran los permisos autorizados de la lista especificada.

// 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());

Volver

String[]|null: La lista de permisos autorizados.