Apps Script에서 기본 제공 Google 서비스 또는 고급 Google 서비스의 비공개 데이터에 액세스하려면 사용자 승인이 필요합니다.
액세스 권한 부여
Apps Script는 코드 스캔을 바탕으로 승인 범위 (예: Google Sheets 파일 또는 Gmail 액세스)를 자동으로 결정합니다. 주석 처리된 코드도 승인 요청을 생성할 수 있습니다. 스크립트에 승인이 필요한 경우 실행 시 여기에 표시되는 승인 대화상자 중 하나가 표시됩니다.
또한 이전에 승인한 스크립트는 코드 변경으로 새로운 서비스가 추가되는 경우 추가 승인을 요청합니다. 스크립트 소유자의 사용자 ID로 실행되는 웹 앱으로 스크립트에 액세스하는 경우 스크립트에서 승인을 요청하지 않을 수 있습니다.
액세스 권한 취소
데이터에 대한 스크립트의 액세스 권한을 취소하려면 다음 단계를 따르세요.
- Google 계정의 권한 페이지를 방문합니다. (나중에 이 페이지로 이동하려면 Google.com을 방문한 다음 화면 오른쪽 상단의 계정 사진을 클릭합니다. 그런 다음 내 계정을 클릭하고 '로그인 및 보안' 섹션 아래에서 연결된 앱 및 사이트와 앱 관리를 차례로 클릭합니다.)
- 승인을 취소하려는 스크립트의 이름을 클릭하고 오른쪽에서 Remove를 클릭한 후 결과 대화상자에서 OK를 클릭합니다.
스크립트의 권한 및 유형
스크립트가 실행되는 사용자 ID 및 스크립트가 액세스할 수 있는 데이터는 아래 표와 같이 스크립트가 실행되는 시나리오에 따라 다릅니다.
| 스크립트 유형 | 스크립트 실행 방법... |
|---|---|
| 독립형, 부가기능 또는 Docs, Sheets, Slides 또는 Forms에 결합 | 키보드를 사용하는 사용자 |
| 스프레드시트의 커스텀 함수 | 익명 사용자입니다. 하지만 할당량 한도는 키보드를 사용하는 사용자에 대해 계산됩니다. |
| 웹 앱 또는 Google Sites 가젯 | 앱 배포 시 선택한 옵션에 종속된 키보드 또는 스크립트 소유자의 사용자 |
| 설치 가능한 트리거 | 트리거를 만든 사용자입니다. |
Sheets, Docs, Slides, Forms의 수동 승인 범위
스프레드시트 서비스, 문서 서비스, 프레젠테이션 서비스 또는 Forms 서비스를 사용하는 부가기능 또는 다른 스크립트를 빌드하는 경우 사용자의 모든 스프레드시트, 문서 또는 양식이 아닌 부가기능이나 스크립트가 사용된 파일에만 액세스 권한을 요청하도록 승인 대화상자가 강제 설정할 수 있습니다. 이렇게 하려면 파일 수준 주석에 다음 JsDoc 주석을 포함하세요.
/**
* @OnlyCurrentDoc
*/
반대 주석인 @NotOnlyCurrentDoc는 스크립트에 @OnlyCurrentDoc을 선언하는 라이브러리가 포함되어 있지만 마스터 스크립트에서 실제로 현재 파일보다 더 많은 파일에 액세스해야 하는 경우 사용할 수 있습니다.
부가기능의 승인 수명 주기
Google Sheets, Docs, Slides, Forms의 부가기능은 일반적으로 문서에 바인딩된 스크립트와 동일한 승인 모델을 따릅니다. 그러나 특정 상황에서는 onOpen(e) 및 onEdit(e) 함수가 승인 없음 모드에서 실행되어 몇 가지 복잡성이 발생합니다. 자세한 내용은 부가기능 승인 수명 주기 가이드를 참고하세요.
OAuth 애플리케이션 사용자 한도
Apps Script 프로젝트를 포함하여 OAuth를 사용하여 Google 사용자 데이터에 액세스하는 애플리케이션에는 승인 한도가 적용됩니다. 자세한 내용은 OAuth 애플리케이션 사용자 한도를 참조하세요.