1. 서론
안녕하세요, 지난 글에서는 구글 드라이브에 있는 파일을 휴지통으로 옮기는 법과 복원하는 법을 알아보았습니다.
이번 글에서는 구글 앱 스크립트의 필수인 SpreadSheetApp의 기능을 정리해보려고 합니다.
혹시 지난 포스팅을 못 보신 분들은 아래 링크를 클릭해 주세요.
2. 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 | 지정된 셀을 활성 셀로 설정합니다. |
3. 마무리
구글 앱 스크립트의 SpreadSheetApp의 기능을 정리해 보았습니다.
create나 getActiveSheet, openById 같은 경우 자주 쓰는 기능이고 제 이전 포스팅들에서도 보시면 자주 쓰이고 있다는 걸 보실 수 있을 겁니다.
다음 포스팅은 구글 앱 스크립트의 Spreadsheet 클래스에 관해 기능 정리를 하겠습니다.
다음 글 보러 가기:
답글 남기기