이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class Spreadsheet

Google Sheets 파일에 액세스하고 파일을 수정합니다. 일반적인 작업은 새 시트 추가 및 있습니다.

메서드

메서드	반환 유형	간략한 설명
`addDeveloperMetadata(key)`	`Spreadsheet`	지정된 키를 가진 개발자 메타데이터를 최상위 스프레드시트에 추가합니다.
`addDeveloperMetadata(key, visibility)`	`Spreadsheet`	지정된 키와 공개 상태가 포함된 개발자 메타데이터를 스프레드시트에 추가합니다.
`addDeveloperMetadata(key, value)`	`Spreadsheet`	지정된 키와 값이 포함된 개발자 메타데이터를 스프레드시트에 추가합니다.
`addDeveloperMetadata(key, value, visibility)`	`Spreadsheet`	지정된 키, 값, 공개 상태가 포함된 개발자 메타데이터를 스프레드시트에 추가합니다.
`addEditor(emailAddress)`	`Spreadsheet`	지정된 사용자를 `Spreadsheet`의 편집자 목록에 추가합니다.
`addEditor(user)`	`Spreadsheet`	지정된 사용자를 `Spreadsheet`의 편집자 목록에 추가합니다.
`addEditors(emailAddresses)`	`Spreadsheet`	지정된 사용자 배열을 `Spreadsheet`의 편집자 목록에 추가합니다.
`addMenu(name, subMenus)`	`void`	스프레드시트 UI에 새 메뉴를 만듭니다.
`addViewer(emailAddress)`	`Spreadsheet`	지정된 사용자를 `Spreadsheet`의 뷰어 목록에 추가합니다.
`addViewer(user)`	`Spreadsheet`	지정된 사용자를 `Spreadsheet`의 뷰어 목록에 추가합니다.
`addViewers(emailAddresses)`	`Spreadsheet`	지정된 사용자 배열을 `Spreadsheet`의 뷰어 목록에 추가합니다.
`appendRow(rowContents)`	`Sheet`	시트의 현재 데이터 영역 하단에 행을 추가합니다.
`autoResizeColumn(columnPosition)`	`Sheet`	지정된 열의 너비를 콘텐츠에 맞게 설정합니다.
`copy(name)`	`Spreadsheet`	스프레드시트를 복사하고 새 스프레드시트를 반환합니다.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	범위 내에서 개발자 메타데이터를 찾기 위해 `DeveloperMetadataFinder`를 반환합니다. 이 스프레드시트에 나와 있습니다.
`createTextFinder(findText)`	`TextFinder`	스프레드시트용 텍스트 검색기를 만들어 내부에서 텍스트를 찾고 바꾸는 데 사용할 수 있습니다. 있습니다.
`deleteActiveSheet()`	`Sheet`	현재 활성 시트를 삭제합니다.
`deleteColumn(columnPosition)`	`Sheet`	지정된 열 위치에서 열을 삭제합니다.
`deleteColumns(columnPosition, howMany)`	`void`	지정된 열 위치에서 시작하는 여러 열을 삭제합니다.
`deleteRow(rowPosition)`	`Sheet`	지정된 행 위치에서 행을 삭제합니다.
`deleteRows(rowPosition, howMany)`	`void`	지정된 행 위치에서 시작하는 여러 행을 삭제합니다.
`deleteSheet(sheet)`	`void`	지정된 시트를 삭제합니다.
`duplicateActiveSheet()`	`Sheet`	활성 시트를 복제하여 활성 시트로 만듭니다.
`getActiveCell()`	`Range`	이 시트의 활성 셀을 반환합니다.
`getActiveRange()`	`Range`	활성 시트에서 선택된 범위를 반환하거나 활성 범위가 없는 경우 `null`를 반환합니다.
`getActiveRangeList()`	`RangeList`	활성 시트의 활성 범위 목록을 반환하거나 활성 범위가 없는 경우 `null`를 반환합니다. 확인할 수 있습니다
`getActiveSheet()`	`Sheet`	스프레드시트의 활성 시트를 가져옵니다.
`getAs(contentType)`	`Blob`	이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다.
`getBandings()`	`Banding[]`	이 스프레드시트의 모든 밴딩을 반환합니다.
`getBlob()`	`Blob`	이 객체 내의 데이터를 blob으로 반환합니다.
`getColumnWidth(columnPosition)`	`Integer`	지정된 열의 너비(픽셀 단위)를 가져옵니다.
`getCurrentCell()`	`Range`	활성 시트의 현재 셀을 반환하거나 현재 셀이 없는 경우 `null`를 반환합니다.
`getDataRange()`	`Range`	데이터가 있는 측정기준에 해당하는 `Range`를 반환합니다.
`getDataSourceFormulas()`	`DataSourceFormula[]`	모든 데이터 소스 수식을 가져옵니다.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	모든 데이터 소스 피벗 테이블을 가져옵니다.
`getDataSourceRefreshSchedules()`	`DataSourceRefreshSchedule[]`	이 스프레드시트의 새로고침 일정을 가져옵니다.
`getDataSourceSheets()`	`DataSourceSheet[]`	스프레드시트의 모든 데이터 소스 시트를 반환합니다.
`getDataSourceTables()`	`DataSourceTable[]`	모든 데이터 소스 테이블을 가져옵니다.
`getDataSources()`	`DataSource[]`	스프레드시트의 모든 데이터 소스를 반환합니다.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	최상위 스프레드시트와 연결된 개발자 메타데이터를 가져옵니다.
`getEditors()`	`User[]`	이 `Spreadsheet`의 편집자 목록을 가져옵니다.
`getFormUrl()`	`String`	이 스프레드시트로 응답을 전송하는 양식의 URL을 반환하거나, 다음인 경우 `null`를 반환합니다. 이 스프레드시트에는 연결된 양식이 없습니다.
`getFrozenColumns()`	`Integer`	고정된 열의 수를 반환합니다.
`getFrozenRows()`	`Integer`	고정된 행 수를 반환합니다.
`getId()`	`String`	이 스프레드시트의 고유 식별자를 가져옵니다.
`getImages()`	`OverGridImage[]`	시트의 모든 그리드 이미지를 반환합니다.
`getIterativeCalculationConvergenceThreshold()`	`Number`	반복 계산 중에 사용된 임곗값을 반환합니다.
`getLastColumn()`	`Integer`	콘텐츠가 있는 마지막 열의 위치를 반환합니다.
`getLastRow()`	`Integer`	콘텐츠가 있는 마지막 행의 위치를 반환합니다.
`getMaxIterativeCalculationCycles()`	`Integer`	반복 계산 중에 사용할 최대 반복 횟수를 반환합니다.
`getName()`	`String`	문서의 이름을 가져옵니다.
`getNamedRanges()`	`NamedRange[]`	이 스프레드시트에서 이름이 지정된 모든 범위를 가져옵니다.
`getNumSheets()`	`Integer`	이 스프레드시트의 시트 수를 반환합니다.
`getOwner()`	`User`	문서의 소유자를 반환하거나, 공유 드라이브에 있는 문서의 경우 `null`를 반환합니다.
`getPredefinedSpreadsheetThemes()`	`SpreadsheetTheme[]`	사전 정의된 테마 목록을 반환합니다.
`getProtections(type)`	`Protection[]`	스프레드시트의 모든 보호된 범위 또는 시트를 나타내는 객체의 배열을 가져옵니다.
`getRange(a1Notation)`	`Range`	A1 표기법 또는 R1C1 표기법으로 지정된 범위를 반환합니다.
`getRangeByName(name)`	`Range`	이름이 지정된 범위, 또는 지정된 이름의 범위를 찾을 수 없는 경우 `null`를 반환합니다.
`getRangeList(a1Notations)`	`RangeList`	지정된 동일한 시트의 범위를 나타내는 `RangeList` 컬렉션을 반환합니다. A1 표기법 또는 R1C1 표기법의 비어 있지 않은 목록으로 계산됩니다.
`getRecalculationInterval()`	`RecalculationInterval`	이 스프레드시트의 계산 간격을 반환합니다.
`getRowHeight(rowPosition)`	`Integer`	지정된 행의 높이를 픽셀 단위로 가져옵니다.
`getSelection()`	`Selection`	스프레드시트의 현재 `Selection`를 반환합니다.
`getSheetByName(name)`	`Sheet`	지정된 이름의 시트를 반환합니다.
`getSheetId()`	`Integer`	이 객체가 나타내는 시트의 ID를 반환합니다.
`getSheetName()`	`String`	시트 이름을 반환합니다.
`getSheetValues(startRow, startColumn, numRows, numColumns)`	`Object[][]`	지정된 좌표에서 시작하여 이 범위에 해당하는 값의 직사각형 그리드를 반환합니다.
`getSheets()`	`Sheet[]`	이 스프레드시트의 모든 시트를 가져옵니다.
`getSpreadsheetLocale()`	`String`	스프레드시트 언어를 가져옵니다.
`getSpreadsheetTheme()`	`SpreadsheetTheme`	스프레드시트의 현재 테마를 반환하거나, 테마가 적용되지 않은 경우 `null`를 반환합니다.
`getSpreadsheetTimeZone()`	`String`	스프레드시트의 시간대를 가져옵니다.
`getUrl()`	`String`	지정된 스프레드시트의 URL을 반환합니다.
`getViewers()`	`User[]`	이 `Spreadsheet`의 뷰어 및 댓글 작성자 목록을 가져옵니다.
`hideColumn(column)`	`void`	지정된 범위의 열을 숨깁니다.
`hideRow(row)`	`void`	지정된 범위의 행을 숨깁니다.
`insertColumnAfter(afterPosition)`	`Sheet`	지정된 열 위치 뒤에 열을 삽입합니다.
`insertColumnBefore(beforePosition)`	`Sheet`	지정된 열 위치 앞에 열을 삽입합니다.
`insertColumnsAfter(afterPosition, howMany)`	`Sheet`	지정된 열 위치 뒤에 지정된 수의 열을 삽입합니다.
`insertColumnsBefore(beforePosition, howMany)`	`Sheet`	지정된 열 위치 앞에 여러 열을 삽입합니다.
`insertDataSourceSheet(spec)`	`DataSourceSheet`	스프레드시트에 새 `DataSourceSheet`를 삽입하고 데이터 실행을 시작합니다.
`insertImage(blobSource, column, row)`	`OverGridImage`	문서의 지정된 행과 열에 `Spreadsheet`를 이미지로 삽입합니다.
`insertImage(blobSource, column, row, offsetX, offsetY)`	`OverGridImage`	문서의 지정된 행과 열에 `Spreadsheet`을 픽셀 오프셋입니다.
`insertImage(url, column, row)`	`OverGridImage`	문서의 지정된 행과 열에 이미지를 삽입합니다.
`insertImage(url, column, row, offsetX, offsetY)`	`OverGridImage`	문서의 지정된 행과 열에 픽셀 오프셋을 사용하여 이미지를 삽입합니다.
`insertRowAfter(afterPosition)`	`Sheet`	지정된 행 위치 뒤에 행을 삽입합니다.
`insertRowBefore(beforePosition)`	`Sheet`	지정된 행 위치 앞에 행을 삽입합니다.
`insertRowsAfter(afterPosition, howMany)`	`Sheet`	지정된 행 위치 뒤에 여러 행을 삽입합니다.
`insertRowsBefore(beforePosition, howMany)`	`Sheet`	지정된 행 위치 앞에 여러 행을 삽입합니다.
`insertSheet()`	`Sheet`	기본 시트 이름을 사용하여 스프레드시트에 새 시트를 삽입합니다.
`insertSheet(sheetIndex)`	`Sheet`	지정된 색인의 스프레드시트에 새 시트를 삽입합니다.
`insertSheet(sheetIndex, options)`	`Sheet`	지정된 색인의 스프레드시트에 새 시트를 삽입하고 선택적 고급을 사용합니다. 인수입니다.
`insertSheet(options)`	`Sheet`	기본 시트 이름 및 고급 옵션(선택사항)을 사용하여 스프레드시트에 새 시트를 삽입합니다. 인수입니다.
`insertSheet(sheetName)`	`Sheet`	스프레드시트에 지정된 이름의 새 시트를 삽입합니다.
`insertSheet(sheetName, sheetIndex)`	`Sheet`	지정된 색인에 지정된 이름의 스프레드시트에 새 시트를 삽입합니다.
`insertSheet(sheetName, sheetIndex, options)`	`Sheet`	주어진 색인에서 지정된 이름의 스프레드시트에 새 시트를 삽입하고 고급 인수(선택사항)
`insertSheet(sheetName, options)`	`Sheet`	지정된 이름으로 스프레드시트에 새 시트를 삽입하고 선택적 고급 옵션을 사용합니다. 인수입니다.
`insertSheetWithDataSourceTable(spec)`	`Sheet`	스프레드시트에 새 시트를 삽입하고 범위에 걸쳐 `DataSourceTable`을 만듭니다. 전체 시트에 액세스하고, 데이터 실행을 시작합니다.
`isColumnHiddenByUser(columnPosition)`	`Boolean`	지정된 열을 사용자가 숨겼는지 여부를 반환합니다.
`isIterativeCalculationEnabled()`	`Boolean`	이 스프레드시트에서 반복 계산이 활성화되었는지 여부를 반환합니다.
`isRowHiddenByFilter(rowPosition)`	`Boolean`	지정된 행이 필터 보기가 아닌 필터에 의해 숨겨졌는지 여부를 반환합니다.
`isRowHiddenByUser(rowPosition)`	`Boolean`	지정된 행을 사용자가 숨겼는지 여부를 반환합니다.
`moveActiveSheet(pos)`	`void`	활성 시트를 시트 목록의 지정된 위치로 이동합니다.
`moveChartToObjectSheet(chart)`	`Sheet`	새 `SheetType.OBJECT` 시트를 만들고 제공된 차트를 이 시트로 이동합니다.
`refreshAllDataSources()`	`void`	지원되는 모든 데이터 소스 및 연결된 데이터 소스 객체를 새로고침하고 잘못된 항목을 건너뜁니다. 데이터 소스 객체입니다.
`removeEditor(emailAddress)`	`Spreadsheet`	`Spreadsheet`의 편집자 목록에서 지정된 사용자를 삭제합니다.
`removeEditor(user)`	`Spreadsheet`	`Spreadsheet`의 편집자 목록에서 지정된 사용자를 삭제합니다.
`removeMenu(name)`	`void`	`addMenu(name, subMenus)`가 추가한 메뉴를 삭제합니다.
`removeNamedRange(name)`	`void`	지정된 이름의 이름이 지정된 범위를 삭제합니다.
`removeViewer(emailAddress)`	`Spreadsheet`	`Spreadsheet`의 뷰어 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다.
`removeViewer(user)`	`Spreadsheet`	`Spreadsheet`의 뷰어 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다.
`rename(newName)`	`void`	문서 이름을 변경합니다.
`renameActiveSheet(newName)`	`void`	현재 활성 시트의 이름을 지정된 새 이름으로 바꿉니다.
`resetSpreadsheetTheme()`	`SpreadsheetTheme`	적용된 테마를 삭제하고 스프레드시트의 기본 테마를 설정합니다.
`setActiveRange(range)`	`Range`	지정된 범위를 활성 시트의 `active range`로 설정 범위의 왼쪽 상단 셀을 `current cell`로 설정합니다.
`setActiveRangeList(rangeList)`	`RangeList`	지정된 범위 목록을`active ranges` 있습니다.
`setActiveSelection(range)`	`Range`	이 시트의 활성 선택 영역을 설정합니다.
`setActiveSelection(a1Notation)`	`Range`	A1 표기법 또는 R1C1 표기법에 지정된 대로 활성 선택을 설정합니다.
`setActiveSheet(sheet)`	`Sheet`	지정된 시트를 스프레드시트의 활성 시트로 설정합니다.
`setActiveSheet(sheet, restoreSelection)`	`Sheet`	지정한 시트를 스프레드시트의 활성 시트로 설정하며, 이때 할 수 있습니다.
`setColumnWidth(columnPosition, width)`	`Sheet`	지정된 열의 너비를 픽셀 단위로 설정합니다.
`setCurrentCell(cell)`	`Range`	지정된 셀을 `current cell`로 설정합니다.
`setFrozenColumns(columns)`	`void`	지정된 수의 열을 고정합니다.
`setFrozenRows(rows)`	`void`	지정된 수의 행을 고정합니다.
`setIterativeCalculationConvergenceThreshold(minThreshold)`	`Spreadsheet`	반복 계산을 위한 최소 임곗값을 설정합니다.
`setIterativeCalculationEnabled(isEnabled)`	`Spreadsheet`	이 스프레드시트에서 반복 계산을 활성화할지 여부를 설정합니다.
`setMaxIterativeCalculationCycles(maxIterations)`	`Spreadsheet`	반복 중에 수행해야 하는 계산 반복의 최대 횟수를 설정합니다. 계산할 수도 있습니다.
`setNamedRange(name, range)`	`void`	범위의 이름을 지정합니다.
`setRecalculationInterval(recalculationInterval)`	`Spreadsheet`	스프레드시트를 다시 계산하는 빈도를 설정합니다.
`setRowHeight(rowPosition, height)`	`Sheet`	지정된 행의 행 높이를 픽셀 단위로 설정합니다.
`setSpreadsheetLocale(locale)`	`void`	스프레드시트의 언어를 설정합니다.
`setSpreadsheetTheme(theme)`	`SpreadsheetTheme`	스프레드시트에 테마를 설정합니다.
`setSpreadsheetTimeZone(timezone)`	`void`	스프레드시트의 시간대를 설정합니다.
`show(userInterface)`	`void`	사용자의 브라우저 중앙에 표시되는 대화상자에 맞춤 사용자 인터페이스 구성요소를 표시합니다. 표시 영역입니다.
`sort(columnPosition)`	`Sheet`	열을 기준으로 시트를 오름차순으로 정렬합니다.
`sort(columnPosition, ascending)`	`Sheet`	열을 기준으로 시트를 정렬합니다.
`toast(msg)`	`void`	특정 메시지와 함께 스프레드시트의 오른쪽 하단에 팝업 창을 표시합니다.
`toast(msg, title)`	`void`	스프레드시트의 오른쪽 하단에 특정 메시지와 함께 팝업 창을 표시합니다. 있습니다.
`toast(msg, title, timeoutSeconds)`	`void`	스프레드시트의 오른쪽 하단에 주어진 제목과 제목, 특정 시간 동안 계속 표시됩니다.
`unhideColumn(column)`	`void`	지정된 범위의 열 숨기기를 해제합니다.
`unhideRow(row)`	`void`	지정된 범위의 행 숨기기를 해제합니다.
`updateMenu(name, subMenus)`	`void`	`addMenu(name, subMenus)`에서 추가한 메뉴를 업데이트합니다.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	스프레드시트의 모든 현재 실행이 완료될 때까지 대기하고, 제공된 초 수입니다.

지원 중단된 메서드

메서드	반환 유형	간략한 설명
`getSheetProtection()`	`PageProtection`	현재 시트의 권한을 설명하는 `PageProtection` 인스턴스를 반환합니다.
`isAnonymousView()`	`Boolean`	문서의 익명 보기 허용 여부를 나타냅니다.
`isAnonymousWrite()`	`Boolean`	문서에서 익명 사용자의 수정을 허용하는지 여부를 나타냅니다.
`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`	`void`	익명 읽기 및 쓰기에 대한 문서의 정책을 설정합니다.
`setSheetProtection(permissions)`	`void`	현재 시트의 권한을 설정합니다.

자세한 문서

`addDeveloperMetadata(key)`

지정된 키를 가진 개발자 메타데이터를 최상위 스프레드시트에 추가합니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds the key 'NAME' in the developer metadata for the spreadsheet.
ss.addDeveloperMetadata('NAME')

// Gets the first developer metadata object and logs its key.
const developerMetaData = ss.getDeveloperMetadata()[0]
console.log(developerMetaData.getKey())

매개변수

이름	유형	설명
`key`	`String`	새 개발자 메타데이터의 키입니다.

리턴

Spreadsheet - 이 스프레드시트는 연결용입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, visibility)`

지정된 키와 공개 상태가 포함된 개발자 메타데이터를 스프레드시트에 추가합니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds the key 'NAME' in the developer metadata for the spreadsheet and sets the visibility
// to the developer project that created the metadata.
ss.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

// Gets the first developer metadata object and logs its key and visibility setting.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(`Key: ${developerMetaData.getKey()},
.             Visibility: ${developerMetaData.getVisibility()}`);

매개변수

이름	유형	설명
`key`	`String`	새 개발자 메타데이터의 키입니다.
`visibility`	`DeveloperMetadataVisibility`	새 개발자 메타데이터의 공개 상태입니다.

리턴

Spreadsheet - 이 스프레드시트는 연결용입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, value)`

지정된 키와 값이 포함된 개발자 메타데이터를 스프레드시트에 추가합니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds the key 'NAME' and sets the value to 'GOOGLE' in the developer metadata for the
// spreadsheet.
ss.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the first developer metadata object and logs its key and value.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}`);

매개변수

이름	유형	설명
`key`	`String`	새 개발자 메타데이터의 키입니다.
`value`	`String`	새 개발자 메타데이터의 값입니다.

리턴

Spreadsheet - 이 스프레드시트는 연결용입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, value, visibility)`

지정된 키, 값, 공개 상태가 포함된 개발자 메타데이터를 스프레드시트에 추가합니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to any developer project with document access.
ss.addDeveloperMetadata('NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

// Gets the first developer metadata object and logs its key, value, and visibility setting.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(`Key: ${developerMetaData.getKey()},
             Value: ${developerMetaData.getValue()},
             Visibility: ${developerMetaData.getVisibility()}`);

매개변수

이름	유형	설명
`key`	`String`	새 개발자 메타데이터의 키입니다.
`value`	`String`	새 개발자 메타데이터의 값입니다.
`visibility`	`DeveloperMetadataVisibility`	새 개발자 메타데이터의 공개 상태입니다.

리턴

Spreadsheet - 이 스프레드시트는 연결용입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addEditor(emailAddress)`

지정된 사용자를 Spreadsheet의 편집자 목록에 추가합니다. 사용자가 이미 를 지정하면 뷰어 목록에서 사용자를 벗어나게 됩니다.

매개변수

이름	유형	설명
`emailAddress`	`String`	추가할 사용자의 이메일 주소입니다.

리턴

Spreadsheet: 이 Spreadsheet는 체이닝을 위한 것입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addEditor(user)`

지정된 사용자를 Spreadsheet의 편집자 목록에 추가합니다. 사용자가 이미 를 지정하면 뷰어 목록에서 사용자를 벗어나게 됩니다.

매개변수

이름	유형	설명
`user`	`User`	추가할 사용자의 표현입니다.

리턴

Spreadsheet: 이 Spreadsheet는 체이닝을 위한 것입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addEditors(emailAddresses)`

지정된 사용자 배열을 Spreadsheet의 편집자 목록에 추가합니다. 만약 사용자가 이미 뷰어 목록에 있는 경우 이 방법을 사용하면 시청자

매개변수

이름	유형	설명
`emailAddresses`	`String[]`	추가할 사용자의 이메일 주소 배열입니다.

리턴

Spreadsheet: 이 Spreadsheet는 체이닝을 위한 것입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addMenu(name, subMenus)`

스프레드시트 UI에 새 메뉴를 만듭니다.

각 메뉴 항목은 사용자 정의 함수를 실행합니다. 일반적으로 스프레드시트가 로드될 때 메뉴가 자동으로 생성되도록 onOpen() 함수에서 호출하려고 합니다.

// The onOpen function is executed automatically every time a Spreadsheet is loaded
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var menuEntries = [];
  // When the user clicks on "addMenuExample" then "Menu Entry 1", the function function1 is
  // executed.
  menuEntries.push({name: "Menu Entry 1", functionName: "function1"});
  menuEntries.push(null); // line separator
  menuEntries.push({name: "Menu Entry 2", functionName: "function2"});

  ss.addMenu("addMenuExample", menuEntries);
}

매개변수

이름	유형	설명
`name`	`String`	생성할 메뉴의 이름입니다.
`subMenus`	`Object[]`	`name` 및 `functionName` 매개변수가 있는 JavaScript 지도의 배열. 포함된 라이브러리의 함수(예: `Library.libFunction1`)를 사용할 수 있습니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addViewer(emailAddress)`

지정된 사용자를 Spreadsheet의 뷰어 목록에 추가합니다. 사용자가 이미 이 메서드는 효과가 없습니다.

매개변수

이름	유형	설명
`emailAddress`	`String`	추가할 사용자의 이메일 주소입니다.

리턴

Spreadsheet: 이 Spreadsheet는 체이닝을 위한 것입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addViewer(user)`

지정된 사용자를 Spreadsheet의 뷰어 목록에 추가합니다. 사용자가 이미 이 메서드는 효과가 없습니다.

매개변수

이름	유형	설명
`user`	`User`	추가할 사용자의 표현입니다.

리턴

Spreadsheet: 이 Spreadsheet는 체이닝을 위한 것입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addViewers(emailAddresses)`

지정된 사용자 배열을 Spreadsheet의 뷰어 목록에 추가합니다. 만약 사용자가 이미 편집자 목록에 있으면 이 방법은 아무런 영향을 미치지 않습니다.

매개변수

이름	유형	설명
`emailAddresses`	`String[]`	추가할 사용자의 이메일 주소 배열입니다.

리턴

Spreadsheet: 이 Spreadsheet는 체이닝을 위한 것입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`appendRow(rowContents)`

시트의 현재 데이터 영역 하단에 행을 추가합니다. 셀의 내용이 =이면 수식으로 해석됩니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Appends a new row with 3 columns to the bottom of the current
// data region in the sheet containing the values in the array.
sheet.appendRow(["a man", "a plan", "panama"]);

매개변수

이름	유형	설명
`rowContents`	`Object[]`	시트의 마지막 행 뒤에 삽입할 값의 배열.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`autoResizeColumn(columnPosition)`

지정된 열의 너비를 콘텐츠에 맞게 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...');

// Sets the first column to a width which fits the text
sheet.autoResizeColumn(1);

매개변수

이름	유형	설명
`columnPosition`	`Integer`	크기를 조절할 지정된 열의 위치입니다.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copy(name)`

스프레드시트를 복사하고 새 스프레드시트를 반환합니다.

// This code makes a copy of the current spreadsheet and names it appropriately
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.copy("Copy of " + ss.getName());

매개변수

이름	유형	설명
`name`	`String`	사본의 이름입니다.

리턴

Spreadsheet - 이 스프레드시트는 연결용입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createDeveloperMetadataFinder()`

범위 내에서 개발자 메타데이터를 찾기 위해 DeveloperMetadataFinder를 반환합니다. 이 스프레드시트에 나와 있습니다. 기본적으로 스프레드시트와 연결된 모든 메타데이터를 고려하며 행, 열입니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds developer metadata to the spreadsheet.
ss.addDeveloperMetadata('NAME', 'CHARLIE');
ss.addDeveloperMetadata('COMPANY', 'EXAMPLE ORGANIZATION');
ss.addDeveloperMetadata('TECHNOLOGY', 'JAVASCRIPT');

// Creates a developer metadata finder.
const developerMetadataFinder = ss.createDeveloperMetadataFinder();

// Finds the developer metadata objects with 'COMPANY' as the key.
const googleMetadataFromSpreadsheet = developerMetadataFinder.withKey('COMPANY').find();

// Gets the first result of developer metadata that has the key 'COMPANY' and logs its value.
console.log(googleMetadataFromSpreadsheet[0].getValue());

리턴

DeveloperMetadataFinder - 이 스프레드시트의 범위에서 메타데이터를 검색하기 위한 개발자 메타데이터 파인더입니다.

`createTextFinder(findText)`

스프레드시트용 텍스트 검색기를 만들어 내부에서 텍스트를 찾고 바꾸는 데 사용할 수 있습니다. 있습니다. 스프레드시트의 첫 번째 시트에서 검색이 시작됩니다.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

// Creates  a text finder.
var textFinder = spreadsheet.createTextFinder('dog');

// Returns the first occurrence of 'dog' in the spreadsheet.
var firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
var numOccurrencesReplaced = findOccurrence.replaceWith('cat');

매개변수

이름	유형	설명
`findText`	`String`	검색할 텍스트입니다.

리턴

TextFinder - 스프레드시트의 TextFinder입니다.

`deleteActiveSheet()`

현재 활성 시트를 삭제합니다.

// The code below deletes the currently active sheet and stores the new active sheet in a
// variable
var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();

리턴

Sheet - 새 활성 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteColumn(columnPosition)`

지정된 열 위치에서 열을 삭제합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first column
sheet.deleteColumn(1);

매개변수

이름	유형	설명
`columnPosition`	`Integer`	열의 위치로, 첫 번째 열의 경우 1부터 시작합니다.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteColumns(columnPosition, howMany)`

지정된 열 위치에서 시작하는 여러 열을 삭제합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first two columns
sheet.deleteColumns(1, 2);

매개변수

이름	유형	설명
`columnPosition`	`Integer`	삭제할 첫 번째 열의 위치입니다.
`howMany`	`Integer`	삭제할 열의 수입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteRow(rowPosition)`

지정된 행 위치에서 행을 삭제합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first row
sheet.deleteRow(1);

매개변수

이름	유형	설명
`rowPosition`	`Integer`	행의 위치로, 첫 번째 행의 경우 1부터 시작합니다.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteRows(rowPosition, howMany)`

지정된 행 위치에서 시작하는 여러 행을 삭제합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first two rows
sheet.deleteRows(1, 2);

매개변수

이름	유형	설명
`rowPosition`	`Integer`	삭제할 첫 번째 행의 위치입니다.
`howMany`	`Integer`	삭제할 행 수입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteSheet(sheet)`

지정된 시트를 삭제합니다.

// The code below deletes the specified sheet.
var ss = SpreadsheetApp.getActive();
var sheet = ss.getSheetByName('My Sheet');
ss.deleteSheet(sheet);

매개변수

이름	유형	설명
`sheet`	`Sheet`	삭제할 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`duplicateActiveSheet()`

활성 시트를 복제하여 활성 시트로 만듭니다.

// The code below makes a duplicate of the active sheet
SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();

리턴

Sheet - 새 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getActiveCell()`

이 시트의 활성 셀을 반환합니다.

참고: 현재 값을 반환하는 getCurrentCell()를 사용하는 것이 좋습니다. 강조표시됩니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Returns the active cell
var cell = sheet.getActiveCell();

리턴

Range: 현재 활성 셀

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getActiveRange()`

활성 시트에서 선택된 범위를 반환하거나 활성 범위가 없는 경우 null를 반환합니다. 만약 여러 범위를 선택하면 마지막으로 선택한 범위만 반환됩니다.

'활성 범위'라는 용어 는 사용자가 활성 시트에서 선택한 범위를 나타냅니다. 그러나 사용자 지정 함수에서는 다시 계산되는 셀을 참조합니다.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var activeRange = sheet.getActiveRange();

리턴

Range: 활성 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

참고 항목

setActiveRange(range)

`getActiveRangeList()`

활성 시트의 활성 범위 목록을 반환하거나 활성 범위가 없는 경우 null를 반환합니다. 확인할 수 있습니다

단일 범위를 선택하면 getActiveRange() 호출처럼 작동합니다.

var sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
var activeRangeList = sheet.getActiveRangeList();

리턴

RangeList - 활성 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

참고 항목

setActiveRangeList(rangeList)

`getActiveSheet()`

스프레드시트의 활성 시트를 가져옵니다.

스프레드시트의 활성 시트는 스프레드시트에 표시되고 있는 시트입니다. 있습니다.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();

리턴

Sheet - 스프레드시트의 활성 시트입니다.

`getAs(contentType)`

이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. 이 메서드는 파일 이름에 적절한 확장자를 추가합니다(예: 'myfile.pdf'). 하지만 파일 이름에서 마지막 마침표 뒤에 오는 부분 (있는 경우)이 기존 교체해야 합니다. 따라서 'ShoppingList.12.25.2014' 위 이름이 아래와 같이 변경됩니다. 'ShoppingList.12.25.pdf'

전환수의 일일 할당량을 보려면 Google '서비스'로 이동합니다. 새로 생성된 Google Workspace 도메인에는 일시적으로 더 엄격한 정책이 적용될 수 있습니다. 할당량도 제공합니다

매개변수

이름	유형	설명
`contentType`	`String`	변환할 MIME 유형입니다. 대부분의 blob에서 `'application/pdf'`는 다음과 같습니다. 유일하게 유효한 옵션입니다. BMP, GIF, JPEG, PNG 형식의 이미지인 경우 `'image/bmp'`, `'image/gif'`, `'image/jpeg'`, `'image/png'` 중 어느 것이든 해당됩니다. 유효한지 확인합니다. Google Docs 문서의 경우 `'text/markdown'`도 유효합니다.

리턴

Blob - blob 형식의 데이터입니다.

`getBandings()`

이 스프레드시트의 모든 밴딩을 반환합니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets an array of the bandings in the spreadsheet.
const bandings = ss.getBandings();

// Logs the range of the first banding in the spreadsheet to the console.
console.log(bandings[0].getRange().getA1Notation());

리턴

Banding[] - 이 스프레드시트의 밴딩입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getBlob()`

이 객체 내의 데이터를 blob으로 반환합니다.

리턴

Blob - blob 형식의 데이터입니다.

`getColumnWidth(columnPosition)`

지정된 열의 너비(픽셀 단위)를 가져옵니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Columns start at 1
Logger.log(sheet.getColumnWidth(1));

매개변수

이름	유형	설명
`columnPosition`	`Integer`	검토할 열의 위치입니다.

리턴

Integer — 열 너비(픽셀)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getCurrentCell()`

활성 시트의 현재 셀을 반환하거나 현재 셀이 없는 경우 null를 반환합니다. 이 현재 셀은 Google Sheets UI에서 포커스가 있으며 어두운 색으로 강조 표시된 셀입니다. 테두리를 추가하는 것입니다. 현재 셀은 두 개 이상 없습니다. 사용자가 하나 이상의 셀 범위를 선택하면 현재 셀입니다.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
// Returns the current highlighted cell in the one of the active ranges.
var currentCell = sheet.getCurrentCell();

리턴

Range — 현재 셀

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataRange()`

데이터가 있는 측정기준에 해당하는 Range를 반환합니다.

이는 A1로 제한된 범위를 만드는 것과 기능적으로 동일하고 (Sheet.getLastColumn(), Sheet.getLastRow()).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This represents ALL the data
var range = sheet.getDataRange();
var values = range.getValues();

// This logs the spreadsheet in CSV format with a trailing comma
for (var i = 0; i < values.length; i++) {
  var row = "";
  for (var j = 0; j < values[i].length; j++) {
    if (values[i][j]) {
      row = row + values[i][j];
    }
    row = row + ",";
  }
  Logger.log(row);
}

리턴

Range: 스프레드시트의 모든 데이터로 구성된 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceFormulas()`

모든 데이터 소스 수식을 가져옵니다.

// Opens the spreadsheet by its ID. If you created your script from within a Google Sheets
// file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of the data source formulas on Sheet1.
// To get an array of data source formulas for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceFormulas = sheet.getDataSourceFormulas();

// Logs the first data source formula in the array.
console.log(dataSourceFormulas[0].getFormula());

리턴

DataSourceFormula[] - 데이터 소스 수식의 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourcePivotTables()`

모든 데이터 소스 피벗 테이블을 가져옵니다.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of the data source pivot tables on Sheet1.
// To get an array of data source pivot tables for the entire
// spreadsheet, replace 'sheet' with 'ss'.
const dataSourcePivotTables = sheet.getDataSourcePivotTables();

// Logs the last time that the first pivot table in the array was refreshed.
console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());

리턴

DataSourcePivotTable[] - 데이터 소스 피벗 테이블의 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceRefreshSchedules()`

이 스프레드시트의 새로고침 일정을 가져옵니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Activates BigQuery operations for the connected spreadsheet.
SpreadsheetApp.enableBigQueryExecution();

// Gets the frequency type of the first referesh schedule in the array.
const frequencyType = ss.getDataSourceRefreshSchedules()[0]
                        .getFrequency()
                        .getFrequencyType()
                        .toString();

// Logs the frequency type to the console.
console.log(frequencyType);

리턴

DataSourceRefreshSchedule[] - 이 스프레드시트의 새로고침 일정입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceSheets()`

스프레드시트의 모든 데이터 소스 시트를 반환합니다.

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the first data source sheet in the spreadsheet.
const dataSource = ss.getDataSourceSheets()[0];

// Gets the name of the data source sheet.
console.log(dataSource.asSheet().getName());

리턴

DataSourceSheet[] - 모든 데이터 소스 시트의 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceTables()`

모든 데이터 소스 테이블을 가져옵니다.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of data source tables on Sheet1.
// To get an array of data source tables for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceTables = sheet.getDataSourceTables();

// Logs the last completed data execution time on the first data source table.
console.log(dataSourceTables[0].getStatus().getLastExecutionTime());

리턴

DataSourceTable[] - 데이터 소스 테이블 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSources()`

스프레드시트의 모든 데이터 소스를 반환합니다.

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the data sources on the spreadsheet.
const dataSources = ss.getDataSources();

// Logs the name of the first column on the first data source.
console.log(dataSources[0].getColumns()[0].getName());

리턴

DataSource[] - 모든 데이터 소스의 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDeveloperMetadata()`

최상위 스프레드시트와 연결된 개발자 메타데이터를 가져옵니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds 'Google' as a key to the spreadsheet metadata.
ss.addDeveloperMetadata('Google');

// Gets the spreadsheet's metadata.
const ssMetadata = ss.getDeveloperMetadata();

// Gets the first set of the spreadsheet's metadata and logs the key to the console.
console.log(ssMetadata[0].getKey());

리턴

DeveloperMetadata[] - 이 범위와 연결된 개발자 메타데이터입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getEditors()`

이 Spreadsheet의 편집자 목록을 가져옵니다.

리턴

User[] - 수정 권한이 있는 사용자의 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormUrl()`

이 스프레드시트로 응답을 전송하는 양식의 URL을 반환하거나, 다음인 경우 null를 반환합니다. 이 스프레드시트에는 연결된 양식이 없습니다. 여러 양식이 이 스프레드시트에 응답을 보내는 경우 반환된 양식 URL이 확실하지 않습니다. 또는 시트당 양식 URL 연결은 Sheet.getFormUrl() 메서드를 통해 가져올 수 있습니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the form URL from the spreadsheet.
const formUrl = ss.getFormUrl();

// Logs the form URL to the console.
console.log(formUrl);

리턴

String — 이 스프레드시트에 응답을 배치하는 양식의 URL 또는 null 이 스프레드시트에는 연결된 양식이 없습니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFrozenColumns()`

고정된 열의 수를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());

리턴

Integer: 고정된 열의 수

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFrozenRows()`

고정된 행 수를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());

리턴

Integer - 고정된 행 수

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getId()`

이 스프레드시트의 고유 식별자를 가져옵니다. URL에서 스프레드시트 ID를 추출할 수 있습니다. 예를 들어 URL의 스프레드시트 ID는 https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0에서 'abc1234567'로 지정합니다.

// The code below logs the ID for the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getId());

리턴

String - 스프레드시트의 고유 ID (또는 키)입니다.

`getImages()`

시트의 모든 그리드 이미지를 반환합니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the over-the-grid images from Sheet1.
// To get the over-the-grid images from the entire spreadsheet, use ss.getImages() instead.
const images = sheet.getImages();

// For each image, logs the anchor cell in A1 notation.
for (const image of images) {
 console.log(image.getAnchorCell().getA1Notation());
}

리턴

OverGridImage[] - 그리드 오버 이미지의 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getIterativeCalculationConvergenceThreshold()`

반복 계산 중에 사용된 임곗값을 반환합니다. 연속적인 계산의 차이가 이 값보다 작으면 반복 계산이 중지됩니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the iterative calculation convergence threshold for the spreadsheet.
ss.setIterativeCalculationConvergenceThreshold(2);

// Logs the threshold to the console.
console.log(ss.getIterativeCalculationConvergenceThreshold());

리턴

Number - 수렴 기준점입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getLastColumn()`

콘텐츠가 있는 마지막 열의 위치를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

리턴

Integer: 콘텐츠가 포함된 시트의 마지막 열

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getLastRow()`

콘텐츠가 있는 마지막 행의 위치를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

리턴

Integer: 콘텐츠가 포함된 시트의 마지막 행

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getMaxIterativeCalculationCycles()`

반복 계산 중에 사용할 최대 반복 횟수를 반환합니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the max iterative calculation cycles for the spreadsheet.
ss.setMaxIterativeCalculationCycles(10);

// Logs the max iterative calculation cycles to the console.
console.log(ss.getMaxIterativeCalculationCycles());

리턴

Integer - 계산 반복의 최대 횟수입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getName()`

문서의 이름을 가져옵니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getName());

리턴

String - 스프레드시트의 이름입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNamedRanges()`

이 스프레드시트에서 이름이 지정된 모든 범위를 가져옵니다.

// The code below logs the name of the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
  Logger.log(namedRanges[i].getName());
}

리턴

NamedRange[] - 스프레드시트에서 이름이 지정된 모든 범위의 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNumSheets()`

이 스프레드시트의 시트 수를 반환합니다.

// The code below logs the number of sheets in the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());

리턴

Integer - 스프레드시트의 시트 수입니다.

`getOwner()`

문서의 소유자를 반환하거나, 공유 드라이브에 있는 문서의 경우 null를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var owner = ss.getOwner();
Logger.log(owner.getEmail());

리턴

User — 문서 소유자 또는 문서가 공유 드라이브에 있는 경우 null

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getPredefinedSpreadsheetThemes()`

사전 정의된 테마 목록을 반환합니다.

// The code below returns the list of predefined themes.
var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet()
                               .getPredefinedSpreadsheetThemes();

리턴

SpreadsheetTheme[] - 사전 정의된 테마 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getProtections(type)`

스프레드시트의 모든 보호된 범위 또는 시트를 나타내는 객체의 배열을 가져옵니다.

// Remove all range protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

// Remove all sheet protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

매개변수

이름	유형	설명
`type`	`ProtectionType`	보호 구역의 유형(`SpreadsheetApp.ProtectionType.RANGE` 또는 `SpreadsheetApp.ProtectionType.SHEET`입니다.

리턴

Protection[] - 스프레드시트의 모든 보호된 범위 또는 시트를 나타내는 객체의 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRange(a1Notation)`

A1 표기법 또는 R1C1 표기법으로 지정된 범위를 반환합니다.

// Get a range A1:D4 on sheet titled "Invoices"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var range = ss.getRange("Invoices!A1:D4");

// Get cell A1 on the first sheet
var sheet = ss.getSheets()[0];
var cell = sheet.getRange("A1");

매개변수

이름	유형	설명
`a1Notation`	`String`	A1 표기법 또는 R1C1 표기법으로 지정된 반환할 범위입니다.

리턴

Range: 지정된 위치의 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRangeByName(name)`

이름이 지정된 범위, 또는 지정된 이름의 범위를 찾을 수 없는 경우 null를 반환합니다. 여러 개의 여러 개의 시트가 동일한 범위 이름을 사용하므로 따옴표(예: getRangeByName('TaxRates') 또는 getRangeByName('Sheet Name!TaxRates')는 사용할 수 있지만 getRangeByName('"Sheet Name"!TaxRates')는 사용할 수 없음)

// Log the number of columns for the range named 'TaxRates' in the active spreadsheet.
var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates');
if (range != null) {
  Logger.log(range.getNumColumns());
}

매개변수

이름	유형	설명
`name`	`String`	가져올 범위의 이름입니다.

리턴

Range - 지정된 이름을 가진 셀 범위입니다.

`getRangeList(a1Notations)`

지정된 동일한 시트의 범위를 나타내는 RangeList 컬렉션을 반환합니다. A1 표기법 또는 R1C1 표기법의 비어 있지 않은 목록으로 계산됩니다.

// Get a list of ranges A1:D4, F1:H4.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var rangeList  = sheet.getRangeList(['A1:D4', 'F1:H4']);

매개변수

이름	유형	설명
`a1Notations`	`String[]`	A1 표기법 또는 R1C1 표기법으로 지정된 반환할 범위 목록입니다.

리턴

RangeList: 지정된 위치의 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRecalculationInterval()`

이 스프레드시트의 계산 간격을 반환합니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Logs the calculation interval for the spreadsheet to the console.
console.log(ss.getRecalculationInterval().toString());

리턴

RecalculationInterval - 이 스프레드시트의 계산 간격입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRowHeight(rowPosition)`

지정된 행의 높이를 픽셀 단위로 가져옵니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Rows start at 1
Logger.log(sheet.getRowHeight(1));

매개변수

이름	유형	설명
`rowPosition`	`Integer`	검사할 행의 위치입니다.

리턴

Integer — 행 높이(픽셀)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSelection()`

스프레드시트의 현재 Selection를 반환합니다.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var currentCell = selection.getCurrentCell();

리턴

Selection: 현재 선택 항목

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheetByName(name)`

지정된 이름의 시트를 반환합니다.

여러 시트의 이름이 같으면 가장 왼쪽에 있는 시트가 반환됩니다. 다음과 같은 경우 null를 반환합니다. 지정된 이름의 시트가 없습니다.

// The code below logs the index of a sheet named "Expenses"
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Expenses");
if (sheet != null) {
  Logger.log(sheet.getIndex());
}

매개변수

이름	유형	설명
`name`	`String`	가져올 시트의 이름입니다.

리턴

Sheet - 지정된 이름의 시트입니다.

`getSheetId()`

이 객체가 나타내는 시트의 ID를 반환합니다.

스프레드시트별로 고유한 시트 ID입니다. ID는 시트 위치와 관계없는 시트 생성 시간에 할당되는 증가하는 정수입니다. 이 는 Sheet 인스턴스가 아닌 gridId 매개변수를 사용하는 Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)와 같은 메서드와 함께 사용하면 유용합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log(sheet.getSheetId());

리턴

Integer: 스프레드시트 고유의 시트 ID입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheetName()`

시트 이름을 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log(sheet.getSheetName());

리턴

String: 시트 이름

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheetValues(startRow, startColumn, numRows, numColumns)`

지정된 좌표에서 시작하여 이 범위에 해당하는 값의 직사각형 그리드를 반환합니다. A -1 행 또는 열 위치로 지정된 값은 맨 마지막 행이나 열을 가져오는 것과 같음 선택합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The two samples below produce the same output
var values = sheet.getSheetValues(1, 1, 3, 3);
Logger.log(values);

var range = sheet.getRange(1, 1, 3, 3);
values = range.getValues();
Logger.log(values);

매개변수

이름	유형	설명
`startRow`	`Integer`	시작 행의 위치입니다.
`startColumn`	`Integer`	시작 열의 위치입니다.
`numRows`	`Integer`	값을 반환할 행의 개수입니다.
`numColumns`	`Integer`	값을 반환할 열의 개수입니다.

리턴

Object[][] — 값의 2차원 배열

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheets()`

이 스프레드시트의 모든 시트를 가져옵니다.

// The code below logs the name of the second sheet
var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();
if (sheets.length > 1) {
  Logger.log(sheets[1].getName());
}

리턴

Sheet[] - 스프레드시트에 있는 모든 시트의 배열입니다.

`getSpreadsheetLocale()`

스프레드시트 언어를 가져옵니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the spreadsheet locale.
const ssLocale = ss.getSpreadsheetLocale();

// Logs the locale to the console.
console.log(ssLocale);

리턴

String - 스프레드시트 언어

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSpreadsheetTheme()`

스프레드시트의 현재 테마를 반환하거나, 테마가 적용되지 않은 경우 null를 반환합니다.

// The code below returns the current theme of the spreadsheet.
var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();

리턴

SpreadsheetTheme: 현재 적용된 테마입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSpreadsheetTimeZone()`

스프레드시트의 시간대를 가져옵니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

리턴

String - 'long'으로 지정된 시간대 형식 (예: 'America/New_York', Joda.org 제공).

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getUrl()`

지정된 스프레드시트의 URL을 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getUrl());

리턴

String - 지정된 스프레드시트의 URL입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getViewers()`

이 Spreadsheet의 뷰어 및 댓글 작성자 목록을 가져옵니다.

리턴

User[] - 보기 또는 댓글 작성 권한이 있는 사용자의 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`hideColumn(column)`

지정된 범위의 열을 숨깁니다.

let ss = SpreadsheetApp.getActiveSpreadsheet();
let sheet = ss.getSheets()[0];

// This hides the first column
let range = sheet.getRange("A1");
sheet.hideColumn(range);

// This hides the first 3 columns
let range = sheet.getRange("A:C");
sheet.hideColumn(range);

매개변수

이름	유형	설명
`column`	`Range`	숨길 열 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`hideRow(row)`

지정된 범위의 행을 숨깁니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This hides the first row
var range = sheet.getRange("A1");
sheet.hideRow(range);

매개변수

이름	유형	설명
`row`	`Range`	숨길 행 범위입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnAfter(afterPosition)`

지정된 열 위치 뒤에 열을 삽입합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts a column after the first column position
sheet.insertColumnAfter(1);

매개변수

이름	유형	설명
`afterPosition`	`Integer`	뒤에 새 열을 추가해야 하는 열입니다.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnBefore(beforePosition)`

지정된 열 위치 앞에 열을 삽입합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts a column in the first column position
sheet.insertColumnBefore(1);

매개변수

이름	유형	설명
`beforePosition`	`Integer`	앞에 새 열을 추가해야 하는 열입니다.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnsAfter(afterPosition, howMany)`

지정된 열 위치 뒤에 지정된 수의 열을 삽입합니다.

let ss = SpreadsheetApp.getActiveSpreadsheet();
let sheet = ss.getSheets()[0];

// Inserts two columns after the first column on the first sheet of the spreadsheet.
sheet.insertColumnsAfter(1,2);

매개변수

이름	유형	설명
`afterPosition`	`Integer`	뒤에 새 열을 추가해야 하는 열입니다.
`howMany`	`Integer`	삽입할 열의 개수입니다.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnsBefore(beforePosition, howMany)`

지정된 열 위치 앞에 여러 열을 삽입합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts five columns before the first column
sheet.insertColumnsBefore(1, 5);

매개변수

이름	유형	설명
`beforePosition`	`Integer`	앞에 새 열을 추가해야 하는 열입니다.
`howMany`	`Integer`	삽입할 열의 개수입니다.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertDataSourceSheet(spec)`

스프레드시트에 새 DataSourceSheet를 삽입하고 데이터 실행을 시작합니다. 새 시트가 활성 시트가 됩니다.

데이터 소스 유형이 사용 설정되지 않은 경우 예외가 발생합니다. SpreadsheetApp#enable...Execution() 메서드를 사용하여 특정 데이터 소스의 데이터 실행을 사용 설정합니다. 있습니다.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Builds a data source specification.
// TODO (developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
 .asBigQuery()
 .setProjectId('project-id-1')
 .setTableProjectId('bigquery-public-data')
 .setDatasetId('ncaa_basketball')
 .setTableId('mbb_historical_teams_games')
 .build();

// Adds the data source and its data to the spreadsheet.
ss.insertDataSourceSheet(dataSourceSpec);

매개변수

이름	유형	설명
`spec`	`DataSourceSpec`	삽입할 데이터 소스 사양입니다.

리턴

DataSourceSheet - 새 데이터 소스 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(blobSource, column, row)`

문서의 지정된 행과 열에 Spreadsheet를 이미지로 삽입합니다. 이미지 blob의 콘텐츠에서 가져옵니다. 지원되는 최대 blob 크기는 2MB입니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1);

매개변수

이름	유형	설명
`blobSource`	`BlobSource`	이미지 콘텐츠, MIME 유형 및 이름 (선택사항)을 포함하는 blob입니다.
`column`	`Integer`	열 위치입니다.
`row`	`Integer`	행 위치입니다.

리턴

OverGridImage - 삽입된 이미지입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(blobSource, column, row, offsetX, offsetY)`

문서의 지정된 행과 열에 Spreadsheet을 픽셀 오프셋입니다. 이미지 크기는 blob 콘텐츠에서 가져옵니다. 지원되는 최대 blob 크기는 2MB입니다

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1, 10, 10);

매개변수

이름	유형	설명
`blobSource`	`BlobSource`	이미지 콘텐츠, MIME 유형 및 이름 (선택사항)을 포함하는 blob입니다.
`column`	`Integer`	열 위치입니다.
`row`	`Integer`	행 위치입니다.
`offsetX`	`Integer`	셀 모서리로부터의 가로 오프셋(픽셀)입니다.
`offsetY`	`Integer`	셀 모서리로부터의 세로 오프셋(픽셀)입니다.

리턴

OverGridImage - 삽입된 이미지입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(url, column, row)`

문서의 지정된 행과 열에 이미지를 삽입합니다.

제공된 URL은 공개적으로 액세스할 수 있어야 합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);

매개변수

이름	유형	설명
`url`	`String`	이미지의 URL입니다.
`column`	`Integer`	그리드 열 위치입니다.
`row`	`Integer`	그리드 행 위치입니다.

리턴

OverGridImage - 삽입된 이미지입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(url, column, row, offsetX, offsetY)`

문서의 지정된 행과 열에 픽셀 오프셋을 사용하여 이미지를 삽입합니다.

제공된 URL은 공개적으로 액세스할 수 있어야 합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);

매개변수

이름	유형	설명
`url`	`String`	이미지의 URL입니다.
`column`	`Integer`	열 위치입니다.
`row`	`Integer`	행 위치입니다.
`offsetX`	`Integer`	셀 모서리로부터의 가로 오프셋(픽셀)입니다.
`offsetY`	`Integer`	셀 모서리로부터의 세로 오프셋(픽셀)입니다.

리턴

OverGridImage - 삽입된 이미지입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowAfter(afterPosition)`

지정된 행 위치 뒤에 행을 삽입합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts a row after the first row position
sheet.insertRowAfter(1);

매개변수

이름	유형	설명
`afterPosition`	`Integer`	뒤에 새 행을 추가해야 하는 행입니다.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowBefore(beforePosition)`

지정된 행 위치 앞에 행을 삽입합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts a row before the first row position
sheet.insertRowBefore(1);

매개변수

이름	유형	설명
`beforePosition`	`Integer`	앞에 새 행을 추가해야 하는 행입니다.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowsAfter(afterPosition, howMany)`

지정된 행 위치 뒤에 여러 행을 삽입합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts five rows after the first row
sheet.insertRowsAfter(1, 5);

매개변수

이름	유형	설명
`afterPosition`	`Integer`	뒤에 새 행을 추가해야 하는 행입니다.
`howMany`	`Integer`	삽입할 행 수입니다.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowsBefore(beforePosition, howMany)`

지정된 행 위치 앞에 여러 행을 삽입합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts five rows before the first row
sheet.insertRowsBefore(1, 5);

매개변수

이름	유형	설명
`beforePosition`	`Integer`	앞에 새 행을 추가해야 하는 행입니다.
`howMany`	`Integer`	삽입할 행 수입니다.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet()`

기본 시트 이름을 사용하여 스프레드시트에 새 시트를 삽입합니다. 새 시트는 있습니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet();

리턴

Sheet - 새 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetIndex)`

지정된 색인의 스프레드시트에 새 시트를 삽입합니다. 새 시트가 활성 상태가 됩니다. 시트입니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet(1);

매개변수

이름	유형	설명
`sheetIndex`	`Integer`	새로 만든 시트의 색인입니다. 다음 위치에 시트를 첫 번째 시트로 삽입하려면 0으로 설정합니다.

리턴

Sheet - 새 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetIndex, options)`

지정된 색인의 스프레드시트에 새 시트를 삽입하고 선택적 고급을 사용합니다. 인수입니다. 새 시트가 활성 시트가 됩니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet(1, {template: templateSheet});

매개변수

이름	유형	설명
`sheetIndex`	`Integer`	새로 만든 시트의 색인입니다. 다음 위치에 시트를 첫 번째 시트로 삽입하려면 0으로 설정합니다.
`options`	`Object`	선택적 JavaScript 고급 인수입니다.

고급 매개변수

이름	유형	설명
`template`	`Sheet`	템플릿 시트 객체의 모든 데이터가 새 시트입니다. 시트 템플릿은 스프레드시트 객체의 시트 중 하나여야 합니다.

리턴

Sheet - 새 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(options)`

기본 시트 이름 및 고급 옵션(선택사항)을 사용하여 스프레드시트에 새 시트를 삽입합니다. 인수입니다. 새 시트가 활성 시트가 됩니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet({template: templateSheet});

매개변수

이름	유형	설명
`options`	`Object`	아래에 나열된 자바스크립트 고급 인수(선택사항).

고급 매개변수

이름	유형	설명
`template`	`Sheet`	템플릿 시트 객체의 모든 데이터가 새 시트입니다. 시트 템플릿은 이 스프레드시트 객체의 시트 중 하나여야 합니다.

리턴

Sheet - 새 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetName)`

스프레드시트에 지정된 이름의 새 시트를 삽입합니다. 새 시트가 활성 상태가 됩니다. 시트입니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet');

매개변수

이름	유형	설명
`sheetName`	`String`	새 시트의 이름입니다.

리턴

Sheet - 새 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetName, sheetIndex)`

지정된 색인에 지정된 이름의 스프레드시트에 새 시트를 삽입합니다. 새 시트 활성 시트가 됩니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet', 1);

매개변수

이름	유형	설명
`sheetName`	`String`	새 시트의 이름입니다.
`sheetIndex`	`Integer`	새로 만든 시트의 색인입니다. 다음 위치에 시트를 첫 번째 시트로 삽입하려면 0으로 설정합니다.

리턴

Sheet - 새 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetName, sheetIndex, options)`

주어진 색인에서 지정된 이름의 스프레드시트에 새 시트를 삽입하고 고급 인수(선택사항) 새 시트가 활성 시트가 됩니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', 1, {template: templateSheet});

매개변수

이름	유형	설명
`sheetName`	`String`	새 시트의 이름입니다.
`sheetIndex`	`Integer`	새로 삽입된 시트의 색인입니다. 다음 위치에 시트를 첫 번째 시트로 삽입하려면 0으로 설정합니다.
`options`	`Object`	선택적 JavaScript 고급 인수입니다.

고급 매개변수

이름	유형	설명
`template`	`Sheet`	템플릿 시트 객체의 모든 데이터가 새 시트입니다. 시트 템플릿은 스프레드시트 객체의 시트 중 하나여야 합니다.

리턴

Sheet - 새 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetName, options)`

지정된 이름으로 스프레드시트에 새 시트를 삽입하고 선택적 고급 옵션을 사용합니다. 인수입니다. 새 시트가 활성 시트가 됩니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', {template: templateSheet});

매개변수

이름	유형	설명
`sheetName`	`String`	새 시트의 이름입니다.
`options`	`Object`	선택적 JavaScript 고급 인수입니다.

고급 매개변수

이름	유형	설명
`template`	`Sheet`	템플릿 시트 객체의 모든 데이터가 새 시트입니다. 시트 템플릿은 스프레드시트 객체의 시트 중 하나여야 합니다.

리턴

Sheet - 새 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheetWithDataSourceTable(spec)`

스프레드시트에 새 시트를 삽입하고 범위에 걸쳐 DataSourceTable을 만듭니다. 전체 시트에 액세스하고, 데이터 실행을 시작합니다. 측면 새 시트를 활성 시트로 만듭니다.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds a sheet and sets cell A1 as the parameter cell.
const parameterCell = ss.insertSheet('parameterSheet').getRange('A1');

// Sets the value of the parameter cell to 'Duke'.
parameterCell.setValue('Duke');

const query = 'select * from `bigquery-public-data`.`ncaa_basketball`.' +
  '`mbb_historical_tournament_games` WHERE win_school_ncaa = @SCHOOL';

// Adds a data source with a query parameter.
// TODO(developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
 .asBigQuery()
 .setProjectId('project-id-1')
 .setRawQuery(query)
 .setParameterFromCell('SCHOOL', 'parameterSheet!A1')
 .build();

// Adds sheets for the data source and data source table to the spreadsheet.
ss.insertSheetWithDataSourceTable(dataSourceSpec);

매개변수

이름	유형	설명
`spec`	`DataSourceSpec`	삽입할 데이터 소스 사양입니다.

리턴

Sheet - 새 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isColumnHiddenByUser(columnPosition)`

지정된 열을 사용자가 숨겼는지 여부를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Columns start at 1
Logger.log(sheet.isColumnHiddenByUser(1));

매개변수

이름	유형	설명
`columnPosition`	`Integer`	검토할 열의 위치입니다.

리턴

Boolean — 열이 숨겨져 있으면 true, 숨겨져 있으면 false입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isIterativeCalculationEnabled()`

이 스프레드시트에서 반복 계산이 활성화되었는지 여부를 반환합니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

리턴

Boolean: 반복 계산이 활성화된 경우 true, 그렇지 않은 경우 false

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isRowHiddenByFilter(rowPosition)`

지정된 행이 필터 보기가 아닌 필터에 의해 숨겨졌는지 여부를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Rows start at 1
Logger.log(sheet.isRowHiddenByFilter(1));

매개변수

이름	유형	설명
`rowPosition`	`Integer`	검사할 행의 위치입니다.

리턴

Boolean — 행이 숨겨져 있으면 true, 숨겨져 있으면 false입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isRowHiddenByUser(rowPosition)`

지정된 행을 사용자가 숨겼는지 여부를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Rows start at 1
Logger.log(sheet.isRowHiddenByUser(1));

매개변수

이름	유형	설명
`rowPosition`	`Integer`	검사할 행의 위치입니다.

리턴

Boolean — 행이 숨겨져 있으면 true, 숨겨져 있으면 false입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`moveActiveSheet(pos)`

활성 시트를 시트 목록의 지정된 위치로 이동합니다. 다음과 같은 경우 예외가 발생합니다. 위치가 음수이거나 시트 수보다 큽니다.

// This example assumes that there are 2 sheets in the current
// active spreadsheet: one named "first" in position 1 and another named "second"
// in position 2.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// Gets the "first" sheet and activates it.
var sheet = spreadsheet.getSheetByName("first").activate();

// Logs 'Current index of sheet: 1'
console.log("Current index of sheet: %s", sheet.getIndex());

spreadsheet.moveActiveSheet(2);

// Logs 'New index of sheet: 2'
console.log("New index of sheet: %s", sheet.getIndex());

매개변수

이름	유형	설명
`pos`	`Integer`	시트 목록에서 활성 시트를 이동할 색인 1자리 위치입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`moveChartToObjectSheet(chart)`

새 SheetType.OBJECT 시트를 만들고 제공된 차트를 이 시트로 이동합니다. 차트 가 이미 자체 시트에 있는 경우 새 시트를 만들지 않고 해당 시트가 반환됩니다.

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.newChart().setPosition(1, 1, 0, 0).build();
sheet.insertChart(chart);
var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);

매개변수

이름	유형	설명
`chart`	`EmbeddedChart`	이동할 차트입니다.

리턴

Sheet - 차트가 있는 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`refreshAllDataSources()`

지원되는 모든 데이터 소스 및 연결된 데이터 소스 객체를 새로고침하고 잘못된 항목을 건너뜁니다. 데이터 소스 객체입니다.

SpreadsheetApp#enable...Execution() 메서드를 사용하여 다음에 대한 데이터 실행 사용 설정 특정 데이터 소스 유형을 추적할 수 있습니다

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the first data source sheet on the spreadsheet.
const dataSheet = ss.getDataSourceSheets()[0];

// Refreshes all data sources on the spreadsheet.
ss.refreshAllDataSources();

// Logs the last refreshed time of the first data source sheet.
console.log(`Last refresh time: ${dataSheet.getStatus().getLastRefreshedTime()}`);

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeEditor(emailAddress)`

Spreadsheet의 편집자 목록에서 지정된 사용자를 삭제합니다. 이 메서드는 다음과 같은 사용자 클래스에 속하는 경우 사용자가 Spreadsheet에 액세스하지 못하도록 차단합니다. 일반 액세스 권한(예: Spreadsheet이 사용자의 전체 계정과 공유되는 경우) 또는 Spreadsheet이(가) 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우입니다.

Drive 파일의 경우 뷰어 목록에서도 사용자가 삭제됩니다.

매개변수

이름	유형	설명
`emailAddress`	`String`	삭제할 사용자의 이메일 주소입니다.

리턴

Spreadsheet: 이 Spreadsheet는 체이닝을 위한 것입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeEditor(user)`

Drive 파일의 경우 뷰어 목록에서도 사용자가 삭제됩니다.

매개변수

이름	유형	설명
`user`	`User`	삭제할 사용자를 나타냅니다.

리턴

Spreadsheet: 이 Spreadsheet는 체이닝을 위한 것입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeMenu(name)`

addMenu(name, subMenus)가 추가한 메뉴를 삭제합니다. name 인수 상응하는 addMenu(name, subMenus) 호출과 동일한 값을 가져야 합니다.

// The onOpen function is executed automatically every time a Spreadsheet is loaded
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.addMenu("badMenu", [{name: "remove bad menu", functionName: "removeBadMenu"},
                                       {name: "foo", functionName: "foo"}]);
}
function removeBadMenu() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.removeMenu("badMenu");  // name must match the name used when added the menu
}
function foo(){
// Do nothing
}

매개변수

이름	유형	설명
`name`	`String`	삭제할 메뉴의 이름입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeNamedRange(name)`

지정된 이름의 이름이 지정된 범위를 삭제합니다. 지정된 이름의 범위가 없으면 예외가 발생합니다. 확인할 수 있습니다.

// The code below creates a new named range "foo", and then remove it.
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange("foo", ss.getActiveRange());
ss.removeNamedRange("foo");

매개변수

이름	유형	설명
`name`	`String`	범위 이름입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeViewer(emailAddress)`

Spreadsheet의 뷰어 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. 이 사용자가 뷰어나 댓글 작성자가 아닌 편집자인 경우에는 아무런 영향을 미치지 않습니다. 또한 이 메서드는 사용자가 다음 사용자 클래스에 속한 경우 Spreadsheet에 액세스하는 것을 차단하지 않음 일반 액세스 권한이 있어야 합니다. 예를 들어 Spreadsheet가 사용자의 전체 도메인 또는 Spreadsheet이(가) 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우

Drive 파일의 경우 편집자 목록에서도 사용자가 삭제됩니다.

매개변수

이름	유형	설명
`emailAddress`	`String`	삭제할 사용자의 이메일 주소입니다.

리턴

Spreadsheet: 체이닝을 위한 Spreadsheet입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeViewer(user)`

Spreadsheet의 뷰어 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. 이 사용자가 뷰어가 아닌 편집자인 경우에는 아무런 영향을 미치지 않습니다. 또한 이 메서드는 사용자가 일반 액세스 권한 요청을 가진 사용자 클래스에 속하는 경우 Spreadsheet에 액세스할 수 없습니다. 액세스 권한(예: Spreadsheet이 사용자의 전체 도메인과 공유되는 경우) Spreadsheet가 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우

Drive 파일의 경우 편집자 목록에서도 사용자가 삭제됩니다.

매개변수

이름	유형	설명
`user`	`User`	삭제할 사용자를 나타냅니다.

리턴

Spreadsheet: 체이닝을 위한 Spreadsheet입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`rename(newName)`

문서 이름을 변경합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.rename("This is the new name");

매개변수

이름	유형	설명
`newName`	`String`	문서의 새 이름입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`renameActiveSheet(newName)`

현재 활성 시트의 이름을 지정된 새 이름으로 바꿉니다.

// The code below renames the active sheet to "Hello world"
SpreadsheetApp.getActiveSpreadsheet().renameActiveSheet("Hello world");

매개변수

이름	유형	설명
`newName`	`String`	현재 활성 시트의 새 이름입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`resetSpreadsheetTheme()`

적용된 테마를 삭제하고 스프레드시트의 기본 테마를 설정합니다.

// The code below applies default theme on the spreadsheet.
SpreadsheetApp.getActiveSpreadsheet().resetSpreadsheetTheme();

리턴

SpreadsheetTheme - 기본 테마입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveRange(range)`

지정된 범위를 활성 시트의 active range로 설정 범위의 왼쪽 상단 셀을 current cell로 설정합니다.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var range = sheet.getRange('A1:D4');
sheet.setActiveRange(range);

var selection = sheet.getSelection();
// Current cell: A1
var currentCell = selection.getCurrentCell();
// Active Range: A1:D4
var activeRange = selection.getActiveRange();

매개변수

이름	유형	설명
`range`	`Range`	활성 범위로 설정할 범위입니다.

리턴

Range: 새로 활성 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveRangeList(rangeList)`

지정된 범위 목록을active ranges 있습니다. 목록의 마지막 범위는 active range로 설정됩니다.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
sheet.setActiveRangeList(rangeList);

var selection = sheet.getSelection();
// Current cell: B2
var currentCell = selection.getCurrentCell();
// Active range: B2:C4
var activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
var activeRangeList = selection.getActiveRangeList();

매개변수

이름	유형	설명
`rangeList`	`RangeList`	선택할 범위 목록입니다.

리턴

RangeList - 새로 선택한 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSelection(range)`

이 시트의 활성 선택 영역을 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D4");
sheet.setActiveSelection(range);

매개변수

이름	유형	설명
`range`	`Range`	활성 선택으로 설정할 범위입니다.

리턴

Range: 새로 활성 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSelection(a1Notation)`

A1 표기법 또는 R1C1 표기법에 지정된 대로 활성 선택을 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

sheet.setActiveSelection("A1:D4");

매개변수

이름	유형	설명
`a1Notation`	`String`	A1 표기법 또는 R1C1 표기법으로 지정된 활성으로 설정할 범위입니다.

리턴

Range: 새로 활성 범위

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSheet(sheet)`

지정된 시트를 스프레드시트의 활성 시트로 설정합니다. Google Sheets UI 표시 시트가 다른 스프레드시트에 속하지 않는 한 선택한 시트에서 삭제됩니다.

// The code below makes the first sheet active in the active spreadsheet.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
spreadsheet.setActiveSheet(spreadsheet.getSheets()[0]);

매개변수

이름	유형	설명
`sheet`	`Sheet`	활성 시트로 설정할 시트입니다.

리턴

Sheet - 활성 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSheet(sheet, restoreSelection)`

지정한 시트를 스프레드시트의 활성 시트로 설정하며, 이때 할 수 있습니다. Google Sheets UI는 선택한 시트를 표시합니다. 시트가 다른 스프레드시트에 속해 있는 경우

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var firstSheet = spreadsheet.getSheets()[0];
var secondSheet = spreadsheet.getSheets()[1];
// Set the first sheet as the active sheet and select the range D4:F4.
spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate();

// Switch to the second sheet to do some work.
spreadsheet.setActiveSheet(secondSheet);
// Switch back to first sheet, and restore its selection.
spreadsheet.setActiveSheet(firstSheet, true);

// The selection of first sheet is restored, and it logs D4:F4
var range = spreadsheet.getActiveSheet().getSelection().getActiveRange();
Logger.log(range.getA1Notation());

매개변수

이름	유형	설명
`sheet`	`Sheet`	새 활성 시트입니다.
`restoreSelection`	`Boolean`	Tf `true`, 새 활성 시트의 가장 최근 선택 새 시트가 활성화되면 다시 선택됩니다. `false`인 경우 새 시트입니다. 이(가) 현재 선택 항목을 변경하지 않고 활성화됩니다.

리턴

Sheet - 새 활성 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setColumnWidth(columnPosition, width)`

지정된 열의 너비를 픽셀 단위로 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Sets the first column to a width of 200 pixels
sheet.setColumnWidth(1, 200);

매개변수

이름	유형	설명
`columnPosition`	`Integer`	설정할 지정된 열의 위치입니다.
`width`	`Integer`	설정할 너비입니다(픽셀 단위).

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setCurrentCell(cell)`

지정된 셀을 current cell로 설정합니다.

지정된 셀이 이미 선택된 범위에 있으면 그 범위가 활성 범위를 반환합니다.

지정된 셀이 선택된 범위에 없으면 기존 선택사항은 이 셀이 현재 셀과 활성 범위가 됩니다.

참고: 지정된 Range는 하나의 셀로 구성되어야 합니다. 그렇지 않으면 예외가 인정됩니다.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var cell = sheet.getRange('B5');
sheet.setCurrentCell(cell);

var selection = sheet.getSelection();
// Current cell: B5
var currentCell = selection.getCurrentCell();

매개변수

이름	유형	설명
`cell`	`Range`	현재 셀로 설정할 셀입니다.

리턴

Range: 새로 설정된 현재 셀

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFrozenColumns(columns)`

지정된 수의 열을 고정합니다. 0이면 고정된 열이 없습니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Freezes the first column
sheet.setFrozenColumns(1);

매개변수

이름	유형	설명
`columns`	`Integer`	고정할 열의 개수입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFrozenRows(rows)`

지정된 수의 행을 고정합니다. 0인 경우 고정된 행이 없습니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Freezes the first row
sheet.setFrozenRows(1);

매개변수

이름	유형	설명
`rows`	`Integer`	고정할 행 수입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setIterativeCalculationConvergenceThreshold(minThreshold)`

반복 계산을 위한 최소 임곗값을 설정합니다. 연속적인 계산의 차이가 이 값보다 작으면 반복 계산이 중지됩니다. 이 값은 음수가 아닌 값이며 기본값은 0.05입니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the iterative calculation convergence threshold for the spreadsheet.
ss.setIterativeCalculationConvergenceThreshold(2);

// Logs the threshold to the console.
console.log(ss.getIterativeCalculationConvergenceThreshold());

매개변수

이름	유형	설명
`minThreshold`	`Number`	최소 수렴 기준점입니다 (음수가 아니어야 함).

리턴

Spreadsheet - 이 스프레드시트는 연결용입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setIterativeCalculationEnabled(isEnabled)`

이 스프레드시트에서 반복 계산을 활성화할지 여부를 설정합니다. 최대 개수의 계산 주기 및 수렴 임곗값은 이전에 계산 시 활성화되면 각각 50과 0.05로 기본 설정됩니다. 둘 중 하나라도 이전에 설정된 경우 이전 값을 유지합니다

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

매개변수

이름	유형	설명
`isEnabled`	`Boolean`	반복 계산을 사용 설정해야 하는 경우 `true`입니다. `false` 없습니다.

리턴

Spreadsheet - 이 스프레드시트는 연결용입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setMaxIterativeCalculationCycles(maxIterations)`

반복 중에 수행해야 하는 계산 반복의 최대 횟수를 설정합니다. 계산할 수도 있습니다. 이 값은 1 이상 10,000 이하여야 하며 기본값은 50입니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the max iterative calculation cycles for the spreadsheet.
ss.setMaxIterativeCalculationCycles(10);

// Logs the max iterative calculation cycles to the console.
console.log(ss.getMaxIterativeCalculationCycles());

매개변수

이름	유형	설명
`maxIterations`	`Integer`	계산 반복의 최대 횟수입니다 (1~10,000).

리턴

Spreadsheet - 이 스프레드시트는 연결용입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setNamedRange(name, range)`

범위의 이름을 지정합니다.

// The code below creates a new named range "TaxRates" in the active spreadsheet
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange("TaxRates", SpreadsheetApp.getActiveRange());

매개변수

이름	유형	설명
`name`	`String`	범위에 지정할 이름입니다.
`range`	`Range`	범위 사양.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRecalculationInterval(recalculationInterval)`

스프레드시트를 다시 계산하는 빈도를 설정합니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the  calculation interval for the spreadsheet to 'ON_CHANGE'.
const interval = ss.setRecalculationInterval(SpreadsheetApp.RecalculationInterval.ON_CHANGE);

// Logs the calculation interval to the console.
console.log(interval);

매개변수

이름	유형	설명
`recalculationInterval`	`RecalculationInterval`	새 다시 계산 간격입니다.

리턴

Spreadsheet - 이 스프레드시트는 연결용입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRowHeight(rowPosition, height)`

지정된 행의 행 높이를 픽셀 단위로 설정합니다. 기본적으로 행은 셀 콘텐츠에 맞게 확장됩니다. 만약 행을 지정된 높이로 강제 설정하려면 Sheet.setRowHeightsForced(startRow, numRows, height)를 사용합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Sets the first row to a height of 200 pixels
sheet.setRowHeight(1, 200);

매개변수

이름	유형	설명
`rowPosition`	`Integer`	변경할 행 위치입니다.
`height`	`Integer`	설정할 높이(픽셀)입니다.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSpreadsheetLocale(locale)`

스프레드시트의 언어를 설정합니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the spreadsheet locale.
ss.setSpreadsheetLocale('fr');

// Gets the spreadsheet locale.
const ssLocale = ss.getSpreadsheetLocale();

// Logs the locale to the console.
console.log(ssLocale);

매개변수

이름	유형	설명
`locale`	`String`	사용할 언어 코드입니다 (예: 'en', 'fr' 또는 'en_US').

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSpreadsheetTheme(theme)`

스프레드시트에 테마를 설정합니다.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// The code below sets the second predefined theme as the current theme of the spreadsheet.
var predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes();
spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);

매개변수

이름	유형	설명
`theme`	`SpreadsheetTheme`	적용할 테마입니다.

리턴

SpreadsheetTheme: 새로운 현재 테마입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSpreadsheetTimeZone(timezone)`

스프레드시트의 시간대를 설정합니다.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

매개변수

이름	유형	설명
`timezone`	`String`	'long'으로 지정된 시간대 형식 (예: 'America/New_York', Joda.org에서 제공합니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`show(userInterface)`

사용자의 브라우저 중앙에 표시되는 대화상자에 맞춤 사용자 인터페이스 구성요소를 표시합니다. 표시 영역입니다. 서버 측 스크립트의 실행은 정지되지 않습니다. 서버 측에서 사용자 인터페이스 구성요소는 서버 측으로 비동기 콜백을 수행해야 합니다. 있습니다.

서버 측 스크립트가 이전에 아직 닫히지 않은 대화상자를 표시했다면 기존 대화상자가 새로 요청된 대화상자의 사용자 인터페이스로 대체됩니다.

다음 코드 스니펫은 대화상자에 간단한 HtmlService 애플리케이션을 표시합니다. 지정된 제목, 높이 및 너비:

var htmlApp = HtmlService
    .createHtmlOutput('<p>A change of speed, a change of style...</p>')
    .setTitle('My HtmlService Application')
    .setWidth(250)
    .setHeight(300);

SpreadsheetApp.getActiveSpreadsheet().show(htmlApp);

// The script resumes execution immediately after showing the dialog.

매개변수

이름	유형	설명
`userInterface`	`Object`	`HtmlOutput`입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/script.container.ui

`sort(columnPosition)`

열을 기준으로 시트를 오름차순으로 정렬합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Sorts the sheet by the first column, ascending
sheet.sort(1);

매개변수

이름	유형	설명
`columnPosition`	`Integer`	정렬 기준이 되는 열입니다.

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`sort(columnPosition, ascending)`

열을 기준으로 시트를 정렬합니다. 매개변수를 사용하여 오름차순 또는 내림차순을 지정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Sorts the sheet by the first column, descending
sheet.sort(1, false);

매개변수

이름	유형	설명
`columnPosition`	`Integer`	정렬 기준이 되는 열입니다.
`ascending`	`Boolean`	오름차순의 경우 `true`, 내림차순의 경우 `false`

리턴

Sheet: 메서드 체이닝에 유용한 시트입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`toast(msg)`

특정 메시지와 함께 스프레드시트의 오른쪽 하단에 팝업 창을 표시합니다.

// Show a popup with the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started');

매개변수

이름	유형	설명
`msg`	`String`	토스트에 표시할 메시지입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`toast(msg, title)`

스프레드시트의 오른쪽 하단에 특정 메시지와 함께 팝업 창을 표시합니다. 있습니다.

// Show a popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status');

매개변수

이름	유형	설명
`msg`	`String`	토스트에 표시할 메시지입니다.
`title`	`String`	토스트 메시지 제목(선택사항)입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`toast(msg, title, timeoutSeconds)`

스프레드시트의 오른쪽 하단에 주어진 제목과 제목, 특정 시간 동안 계속 표시됩니다.

// Show a 3-second popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);

매개변수

이름	유형	설명
`msg`	`String`	토스트에 표시할 메시지입니다.
`title`	`String`	토스트 메시지 제목(선택사항)입니다.
`timeoutSeconds`	`Number`	제한 시간(초)입니다. `null`인 경우 토스트 메시지는 기본적으로 5초입니다. 음수인 경우 해제될 때까지 토스트 메시지가 유지됩니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`unhideColumn(column)`

지정된 범위의 열 숨기기를 해제합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This unhides the first column if it was previously hidden
var range = sheet.getRange("A1");
sheet.unhideColumn(range);

매개변수

이름	유형	설명
`column`	`Range`	숨기기를 해제할 범위입니다(숨겨진 경우).

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`unhideRow(row)`

지정된 범위의 행 숨기기를 해제합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This unhides the first row if it was previously hidden
var range = sheet.getRange("A1");
sheet.unhideRow(range);

매개변수

이름	유형	설명
`row`	`Range`	숨기기를 해제할 범위입니다(숨겨진 경우).

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`updateMenu(name, subMenus)`

addMenu(name, subMenus)에서 추가한 메뉴를 업데이트합니다. addMenu(name, subMenus)와 동일하게 작동합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var menuEntries = [];
menuEntries.push({name: "Lone Menu Entry", functionName: "function1"});
ss.updateMenu("addMenuExample", menuEntries);

매개변수

이름	유형	설명
`name`	`String`	업데이트할 메뉴의 이름입니다.
`subMenus`	`Object[]`	`name` 및 `functionName` 매개변수가 있는 JavaScript 지도의 배열. 포함된 라이브러리의 함수(예: `Library.libFunction1`)를 사용할 수 있습니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`waitForAllDataExecutionsCompletion(timeoutInSeconds)`

스프레드시트의 모든 현재 실행이 완료될 때까지 대기하고, 제공된 초 수입니다. 타이밍이 만료될 때 실행이 완료되지 않으면 예외가 발생합니다. 데이터 실행을 취소하지는 않습니다.

매개변수

이름	유형	설명
`timeoutInSeconds`	`Integer`	데이터 실행을 기다리는 시간(초)입니다. 최댓값은 300입니다. 초입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

지원 중단된 메서드

`getSheetProtection()`

지원 중단되었습니다. 최신 버전의 Google Sheets에서 만든 스프레드시트의 경우 더 강력한 Protection 클래스를 반환하는 Sheet.getProtections(type)를 사용하세요. 이 메서드는 지원이 중단되었지만 다음에서 계속 사용할 수 있습니다. 스프레드시트 이전 버전과의 호환성

현재 시트의 권한을 설명하는 PageProtection 인스턴스를 반환합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var permissions = sheet.getSheetProtection();

permissions.setProtected(true);
permissions.addUser("user@example.com");

// Logs the users that have access to edit this sheet. Note that this
// is different from access to the entire spreadsheet - getUsers()
// only returns users if permissions.isProtected() is set to true.
var users = permissions.getUsers();
Logger.log(users);

리턴

PageProtection — 시트 액세스 권한을 설명하는 객체

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isAnonymousView()`

지원 중단되었습니다. 2014년 1월부터 이 함수는 지원 중단되었으며 새 버전에서 사용할 수 없습니다. 문서 그룹입니다.

문서의 익명 보기 허용 여부를 나타냅니다. 이는 더 이상 새 버전의 Google 스프레드시트에서는 대신 File.getSharingAccess() 및 File.getSharingPermission()를 사용합니다.

// Determine if the document allows anonymous viewing via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());
var access = file.getSharingAccess();
var permission = file.getSharingPermission();
var isAnonymousAccess =
    access == DriveApp.Access.ANYONE || access == DriveApp.Access.ANYONE_WITH_LINK;
var isAnonymousEdit = isAnonymousAccess && permission != DriveApp.Permission.NONE;

리턴

Boolean - 문서에서 익명 보기를 허용하는 경우 true, 그렇지 않은 경우 false입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

참고 항목

Drive 서비스

`isAnonymousWrite()`

지원 중단되었습니다. 2014년 1월부터 이 함수는 지원 중단되었으며 새 버전에서 사용할 수 없습니다. 문서 그룹입니다.

문서에서 익명 사용자의 수정을 허용하는지 여부를 나타냅니다. 더 이상 지원되는 최신 버전의 Google Sheets에서는 File.getSharingAccess() 및 File.getSharingPermission()를 대신 사용하세요.

// Determine if the document allow anonymous edits via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());
var access = file.getSharingAccess();
var permission = file.getSharingPermission();
var isAnonymousAccess =
    access == DriveApp.Access.ANYONE || access == DriveApp.Access.ANYONE_WITH_LINK;
var isAnonymousEdit = isAnonymousAccess && permission == DriveApp.Permission.EDIT;

리턴

Boolean: 문서에서 익명 수정을 허용하는 경우 true, 그렇지 않은 경우 false입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

참고 항목

Drive 서비스

`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`

지원 중단되었습니다. 2014년 1월부터 이 함수는 지원 중단되었으며 새 버전에서 사용할 수 없습니다. 문서 그룹입니다.

익명 읽기 및 쓰기에 대한 문서의 정책을 설정합니다. 이는 더 이상 새 버전의 Google 스프레드시트, 대신 File.setSharing(accessType, permissionType)를 사용하세요.

// Set the document's policy on anonymous reading and writing via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());

// Set anonymous read.
file.setSharing(DriveApi.Access.ANYONE, DriveApi.Permission.VIEW);

// Set anonymous write.
file.setSharing(DriveApi.Access.ANYONE, DriveApi.Permission.EDIT);

// Disable anonymous access.
file.setSharing(DriveApi.Access.PRIVATE, file.getSharingPermission());

매개변수

이름	유형	설명
`anonymousReadAllowed`	`Boolean`	`true`는 익명 읽기를 허용합니다. 그 외에는 `false`입니다.
`anonymousWriteAllowed`	`Boolean`	`true`는 익명 읽기를 허용합니다. 그 외에는 `false`입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

참고 항목

isAnonymousView()
isAnonymousWrite()
Drive 서비스

`setSheetProtection(permissions)`

지원 중단되었습니다. 최신 버전의 Google Sheets에서 만든 스프레드시트의 경우 더 강력한 Protection 클래스를 반환하는 Sheet.protect()를 사용하세요. 하지만 이 메서드는 지원이 중단되었지만 이전 버전의 스프레드시트

현재 시트의 권한을 설정합니다.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var permissions = sheet.getSheetProtection();

// This copies the permissions on the first sheet to the second sheet
var sheetToClonePermissionsTo = ss.getSheets()[1];
sheetToClonePermissionsTo.setSheetProtection(permissions);

매개변수

이름	유형	설명
`permissions`	`PageProtection`	이 시트에 설정할 액세스 권한 객체입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets