구글시트 앱스크립트 권한 허용 가이드
왜 권한이 필요한가
구글시트에서 처음으로 앱스크립트(Google Apps Script)를 실행하면 계정 접근 권한을 승인해야 합니다.
이번 글에서는 개인 계정과 구글 워크스페이스 계정을 모두 포함해, 안전하게 권한을 허용하는 과정을 단계별로 정리했습니다.
앱스크립트는 구글이 공식 제공하는 자동화 도구입니다.
구글시트나 문서, 드라이브 등에서 반복적인 작업을 대신 수행하거나 데이터를 자동으로 정리할 수 있도록 돕습니다.
예를 들어
시트 데이터를 정리하거나, 일정 시간마다 값을 갱신하거나, 버튼 한 번으로 보고서를 만드는 등
일상적인 업무를 자동화할 때 사용됩니다.
이 과정에서 스크립트가 여러분의 시트나 구글 서비스와 상호작용해야 하기 때문에
구글은 한 번의 권한 확인 절차를 거쳐, 이 스크립트가 신뢰할 수 있는지 확인합니다.
이 승인 절차는 단순히 스크립트가 해당 시트 안에서 정상적으로 작동할 수 있도록 허용하는 과정이며,
여러분의 개인정보나 계정 정보가 외부로 전송되거나 노출되는 일은 없습니다.
1. 권한 검토 알림
구글시트에서 앱스크립트를 처음 실행하면 화면 중앙에 ‘이 앱을 실행하려면 권한 검토가 필요합니다’라는 메시지가 나타납니다. 이때 [권한 검토] 버튼을 눌러야 합니다.
2. 계정 선택
이후 ‘계정 선택’ 창이 열립니다. 액세스할 구글 계정을 선택하라는 뜻이므로, 스크립트를 실행할 본인 구글 계정을 선택합니다.
3. 확인되지 않은 앱 경고
다음으로 ‘Google에서 확인되지 않은 앱입니다’라는 경고 문구가 나옵니다. 개인이 만든 스크립트이거나 검증 절차를 거치지 않은 경우에 나타나는 일반적인 안내입니다. 왼쪽 하단의 [고급] 버튼을 클릭합니다.
4. 고급 옵션 선택
‘고급’을 누르면 하단에 ‘OOO(으)로 이동(안전하지 않음)’이라는 문구가 보입니다. 여기서 OOO는 스크립트 제작자가 프로젝트에 설정한 이름입니다. 예를 들어 “매출자동화시트(으)로 이동”처럼 표시될 수 있습니다. 이 항목을 클릭합니다.
5. 계정 액세스 허용
‘OOO이 내 Google 계정에 액세스하려고 합니다’라는 안내창이 뜹니다. 어떤 권한이 필요한지 목록이 표시되며, 모두 정상적인 접근 권한입니다. 우측 하단의 [허용] 버튼을 클릭하면 설정이 완료됩니다.
6. 실행 확인
허용이 완료되면 다시 시트로 돌아가, 스크립트가 연결된 메뉴나 버튼을 클릭했을 때 정상적으로 실행됩니다. 이제 앱스크립트의 기능을 사용할 수 있습니다.
구글 앱스크립트란
Google Apps Script는 구글시트, 문서, 드라이브 등을 자동화할 수 있는 자바스크립트 기반 도구입니다. 반복적인 입력, 계산, 보고서 작성 같은 작업을 자동으로 수행하거나 데이터를 실시간으로 처리할 때 사용됩니다.
onEdit 함수란
onEdit 함수는 사용자가 시트에서 셀을 수정할 때 자동으로 실행되는 함수입니다. 예를 들어 특정 셀을 바꾸면 그 순간 바로 계산식이 갱신되거나 색상이 바뀌도록 만들 수 있습니다. 별도의 버튼을 누를 필요 없이 편집만으로 자동 반응합니다.
버튼 클릭 시 실행되는 원리
onEdit처럼 자동 실행되는 함수 외에도, 버튼에 특정 함수를 연결해 수동 실행할 수도 있습니다. 예를 들어 ‘데이터 불러오기’ 버튼에 함수를 연결해두면 버튼을 누를 때마다 코드가 실행됩니다. 이는 사용자가 직접 명령을 내리는 형태이며, 최초 1회 권한만 허용하면 이후에는 매번 자동 실행됩니다.
정리
앱스크립트는 구글시트를 포함한 구글 도구를 자동화하는 언어이며, onEdit은 수정 이벤트 감지용 함수입니다.
자동으로 실행되는 onEdit 함수와 버튼에 연결된 수동 실행 함수 모두 최초 1회만 권한 허용이 필요합니다.
순서는 권한 검토 → 계정 선택 → 고급 → OOO(으)로 이동 → 허용입니다.
한 번 허용하면 이후에는 시트 편집이나 버튼 클릭 시 스크립트가 자유롭게 실행됩니다.