앱스 스크립트 사용법, 매크로 기록으로 만들고 시간 트리거로 돌리는 순서

구글 시트에서 코드를 직접 쓰지 않고 앱스 스크립트(Google Apps Script) 자동화를 만드는 가장 짧은 길은 매크로 기록이에요. 시트 상단의 확장 프로그램 > 매크로 > 매크로 기록을 누르고 반복할 작업을 한 번 해 보인 뒤 저장하면, 시트가 그 단계를 따라 하는 Apps Script 함수를 macros.gs 파일에 만들어요. 이 함수를 정해진 시각이나 간격으로 돌리려면 Apps Script 개발자 문서 기준으로 편집기 왼쪽의 트리거를 누르고 오른쪽 아래 트리거 추가에서 시간 기반 트리거를 걸면 돼요. gmail.com 같은 개인 계정은 트리거로 돈 시간의 합이 하루 90분, 한 번 실행은 6분을 넘길 수 없어요.

메뉴 이름은 문서마다 다르게 적혀 있어요. 구글 시트 고객센터 도움말의 매크로 예약하기 절은 도구 > 스크립트 편집기, 수정 > 현재 프로젝트의 트리거라는 이름을 쓰고, Apps Script 개발자 문서는 확장 프로그램 > Apps Script와 왼쪽 트리거 메뉴로 적어요. 아래에서 두 문서를 나란히 놓았어요.

이 글은 2026년 10월 19일 오후 4시 34분부터 4시 40분 사이(한국 시각)에 Apps Script 개발자 문서 여러 편(일부는 영어판과 한국어판 둘 다)과 구글 시트 고객센터 도움말, 구글 클라우드 고객센터 도움말을 받아 해당 문장과 표를 옮긴 거예요. 실제 구글 계정으로 시트를 열어 매크로를 기록하거나 트리거를 걸어 보지는 않았어요. 그래서 버튼 이름은 문서에 적힌 그대로이고, 내 화면에서는 다르게 보일 수 있어요.

앱스 스크립트 사용법, 코드 없이 시작하는 다섯 단계

결론부터 순서로 보면 이래요. 각 단계의 메뉴 이름은 괄호 안 문서에서 가져왔어요.

1. 매크로 기록하기 (구글 시트 도움말): 컴퓨터에서 sheets.google.com의 스프레드시트를 열고 확장 프로그램 > 매크로 > 매크로 기록을 눌러요. 화면 아래에서 절대 참조와 상대 참조 가운데 하나를 고르고, 반복할 작업을 한 번 한 뒤 저장을 눌러요. 매크로 이름과 맞춤 단축키를 정하고 다시 저장하면 기록이 끝나요.
2. 한 번 직접 실행해 권한 승인하기 (Apps Script 승인 문서): 스크립트에 승인이 필요하면 실행할 때 승인 대화상자가 떠요. 트리거는 만든 사람이 승인해야 하니, 트리거를 걸기 전에 확장 프로그램 > 매크로 메뉴에서 매크로를 한 번 돌리거나 편집기에서 함수를 한 번 실행해 승인을 마쳐 두세요.
3. Apps Script 편집기 열기 (Apps Script 매크로 문서): 확장 프로그램 > 매크로 > 매크로 관리에서 그 매크로의 더보기 아이콘 > 매크로 수정을 누르면 매크로 함수가 들어 있는 파일로 편집기가 열려요. 확장 프로그램 > Apps Script를 눌러도 시트에 결합된 스크립트가 편집기에 열려요.
4. 시간 기반 트리거 추가하기 (Apps Script 설치 가능한 트리거 문서): 편집기 왼쪽에서 트리거(알람 시계 아이콘)를 누르고 오른쪽 아래 트리거 추가를 눌러요. 만들 트리거 유형을 고르고 설정한 뒤 저장해요. 돌릴 대상은 3단계에서 본 매크로 함수예요.
5. 실행 기록 확인하기 (Apps Script 로깅 문서): 편집기 왼쪽의 실행을 누르면 실행 기록이 보여요. 실패한 실행만 보려면 상단 필터 추가 > 상태에서 실패와 시간 초과를 체크해요.

매크로 문서는 매크로가 가벼울수록 성능이 좋다며 가능하면 매크로가 하는 동작 수를 줄이라고 권해요. 예약해서 돌릴 매크로라면 한 번 실행이 6분을 넘지 않도록 작업 하나만 담는 편이 관리하기 쉬워요.

매크로를 기록하면 무엇이 만들어지나

매크로 기록은 코드를 대신 써 주는 기능이에요. Apps Script 매크로 문서는 매크로를 기록하면 시트가 그 단계를 똑같이 따라 하는 Apps Script 함수, 곧 매크로 함수를 자동으로 만든다고 적었어요. 이 함수는 시트에 결합된 Apps Script 프로젝트의 macros.gs 파일에 들어가고, 같은 이름의 파일이 이미 있으면 그 파일에 이어 붙어요. 매크로 이름과 단축키는 프로젝트 매니페스트에 자동으로 기록돼요.

그래서 기록한 매크로는 전부 Apps Script 편집기에서 열어 고칠 수 있어요. 코드를 한 줄도 쓰지 않았어도 편집기를 열면 기록한 단계가 함수로 적혀 있어요.

알아 둘 제약도 같은 문서에 정리돼 있어요.

출처: Apps Script 「Google Sheets Macros」(영어판 2026년 9월 3일 갱신), 2026년 10월 19일 확인

예약 실행이라면 참조 유형을 다시 보세요

기록을 시작할 때 고르는 참조 유형이 결과를 바꿔요. 구글 시트 도움말 기준으로 절대 참조는 사용자가 어떤 셀을 클릭했든 기록한 그 셀에서만 작업하고, 상대 참조는 선택한 셀과 그 근처 셀에서 작업해요. A1과 B1을 굵게 만든 상대 참조 매크로는 나중에 C1과 D1을 굵게 만드는 데 쓸 수 있다는 예도 적혀 있어요.

시간 트리거로 돌릴 때는 화면 앞에서 셀을 고르는 사람이 없어요. SpreadsheetApp 참조 문서는 활성 시트를 시트 화면에 표시된 시트로, 활성 범위를 보통 사용자가 선택한 범위로 설명해요. 시간 기반 트리거로 실행될 때 어느 시트와 범위가 활성으로 잡히는지는 이번에 연 문서에서 찾지 못했어요. 그래서 예약 실행용 매크로는 트리거를 건 뒤 첫 실행 결과를 시트에서 직접 확인하고, 탭이 여러 개인 시트라면 어느 탭이 바뀌었는지까지 보는 게 안전해요.

처음 실행할 때 뜨는 권한 창

Apps Script 승인 문서는 승인이 다섯 단계로 진행된다고 적었어요. 스크립트를 훑어 어떤 서비스를 쓰는지 찾고(예를 들어 SpreadsheetApp), 그에 맞는 OAuth 범위를 정한 뒤, 실행할 때 사용자가 이미 승인했는지 확인해요. 승인이 없으면 권한을 달라는 대화상자가 뜨고, 승인이 끝나야 그 사용자의 데이터에 접근해요. 영어판(2026년 9월 3일 갱신)은 세부 권한을 지원하는 화면에서는 범위를 하나씩 허용하거나 거부할 수 있는 동의 화면이 뜬다는 문장을 더 적었는데, 한국어판(2026년 4월 23일 갱신)에는 이 문장이 없어요.

초보자가 걸리는 지점은 세 가지예요.

• 주석으로 막아 둔 코드도 승인을 요청할 수 있어요. 범위는 코드를 훑어서 자동으로 정하는데, 문서는 주석 처리된 코드도 승인 요청을 만들 수 있다고 적었어요.
• 코드를 고쳐 새 서비스를 쓰면 다시 승인해야 해요. 이전에 승인한 스크립트도 새 서비스가 추가되면 추가 승인을 요청해요. 트리거로만 도는 스크립트라면 이 창을 볼 사람이 없으니, 문서의 문제 해결 항목대로 편집기에서 함수를 한 번 직접 실행해 승인 창을 띄워야 해요.
• 확인되지 않은 앱 경고가 뜰 수 있어요. 민감한 범위를 쓰는 스크립트를 승인할 때 구글이 앱을 인증하지 않았다는 경고 화면이 보일 수 있다고 승인 문서가 적었어요.

경고 화면이 누구에게 뜨는지는 OAuth 클라이언트 확인 문서의 표에 있어요. 이 표는 앱이 민감한 OAuth 범위를 쓸 때의 이야기이고, 구글 확인을 마친 클라이언트는 모든 경우가 일반 승인 흐름이에요.

출처: Apps Script 「OAuth Client Verification」(영어판 2026년 9월 3일 갱신), 2026년 10월 19일 확인. 클라이언트 확인을 받지 않았고 민감한 범위를 쓰는 경우 기준

확인되지 않은 승인 흐름에서는 사용자가 위험을 이해했다고 확인한 뒤에야 앱을 승인하고 쓸 수 있다고 문서가 적었어요. 내가 기록한 매크로가 실제로 민감한 범위를 요청하는지, 경고 화면의 버튼이 정확히 어떤 문구인지는 이번에 연 문서에 적혀 있지 않았어요. 남이 만든 시트 사본에 붙은 스크립트를 승인할 때는 누가 만든 코드인지 먼저 확인하세요.

회사 계정이라면 Apps Script 빠른 시작 문서가 준비물 항목에 Google Workspace 계정은 관리자 승인이 필요할 수 있다고 적었어요. 승인한 권한을 거두려면 Google 계정의 보안 섹션에서 서드 파티 앱 및 서비스 연결의 모든 연결 보기로 들어가 해당 스크립트를 고르고 연결을 모두 삭제하면 돼요.

시간 트리거 거는 자리와 간격

시간 기반 트리거는 단순 트리거로는 만들 수 없어요. Apps Script 단순 트리거 문서의 표에서 시간 기반(시계) 행은 단순 트리거 칸이 비어 있고, 설치 가능한 트리거 칸에만 시트, 프레젠테이션, 설문지, 문서, 독립형이 적혀 있어요. 단순 트리거는 30초 넘게 실행할 수 없고 승인이 필요한 서비스도 못 쓴다는 제약이 있어서, 예약 실행은 설치 가능한 트리거로 걸어요.

설치 가능한 트리거 문서가 적은 수동 생성 순서는 다섯 줄이에요.

1. Apps Script 프로젝트를 열어요.
2. 왼쪽에서 트리거(알람 시계 아이콘)를 눌러요.
3. 오른쪽 아래 트리거 추가를 눌러요.
4. 만들려는 트리거 유형을 고르고 설정해요.
5. 저장을 눌러요.

문서는 4단계를 유형을 고르고 설정하라는 한 줄로만 적었고, 창 안에 어떤 칸과 선택지가 있는지는 나열하지 않았어요. 같은 문서의 시간 기반 트리거 절은 실행 간격을 1분마다부터 한 달에 한 번까지로 설명해요. 코드로 트리거를 만들 때 쓰는 ClockTriggerBuilder 참조 문서는 분 단위 간격을 1, 5, 10, 15, 30분 가운데 하나로 정하게 적었어요. 편집기 창에도 같은 선택지가 보이는지는 확인하지 않았어요.

실행 시각과 기준 시간대도 문서에 적혀 있어요.

출처: Apps Script 「Installable Triggers」·「Script Projects」·「ClockTriggerBuilder」, 2026년 10월 19일 확인

정시에 맞춰야 하는 일이라면 이 무작위 폭을 계산에 넣어야 해요. 도구마다 스케줄이 어느 시계를 읽는지는 자동화 스케줄의 시간대를 다섯 도구로 비교한 글에 따로 정리돼 있어요.

메뉴 이름이 문서마다 달라요

같은 작업을 두 문서가 다른 이름으로 적어요. 어느 쪽이 지금 화면과 같은지는 이 글이 화면을 열어 보지 않아서 단정하지 않아요.

출처: 구글 Docs 편집기 고객센터 「Google Sheets에서 작업 자동화하기」(갱신일 표기 없음), Apps Script 매크로·결합된 스크립트·설치 가능한 트리거·대시보드 문서, 2026년 10월 19일 확인

시트 도움말 한 페이지 안에서도 섞여 있어요. 매크로 기록과 실행, 관리는 확장 프로그램 > 매크로 메뉴로 적었는데, 매크로를 만들면 Apps Script가 생성된다는 참고 줄과 매크로 예약하기 절은 도구 > 스크립트 편집기로 적었어요. 같은 페이지의 매크로 수정하기 절은 매크로 관리 화면에서 매크로 옆 더보기를 눌러 스크립트를 수정하라고 따로 안내해요. 영어판도 Tools > Script editor, Edit > Current project's triggers로 같은 이름이라 번역에서 생긴 차이는 아니에요.

개발자 문서 쪽은 매크로와 설치 가능한 트리거 문서 영어판이 2026년 9월 3일, 결합된 스크립트와 스크립트 프로젝트 문서 영어판이 2026년 10월 7일 갱신으로 찍혀 있어요. 시트 도움말에는 갱신일 표기가 없어요. 내 화면에서 도구 메뉴 아래 스크립트 편집기가 안 보이면 개발자 문서 쪽 경로로 찾아보세요.

개인 계정과 워크스페이스 계정의 한도

예약 실행이 멈추는 흔한 이유 하나는 시간 한도예요. Apps Script 할당량 문서(영어판 2026년 9월 3일 갱신)의 값은 이래요.

출처: Apps Script 「Quotas for Google Services」, 2026년 10월 19일 확인. 한국어판(2026년 4월 23일 갱신)도 같은 값

할당량은 사용자 단위이고 첫 요청 후 24시간이 지나면 다시 채워져요. 문서는 모든 할당량이 예고 없이 없어지거나 줄거나 바뀔 수 있다고 적었어요.

짧은 간격일수록 하루 합계가 빨리 차요. 1분마다 도는 트리거는 하루 1,440번 실행되는데, 한 번에 4초만 걸려도 단순 합으로 96분이 돼서 일반 사용자 계정의 하루 90분을 넘어요. 한 번에 3초라면 72분이에요. 하루 합계를 넘기면 할당량 문서가 적은 Service using too much computer time for one day 예외가 나요. 문서는 이 예외가 트리거로 도는 스크립트에서 가장 흔하고, 트리거로 도는 스크립트의 하루 한도가 수동 실행보다 낮다고 설명해요.

워크스페이스 무료 체험 계정에는 한도가 더 붙어요. 유료로 전환한 뒤 도메인 누적 결제액이 100달러 이상이 되고 그 금액에 도달한 지 60일이 지나면 한도가 자동으로 올라간다고 문서가 적었어요. 메일 발송 수 한도는 이 글에서 다루지 않아요. 앱스 스크립트로 메일을 보낼 계획이라면 지메일 발송 한도와 앱스 스크립트 할당량이 갈리는 자리를 정리한 글을 함께 보세요.

실패했을 때 확인하는 곳

트리거로 돈 함수가 실패해도 화면에는 오류가 뜨지 않아요. 설치 가능한 트리거 문서는 대신 [email protected] 주소에서 Summary of failures for Apps Script라는 제목의 메일이 온다고 적었어요. 이 메일에는 트리거를 끄거나 다시 설정하는 링크가 있고, 시트에 결합된 스크립트라면 그 시트 링크도 들어 있어요.

원인을 찾는 곳은 세 군데예요.

1. 편집기 왼쪽 실행: 실행 로그에서 어떤 실행이 실패했는지와 오류 메시지를 볼 수 있어요. 로깅 문서는 상단 필터 추가 > 상태에서 실패와 시간 초과를 고르면 실패한 실행만 추린다고 적었어요.
2. Apps Script 대시보드의 내 실행: 실행마다 시작 시각, 걸린 시간, 상태가 한 줄씩 보이고, 유형 열에 시간 이벤트로 실행된 건 시간 기반, 편집기에서 실행한 건 편집기로 찍혀요.
3. script.google.com의 내 트리거: 내 계정에 걸린 트리거를 한꺼번에 보고, 트리거 오른쪽 더보기 > 트리거 삭제로 지울 수 있어요.

트리거를 켜 둔 채로 실패 알림만 완전히 끌 수는 없어요. 문서는 트리거를 비활성화하거나 삭제해야 그 알림도 멈추고, 트리거가 켜져 있는 동안에는 알림 빈도만 조정할 수 있다고 적었어요.

주의사항과 한계

• 트리거는 만든 사람 계정으로 돌아요. 설치 가능한 트리거는 항상 만든 사람의 계정으로 실행돼요. 트리거가 메일을 보내면 늘 내 계정에서 나가고, 다른 계정이 설치한 트리거는 내 계정에서 보이지 않아요.
• 시트 수정 권한이 있어야 실행돼요. 결합된 스크립트는 그 시트를 수정할 수 있는 사용자만 실행할 수 있어요. 보기 권한만 있는 공동작업자에 대해서는 영어판(2026년 10월 7일 갱신)이 스크립트를 볼 수 있다고, 한국어판(2026년 4월 23일 갱신)이 스크립트 편집기를 열 수 없다고 서로 다르게 적었어요.
• 여러 계정에 동시에 로그인한 상태는 지원되지 않아요. 두 개 이상의 구글 계정에 로그인한 채 편집기를 열면 계속할 계정을 고르라는 메시지가 뜬다고 스크립트 프로젝트 문서가 적었어요. 트리거를 만든 계정이 곧 실행 계정이라 여기서 계정을 잘 골라야 해요.
• 매크로는 시트에서만 돼요. 문서, 설문지, 프레젠테이션에는 매크로 기능이 없어요.
• 결합된 프로젝트를 지우면 되살릴 수 없어요. 스크립트 프로젝트 문서가 그렇게 적었어요.
• 한도는 바뀔 수 있어요. 위 표는 2026년 10월 19일에 받은 값이고, 문서 자체가 예고 없이 바뀔 수 있다고 적었어요.

이 글이 확인하지 않은 것

이 글은 2026년 10월 19일에 구글 공식 문서를 받아 해당 문장과 표를 옮긴 것까지예요. 아래는 확인하지 않았어요.

• 실제 구글 계정에서 시트 상단에 도구 > 스크립트 편집기 메뉴가 아직 있는지, 편집기에 수정 메뉴가 있는지
• 트리거 추가 창 안의 칸 이름과 선택지
• 기록한 매크로가 요청하는 권한 범위와 확인되지 않은 앱 화면의 버튼 문구
• 시간 기반 트리거로 실행될 때 활성 시트와 활성 범위가 무엇으로 잡히는지
• 하루 한도를 넘긴 뒤 실제로 언제 다시 실행되는지
• 모바일 시트 앱에서의 매크로 기록

원문은 Google Sheets에서 작업 자동화하기, 설치 가능한 트리거, Apps Script 할당량에서 볼 수 있어요.

함께 보면 좋은 글

시트에 있는 명단으로 사람마다 문서를 나눠 보내는 흐름은 급여명세서를 개인별로 나눠 보내는 자동화 5단계에서 이어서 볼 수 있어요. 시간 트리거로 메일을 보내는 단계가 나오는 글이라, 위 한도 표와 같이 보면 어디서 막힐지 미리 가늠할 수 있어요.