Class AuthorizationInfo

승인정보

사용자가 스크립트의 필수 범위에 대한 승인을 부여했는지 확인하는 객체입니다. 또한 객체는 사용자가 이러한 권한을 부여할 수 있는 승인 URL을 제공합니다.

일부 스크립트 실행은 스크립트에서 사용하는 모든 필수 범위에 대한 사용자의 동의 없이 시작될 수 있습니다. 이 객체의 정보를 사용하면 특정 범위가 필요한 코드 섹션에 대한 액세스를 제어하고 후속 실행을 위해 이러한 범위의 승인을 요청할 수 있습니다.

이 객체는 ScriptApp.getAuthorizationInfo(authMode)에 의해 반환됩니다. 다른 승인 모드에서는 사용자가 승인을 부여해야 하므로 거의 모든 경우 스크립트는 ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL)를 호출해야 합니다.

메서드

메서드반환 유형간략한 설명
getAuthorizationStatus()AuthorizationStatus사용자가 하나 이상의 서비스를 사용하도록 이 스크립트를 승인해야 하는지 여부를 나타내는 값을 가져옵니다 (예: ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()String스크립트에 대한 액세스 권한을 부여하는 데 사용할 수 있는 승인 URL을 가져옵니다.
getAuthorizedScopes()String[]스크립트에 승인된 범위 목록을 가져옵니다.

자세한 문서

getAuthorizationStatus()

사용자가 하나 이상의 서비스를 사용하도록 이 스크립트를 승인해야 하는지 여부를 나타내는 값을 가져옵니다 (예: ScriptApp.AuthorizationStatus.REQUIRED). 

// Log the authorization status (REQUIRED or NOT_REQUIRED).
const 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.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationUrl());

리턴

String: 스크립트를 승인하는 데 사용할 수 있는 URL입니다.

getAuthorizedScopes()

스크립트에 승인된 범위 목록을 가져옵니다. 지정된 범위 목록에 대한 승인 정보가 요청되면 지정된 목록에서 승인된 범위를 반환합니다. 

// 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[]: 승인된 범위 목록입니다.