본문 바로가기
구글 앱 스크립트

구글 앱스 스크립트 SpreadSheetApp 기능 정리 (Google Apps Script)[22]

by parkjp 2024. 5. 1.

서론

 

안녕하세요, 지난 글에서는 구글 드라이브에 있는 파일을 휴지통으로 옮기는 법과 복원하는 법을 알아보았습니다.

이번 글에서는 SpreadSheetApp의 기능을 정리해보려고 합니다.

 

혹시 지난 포스팅을 못보신 분들은 아래 링크를 클릭해 주세요.

https://developer-jp.tistory.com/199

 

구글 앱스 스크립트를 이용하여 파일 휴지통으로 보내기(Google Apps Script) [21]

서론 안녕하세요, 지난 글에서는 스프레드시트에서 앱스 스크립트로 다른 시트의 정보를 가져오는 법을 알아보았습니다. 이번 글에서는 구글 드라이브에 있는 파일을 휴지통으로 옮기는 법과

developer-jp.tistory.com

반응형

 

SpreadSheetApp 기능 정리

 

SpreadSheetApp 클래스의 기능(method)을 정리해 보겠습니다.

 

Method 사용 예 )

SpreadSheetApp.create('예시')

 

 

** 스프레드시트 - 엑셀 파일

** 시트 - 엑셀 파일 내 시트

** 활성 셀 - 현재 포커스가 가리키는 셀. 내가 선택한 셀.

** 활성 시트 - 현재 내가 바라보고 있는 시트. 내가 선택한 시트.

기능 (Method) Return type 설명
create(name) Spreadsheet 새로운 스프레드시트를 주어진 이름으로 생성합니다.
create(name, rows, columns) Spreadsheet 새로운 스프레드시트를 주어진 이름과 행, 열 수 만큼 지정하여 생성합니다.
enableAllDataSourcesExecution() - 모든 유형의 데이터 소스에 대해 데이터 실행을 켭니다.
enableBigQueryExecution() - BigQuery 데이터 소스에 대한 데이터 실행을 활성화 합니다.
flush() - 보류 중인 모든 스프레드시트 변경 사항을 적용합니다.
getActive() Spreadsheet 현재 활성 스프레드시트를 반환하거나 없는 경우 null을 반환합니다.
getActiveRange() Range 활성 시트에서 선택한 범위를 반환하거나 활성 범위가 없는 경우 null을 반환합니다.
getActiveRangeList() RangeList 활성 시트의 활성 범위 리스트를 반환하거나 선택한 범위가 없는 경우 null을 반환합니다.
getActiveSheet() Sheet 스프레드시트의 활성화된 시트를 가져옵니다.
getActiveSpreadSheet() Spreadsheet 현재 활성 스프레드시트를 반환하거나 없는 경우 null을 반환합니다.
getCurrentCell() Range 활성 시트에서 현재 바라보고 있거나 선택된 셀을 반환합니다.
getSelection() Selection 스프레드시트에서 현재 선택하거나 바라보고 있는 것을 반환합니다.
getUi() Ui 스크립트가 메뉴, 대화 상자 및 사이드바와 같은 기능을 추가할 수 있도록 하는 스프레드시트의 사용자 인터페이스 환경의 인스턴스를 반환합니다.
newCellImage() CellImageBuilder 셀 이미지에 관한 기능을 가진 builder를 반환합니다.
newColor() ColorBuilder 색상에 관한 기능을 가진 builder를 반환합니다.
newConditionalFormatRule() ConditionalFormatRuleBuilder 조건부 서식 규칙에 관한 기능을 가진 builder를 반환합니다.
newDataSourceSpec() DataSourceSpecBuilder 데이터 소스 스펙에 관한 기능을 가진 builder를 반환합니다.
newDataValidation() DataValidationBuilder 데이터 유효성 검사에 관한 기능을 가진 builder를 반환합니다.
newFilterCriteria() FilterCriteriaBuilder 필터에 관한 기능을 가진 builder를 반환합니다.
newRichTextValue() RichTextValueBuilder 서식 있는 텍스트에 관한 기능을 가진 builder를 반환합니다.
newTextStyle() TextStyleBuilder 텍스트 스타일에 대한 기능을 가진 builder를 반환합니다.
open(file) Spreadsheet 해당 파일을 엽니다.
openById(id) Spreadsheet 해당 id로 파일을 엽니다.
openByUrl(url) Spreadsheet 해당 url로 파일을 엽니다.
setActiveRange(range) Range 지정된 범위를 활성 범위로 설정하고 활성 셀을 왼쪽 위 셀로 설정합니다.
setActiveRangeList(rangeList) RangeList 지정된 범위 목록을 활성 범위로 설정합니다.
setActiveSheet(sheet) Sheet 스프레드시트의 활성 시트를 해당 시트로 설정합니다.
setActiveSheet(sheet, restoreSelection) Sheet 해당 시트 내에서 가장 최근 선택 항목을 복원하는 옵션을 사용하여 활성 시트를 설정합니다.
setActiveSpreadsheet(newActiveSpreadseet) - 활성 스프레드시트를 설정합니다.
setCurrentCell(cell) Range 지정된 셀을 활성 셀로 설정합니다.

 

 

마무리

 

SpreadSheetApp의 기능을 정리해 보았습니다.

create나 getActiveSheet, openById 같은 경우 자주 쓰는 기능이고 제 이전 포스팅들에서도 보시면 자주 쓰이고 있다는 걸 보실 수 있을겁니다.

 

다음 포스팅은 Spreadsheet 클래스에 관해 기능정리를 하겠습니다.

반응형