Google Apps Script(.gs 파일)

 

Google Apps Script(.gs 파일)는 크게 두 가지 방법으로 실행할 수 있습니다.

---

1. 웹 에디터(Online)에서 실행하기

1. Google Apps Script 에디터 접속
   브라우저에서 https://script.google.com 에 접속하고, Google 계정으로 로그인합니다.
2. 새 프로젝트 생성
   우측 상단의 “새 프로젝트” 버튼을 클릭합니다.
3. 코드 붙여넣기
   기본으로 열리는 Code.gs 탭에, 실행하고자 하는 .gs 파일의 코드를 그대로 복사·붙여넣습니다.
4. 함수 선택
   에디터 상단 툴바 왼쪽 드롭다운에서 실행하고 싶은 함수 이름(예: myFunction)을 선택합니다.
5. 실행 버튼(▶️) 클릭
   ▶️ 버튼을 클릭하면 처음 실행 시 권한 요청 팝업이 뜨고, 승인 과정을 거치면 스크립트가 실행됩니다.
6. 로그 보기
   실행 후 **“보기” → “로그”**를 선택하면 Logger.log() 등에 기록한 출력 결과를 확인할 수 있습니다.

---

2. clasp CLI로 로컬에서 관리·실행하기

로컬 에디터(VS Code 등)에서 개발하고, 터미널 명령으로도 실행·디버깅할 수 있습니다.

1. Node.js & clasp 설치
2. bash
    
   npm install -g @google/clasp
3. clasp 로그인브라우저가 열리면 Google 계정 권한을 승인하세요.
4. bash
    
   clasp login
5. 프로젝트 초기화
   • 기존 프로젝트 연결:
   • bash
      
     cd your/project/folder clasp clone <SCRIPT_ID>
   • 새 프로젝트 생성:
   • bash
      
     mkdir my-gas-project && cd my-gas-project clasp create --type standalone --title "My GAS"
   이때 clasp create 하면 .clasp.json에 scriptId가 저장됩니다.
6. 코드 작성
   프로젝트 폴더에 Code.gs 파일을 만들고, 실행할 코드를 작성(또는 붙여넣기)합니다.
7. 코드 푸시(push)
8. bash
    
   clasp push
9. 함수 실행(run)
   • 터미널에서 직접 실행:
   • bash
      
     clasp run --function myFunction
   • 또는 웹 에디터로 가서 ▶️ 실행해도 됩니다.
10. 로그 확인혹은 웹 에디터의 “보기” → “로그” 에서 확인할 수 있습니다.
11. bash
    복사편집
    clasp logs

---

팁

• 트리거 예약 실행
  에디터에서 “편집” → “현재 프로젝트의 트리거” 를 클릭해, 시간 기반(예: 매일 오전 9시) 또는 이벤트 기반(새 스프레드시트 생성 시 등) 트리거를 설정할 수 있습니다.
• 권한 오류
  최초 실행 시 권한 범위를 묻는 다이얼로그가 뜹니다. 필요한 권한을 **“고급” → “프로젝트로 이동”**을 눌러 승인해 주세요.