구글 스프레드시트 시트 이름 추출, Apps Script로 자동 목록 만들기와 오류 해결

구글 스프레드시트에서 시트 이름을 동적으로 추출하여 목차(메뉴) 시트를 만들거나 특정 인덱스의 시트명을 셀에 표시하는 방법을 정리합니다. 이 가이드는 Apps Script로 사용자 정의 함수를 만들어 현재 활성 시트 이름을 불러오거나 전체 시트 목록을 세로로 출력하는 기본 코드, 실제로 자주 발생하는 "제목 추출 실패" 원인과 해결책(함수 인식 오류, 권한 문제, 자동 갱신 미구현)까지 다룹니다. 또한 메뉴 시트에 번호·하이퍼링크를 자동으로 생성하는 고급 예제와 자동화(트리거) 팁도 포함되어 있어 실무에서 바로 적용할 수 있습니다.

구글 스프레드시트 시트 이름 자동 추출 2026 최신 방법

핵심 정리: 무엇을 어떻게 만들 수 있나

이 섹션에서는 구현 가능한 주요 기능을 간단히 나열합니다.

  • 현재 활성 시트의 이름을 셀에 표시(예: =GetSheetName())
  • 스프레드시트 내 전체 시트 이름을 세로 목록으로 출력(예: =GetSheetNames())
  • 인덱스 번호로 특정 시트 이름을 반환(예: =GetSheetByIndex(2))
  • 목차(메뉴) 시트에 번호·이름·하이퍼링크 자동 생성 및 트리거 기반 자동 갱신
  • 실패 원인 진단: #NAME? 오류, 권한 미허용, 자동 갱신 미작동 등

기본 코드 예제 — 현재 활성 시트 이름

Apps Script 편집기(확장 프로그램 > Apps Script)에 아래 코드를 붙여넣고 저장한 뒤 스프레드시트에서 =GetSheetName()을 입력하면 현재 활성 시트의 이름을 반환합니다.

function GetSheetName() {
  return SpreadsheetApp.getActiveSpreadsheet().getActiveSheet().getName();
}

사용 팁: 코드 저장 후 스프레드시트를 새로고침(Ctrl+R)해야 함수가 인식되지 않는 경우가 줄어듭니다.

전체 시트 목록을 세로로 출력하는 함수

스프레드시트 내 모든 시트명을 세로 배열로 출력하려면 다음 함수를 사용합니다. 셀에 =GetSheetNames()를 입력하면 작동합니다.

function GetSheetNames() {
  var arrName = [];
  var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();
  for (var i = 0; i < sheets.length; i++) {
    arrName.push([sheets[i].getName()]);
  }
  return arrName; // 2차원 배열로 반환하면 세로 목록으로 표시
}

주의: 반환값은 2차원 배열이어야 시트에서 세로 목록으로 표시됩니다.

특정 인덱스의 시트 이름 가져오기 (오류 처리 포함)

인덱스(1부터 시작)를 받아 해당 시트 이름을 반환하는 함수 예제입니다. 존재하지 않는 인덱스는 메시지를 반환합니다.

function GetSheetByIndex(i) {
  try {
    var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();
    if ((i > 0) && (i <= sheets.length)) return sheets[(i - 1)].getName();
    else return "시트가 없음 #";
  } catch (err) {
    return "#오류발생!";
  }
}

실행·설정 방법 (빠른 단계별)

  • 스프레드시트 상단 메뉴에서 확장 프로그램 > Apps Script를 선택(새 편집기 열림).
  • 기본 제공되는 Code.gs에 코드를 붙여넣고 저장(Ctrl+S).
  • 스프레드시트로 돌아가서 셀에 사용자 정의 함수 호출(예: =GetSheetName()).
  • 첫 실행 시 권한 요청 팝업이 뜨면 허용해야 정상 동작함(계정 연결).
  • 함수 저장 후 시트가 함수를 인식하지 못하면 새로고침(Ctrl+R) 또는 브라우저 재시작 권장.

자주 발생하는 오류와 해결 방법

실무에서 가장 빈번히 마주치는 문제들과 해결책입니다.

  • #NAME? 오류
    • 원인: 스크립트에 함수가 저장되지 않았거나, 대소문자 오타, 스프레드시트를 새로고침하지 않음.
    • 해결: Apps Script에서 저장 후 스프레드시트 새로고침, 함수명 일치 확인(예: GetSheetName).
  • 권한(Authorization) 오류
    • 원인: Apps Script가 계정 권한을 요청했으나 허용하지 않음.
    • 해결: 앱 스크립트 편집기에서 처음 실행 시 나오는 권한 허용 절차를 완료.
  • 업데이트가 실시간 반영되지 않음
    • 원인: 사용자 정의 함수는 시트 구조 변경(시트 추가/삭제)에 자동 반응하지 않을 수 있음.
    • 해결: onEdit 또는 시간 기반 설치형 트리거로 자동 갱신 로직을 추가하거나, 사용자가 수동으로 새로고침/재입력.
  • 스크립트 권한 범위 및 한계
    • 참고: 일부 서비스는 사용자 인증이 필요하며, 사용자 정의 함수 내에서 셀 외부 상태를 변경하는 부작용은 제한됩니다. 복잡한 동작(다른 셀 변경 등)은 메뉴/트리거로 처리하세요.

고급 예제: 번호 + 이름 + 하이퍼링크로 메뉴 시트 생성

아래 스크립트는 '메뉴'라는 시트를 만들고, 모든 시트의 번호·이름·하이퍼링크를 생성합니다. 시트 이동용 하이퍼링크는 각 시트의 gid를 사용합니다.

function listSheetName() {
  var spreadsheet = SpreadsheetApp.getActive();
  var sheets = spreadsheet.getSheets();
  var menuName = '메뉴';
  var sht = spreadsheet.getSheetByName(menuName);
  if (sht == null) sht = spreadsheet.insertSheet(menuName);
  // 기존 내용 초기화
  sht.clearContents();
  for (var i = 0; i < sheets.length; i++) {
    var name = sheets[i].getSheetName();
    var gid = sheets[i].getSheetId(); // 시트 고유 ID
    // 메뉴 시트의 A열: 번호, B열: 하이퍼링크(=HYPERLINK)
    sht.getRange(i + 1, 1).setValue(i + 1);
    // HYPERLINK("#gid=123456", "시트명")
    var formula = '=HYPERLINK("#gid=' + gid + '", "' + name + '")';
    sht.getRange(i + 1, 2).setFormula(formula);
  }
}

실행: Apps Script 편집기에서 listSheetName()을 직접 실행하거나, 메뉴에 연결해서 사용합니다.

자동 갱신: 트리거(onEdit / 시간기반) 적용 예

시트 추가/삭제 시 목록을 자동으로 갱신하려면 설치형 트리거 또는 onEdit를 활용합니다. 간단한 onEdit 예시는 다음과 같습니다(편집 이벤트 발생 시 메뉴 시트를 업데이트하도록 listSheetName() 호출).

function onEdit(e) {
  // 편집이 발생할 때마다 메뉴 갱신(빈번한 편집이 많은 경우 주의)
  try {
    listSheetName();
  } catch (err) {
    // 오류 무시 또는 로깅
  }
}

더 안정적인 방법은 시간 기반 설치형 트리거(예: 5분/1시간 단위)로 listSheetName()을 정기 실행하는 것입니다(편집 트리거는 빈번한 호출로 한도에 걸릴 수 있음).

실전 팁 & 활용 사례

  • 목차 시트를 이용해 팀원들이 빠르게 시트로 이동하도록 하이퍼링크 제공.
  • 시트 개수를 자동으로 모니터링하려면 SpreadsheetApp.getActive().getNumSheets() 사용.
  • 다른 시트에서 시트명 목록을 집계해 대시보드나 보고서 자동 생성에 활용.
  • Apps Script 편집기 UI는 주기적으로 업데이트되므로 메뉴 경로가 달라질 경우 "확장 프로그램 > Apps Script"를 찾아 실행.

마무리 및 권장 설정

요약하면, 구글 스프레드시트의 시트 이름을 동적으로 불러오려면 Apps Script 기반의 사용자 정의 함수가 가장 실용적입니다. 기본 코드는 간단하지만, 현장에서 흔히 마주치는 오류(함수 미인식, 권한, 자동 갱신 미작동)를 고려해 권한 승인 완료, 스크립트 저장 후 새로고침, 필요 시 트리거 설정을 반드시 수행하세요. 메뉴 시트에 번호·하이퍼링크를 추가하면 사용성도 크게 향상됩니다. 공식 문서를 참고해 권한 범위와 실행 한도를 확인한 뒤 적용하면 안정적으로 운영할 수 있습니다.



이 블로그의 인기 게시물

부산 만 65세 이상 어르신 교통카드 신청, 발급처와 필요서류

이미지
부산 만 65세 이상 어르신 교통카드 신청·발급처 및 필요서류 안내 정보 확인 필요 요약: 본 글은 부산에 거주하는 만 65세 이상 어르신을 위한 교통카드(경로우대/어르신 복지교통카드) 신청 절차와 발급처, 필요서류, 카드별 주요 특징 및 사용 방법을 한눈에 정리한 안내서입니다. 지하철 무임 적용 기준, 버스 관련 지원 사업(연간 교통비 지원 등)과의 차이, 2025년 이후 연령 기준 논의에 따른 유의사항까지 포함하여 실제 신청 시 도움이 되는 실무 정보를 중심으로 구성했습니다. 부산 어르신 교통카드와 교통비 지원 제도 개요 부산에서 운영되는 어르신 관련 교통 혜택은 크게 두 가지로 나뉩니다. 도시철도(부산지하철) 경로우대 무임 : 부산교통공사·부산시 규정에 따라 만 65세 이상 경로우대자가 지하철 무임 혜택을 받습니다. 어르신 교통비 지원(버스 포함) : 지자체 예산에 따라 연간 일정 금액을 교통카드에 충전해주는 방식 등 다양한 지원 사업으로 운영되며, 전면 무임(버스 0원)은 지자체별·년도별로 상이합니다. 핵심 포인트: 2024~2025년 연령 기준(만 65세→67세 상향 논의)과 관련한 중앙정부 차원의 논의가 있으나, 부산시는 현재(최신 공고 기준) 만 65세 이상을 경로우대자로 적용하고 있으므로 발급·이용 시 부산시·부산교통공사 공지를 우선 확인해야 합니다. 무임 대상 요건(요약) 연령 : 기본적으로 만 65세 이상(생년월일 기준)이 경로우대자로 인정됩니다. 거주지 : 주민등록상 부산광역시 거주자에게 부산시가 지원하는 복지·어르신 교통카드 발급이 가능합니다. 교통수단 : 도시철도(부산지하철)는 경로우대 무임 적용. 버스는 지자체 지원사업에 따라 다르며, 전면 무료가 아닌 지원금 충전 방식이 일반적입니다. 소득 요건 : 지하철 무임은 통상 소득 기준 없음. 단, 일부 교통비 지원 사업은 소득 기준이 적용될 수 있습니다. 부산에서 발급 가능한 주요 카...
자세한 내용 보기

체크카드 환불기간, 카드사별 소요와 승인 취소 및 매입 취소 차이

이미지
체크카드 환불 관련 정보를 한눈에 정리합니다. 본문에서는 체크카드 환불의 기본 원리, '승인 취소'와 '매입(매출) 취소'의 차이, 카드사별 평균 환불 소요(2024~2026년 단축 추세 반영), 할부·해외·고액 거래 등 특수 케이스 처리 방식 및 환불을 빠르게 받는 실전 팁을 제공합니다. 공식 안내 링크를 함께 정리해 드리니 환불 문의나 분쟁 시 참고하시기 바랍니다. 체크카드 환불기간 핵심 정리 체크카드는 결제 즉시 연결된 계좌에서 출금되는 방식입니다. 환불(취소) 처리 방식과 시점에 따라 실제 입금(또는 한도 복원)에 걸리는 시간이 달라집니다. 일반적으로 카드사·가맹점·PG사 처리 속도에 따라 1~7영업일이 소요되며, 2024년 이후 환불 처리 시간이 크게 단축되어 현재는 많은 경우 1~3영업일 내 완료되는 추세입니다. 승인 취소(Authorized Cancel) vs 매입 취소(Acquirer/Settlement Cancel) 차이 취소 시점 취소 방식 환불(한도 복원) 소요 특징 결제 직후 (전표 미매입) 승인 취소 즉시 ~ 1영업일 가장 빠름. 카드사·PG사에 승인 자체를 무효화. 전표 매입 완료 후 매입 취소(매출 취소) 2 ~ 5영업일 (최근 단축 추세: 1~3영업일) 가맹점→카드사 반환 필요. 체크카드의 경우 계좌 환불 방식으로 입금 대기 발생. 결제일·이체 완료 후(계좌에서 출금됨) 카드사 환불(계좌 입금) 3 ~ ...
자세한 내용 보기

법정지연이자율 연도별 변화, 민법 개정 추진과 2026 변동제 전망

이미지
법정지연이자율은 당사자 간 이율 약정이 없거나 채무불이행 시 법률상 자동으로 적용되는 이율을 뜻하며, 오랜 기간 연 5%로 고정되어 왔다. 본문에서는 법정지연이자율의 기본 개념과 연도별 변화 흐름(1960년대~2026 전망), 법률별 적용 이율 비교, 지연손해금 계산법(실무 공식 예시)과 함께 2025년 민법 개정 추진 내용과 2026년 변동금리 전환 전망을 정리한다. 또한 실무에서 사용할 수 있는 계산 팁과 공식 페이지 링크를 제공해 실제 사례에 바로 적용할 수 있도록 안내한다. 법정지연이자율(기본 개념) — 왜 중요한가? 민법 제379조에 따른 법정이율(현행 기준 연 5%)은 채무자가 지체·불이행한 경우 채권자가 받을 수 있는 지연손해금의 기준이다. 다만 소송비용법·민사집행법 등 특정 법률에서는 별도의 높은 이율(예: 연 12%)을 규정해 실무 적용 시 법률별 차이를 반드시 확인해야 한다. 장기간 고정된 이율 구조 때문에 인플레이션·금리 변화가 반영되지 않는다는 비판이 존재하며, 이에 따라 2025년 이후 민법 개정 추진과 2026년 변동제 도입 논의가 활발하다. 법정지연이자율 연도별 변화(요약 표) 연도 민법 기준 이율 주요 비고 1960년대~2024 연 5%(고정) 67년간 고정, 지연손해금 기준으로 사용 2025 연 5% (법률상 유지) 법무부 민법 개정안 입법예고(변동제 추진) 2026 전망 변동금리 전환(예상) 한국은행 기준금리·물가 연동형 도입안 검토 중 시기별·법률별 적용 이율과 지연...
자세한 내용 보기