스프레드시트 시트 액세스 및 수정 일반적인 작업으로 시트 이름 바꾸기 및 범위 액세스 개체를 삭제합니다.
메서드
자세한 문서
activate()
이 시트를 활성화합니다. 시트 자체는 변경하지 않고 상위 요소의 활성 개념만 변경합니다. 시트입니다.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.activate();
리턴
Sheet
- 새로 활성화된 시트입니다.
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'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'NAME' to the developer metadata for the sheet. sheet.addDeveloperMetadata('NAME'); // Gets the updated metadata info and logs it to the console. console.log(sheet.getDeveloperMetadata()[0].getKey());
매개변수
이름 | 유형 | 설명 |
---|---|---|
key | String | 새 개발자 메타데이터의 키입니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'NAME' and sets the developer metadata visibility to PROJECT // for the sheet. sheet.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getVisibility().toString());
매개변수
이름 | 유형 | 설명 |
---|---|---|
key | String | 새 개발자 메타데이터의 키입니다. |
visibility | DeveloperMetadataVisibility | 새 개발자 메타데이터의 공개 상태입니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'COMPANY' with the value 'TECH' to the developer metadata for the sheet. sheet.addDeveloperMetadata('COMPANY', 'TECH'); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue());
매개변수
이름 | 유형 | 설명 |
---|---|---|
key | String | 새 개발자 메타데이터의 키입니다. |
value | String | 새 개발자 메타데이터의 값입니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'COMPANY' with the value 'TECH' to the developer metadata and sets the // visibility to DOCUMENT for the sheet. sheet.addDeveloperMetadata( 'COMPANY', 'TECH', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
매개변수
이름 | 유형 | 설명 |
---|---|---|
key | String | 새 개발자 메타데이터의 키입니다. |
value | String | 새 개발자 메타데이터의 값입니다. |
visibility | DeveloperMetadataVisibility | 새 개발자 메타데이터의 공개 상태입니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
asDataSourceSheet()
시트가 SheetType.DATASOURCE
유형이면 시트를 DataSourceSheet
로 반환하고 그렇지 않으면 null
를 반환합니다.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the data source sheet value if the sheet is of type // SpreadsheetApp.SheetType.DATASOURCE, otherwise this returns a null value. const dataSourceSheet = sheet.asDataSourceSheet(); // Gets the data source sheet value and logs it to the console. console.log(dataSourceSheet); console.log(sheet.getType().toString());
리턴
DataSourceSheet
- 데이터 소스 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
autoResizeColumns(startColumn, numColumns)
지정된 열 위치에서 시작되는 모든 열의 너비를 콘텐츠에 맞게 설정합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first 15 columns to a width that fits their text. sheet.autoResizeColumns(1, 15);
매개변수
이름 | 유형 | 설명 |
---|---|---|
startColumn | Integer | 자동 크기 조정 시작 열입니다. |
numColumns | Integer | 자동 크기를 조절할 열의 개수입니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeRows(startRow, numRows)
지정된 행 위치에서 시작되는 모든 행의 높이를 콘텐츠에 맞게 설정합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first 15 rows to a height that fits their text. sheet.autoResizeRows(1, 15);
매개변수
이름 | 유형 | 설명 |
---|---|---|
startRow | Integer | 자동 크기 조절이 시작되는 행입니다. |
numRows | Integer | 자동 크기를 조절할 행 수입니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
콘텐츠 시트 및 서식 정보를 지웁니다.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clear();
리턴
Sheet
- 삭제된 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
지정된 고급 옵션에 지정된 대로 목차 및/또는 형식의 시트를 지웁니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.clear({ formatOnly: true, contentsOnly: true });
매개변수
이름 | 유형 | 설명 |
---|---|---|
options | Object | 아래에 나열된 고급 옵션이 포함된 JavaScript 지도. |
고급 매개변수
이름 | 유형 | 설명 |
---|---|---|
contentsOnly | Boolean | 콘텐츠 삭제 여부입니다. |
formatOnly | Boolean | 형식을 지울지 여부입니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearConditionalFormatRules()
시트에서 모든 조건부 서식 규칙을 삭제합니다. 빈 배열을 입력으로 사용하여 setConditionalFormatRules(rules)
를 호출하는 것과 같습니다.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.clearConditionalFormatRules();
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContents()
서식 정보는 유지하면서 목차를 지웁니다.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearContents();
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormats()
내용은 유지하면서 서식 시트를 지웁니다.
형식 지정이란 '형식' 아래의 선택사항에서 허용되는 데이터 형식을 지정하는 것을 말합니다. 메뉴 (예: 굵게, 기울임꼴, 조건부 서식) 셀의 너비나 높이가 아닙니다.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearFormats();
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNotes()
모든 메모의 시트를 지웁니다.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearNotes();
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllColumnGroups()
시트의 모든 열 그룹을 접습니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are collapsed. sheet.collapseAllColumnGroups();
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllRowGroups()
시트의 모든 행 그룹을 접습니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are collapsed. sheet.collapseAllRowGroups();
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(spreadsheet)
시트를 지정된 스프레드시트로 복사합니다. 이 스프레드시트는 소스와 동일한 스프레드시트일 수 있습니다. 이 복사된 시트 이름은 '[원본 이름]의 사본'으로 지정됩니다.
var source = SpreadsheetApp.getActiveSpreadsheet(); var sheet = source.getSheets()[0]; var destination = SpreadsheetApp.openById('ID_GOES HERE'); sheet.copyTo(destination);
매개변수
이름 | 유형 | 설명 |
---|---|---|
spreadsheet | Spreadsheet | 이 시트를 복사할 스프레드시트입니다. 이 스프레드시트와 동일한 스프레드시트일 수 있습니다. 소스입니다. |
리턴
Sheet
- 체인을 위한 새 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds developer metadata for testing. sheet.addDeveloperMetadata('CITY', 'PARIS'); // Creates the developer metadata finder. const metadatafinder = sheet.createDeveloperMetadataFinder(); // Finds the metadata with value 'PARIS' and displays its key in the console. console.log(metadatafinder.withValue('PARIS').find()[0].getKey());
리턴
DeveloperMetadataFinder
- 이 시트 범위에 있는 메타데이터를 검색하기 위한 개발자 메타데이터 파인더입니다.
createTextFinder(findText)
시트의 텍스트 찾기 기능을 만들어 시트 내에서 텍스트를 찾아 바꿀 수 있습니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Creates a text finder. var textFinder = sheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the sheet. 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
입니다.
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
expandAllColumnGroups()
시트의 모든 열 그룹을 펼칩니다. 이 메서드에는 하나 이상의 열 그룹이 필요합니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are expanded. sheet.expandAllColumnGroups();
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandAllRowGroups()
시트의 모든 행 그룹을 펼칩니다. 이 방법에는 1개 이상의 행 그룹이 필요합니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are expanded. sheet.expandAllRowGroups();
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandColumnGroupsUpToDepth(groupDepth)
모든 열 그룹을 지정된 깊이까지 펼치고 다른 모든 열 그룹은 접습니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups of depth 2 and lower are expanded, and groups with depth // 3 and higher are collapsed. sheet.expandColumnGroupsUpToDepth(2);
매개변수
이름 | 유형 | 설명 |
---|---|---|
groupDepth | Integer | 열 그룹을 펼칠 그룹 깊이입니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandRowGroupsUpToDepth(groupDepth)
모든 행 그룹을 지정된 깊이까지 펼치고 다른 모든 행 그룹은 접습니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups of depth 2 and lower are expanded, and groups with depth // 3 and higher are collapsed. sheet.expandRowGroupsUpToDepth(2);
매개변수
이름 | 유형 | 설명 |
---|---|---|
groupDepth | Integer | 행 그룹을 펼칠 최대 그룹 깊이입니다. |
리턴
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
참고 항목
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
참고 항목
getBandings()
이 시트의 모든 밴딩을 반환합니다.
// 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 a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the banding info for the sheet. const bandings = sheet.getBandings(); // Gets info on the bandings' second row color and logs it to the console. for (const banding of bandings) { console.log(banding.getSecondRowColor()); }
리턴
Banding[]
- 이 시트의 모든 밴딩입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCharts()
이 시트의 차트 배열을 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; // Do something with the chart }
리턴
EmbeddedChart[]
- 차트의 배열입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroup(columnIndex, groupDepth)
지정된 색인의 열 그룹과 그룹 깊이를 반환합니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Returns the group whose control index is at column 2 and has a depth of 1, or // null if the group doesn’t exist. var columnGroup = sheet.getColumnGroup(2, 1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnIndex | Integer | 그룹 컨트롤 전환의 열 색인 또는 그룹 내 색인입니다. |
groupDepth | Integer | 그룹의 깊이입니다. |
리턴
Group
- 대조군 색인 및 깊이의 열 그룹이거나 그룹인 경우 예외가 발생합니다.
존재하지 않습니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupControlPosition()
시트의 모든 열 그룹에 대해 GroupControlTogglePosition
를 반환합니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the column grouping control toggle is shown after the // group. var columnGroupControlPosition = sheet.getColumnGroupControlPosition();
리턴
GroupControlTogglePosition
- 이 열의 그룹 뒤에 열 그룹화 컨트롤 전환 버튼이 표시되면 true
시트이고 그 밖의 경우에는 false
입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupDepth(columnIndex)
지정된 색인에서 열의 그룹 깊이를 반환합니다.
그룹 깊이는 열과 겹치는 그룹 수를 나타냅니다. 범위는 0과 8입니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over columns 1 through 3 var groupDepth = sheet.getColumnGroupDepth(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnIndex | Integer | 열의 색인입니다. |
리턴
Integer
- 지정된 색인에 있는 열의 그룹 깊이입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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
getConditionalFormatRules()
이 시트의 모든 조건부 서식 규칙을 가져옵니다.
// Logs the conditional format rules in a sheet. var rules = SpreadsheetApp.getActiveSheet().getConditionalFormatRules(); for (var i = 0; i < rules.length; i++) { var rule = rules[i]; Logger.log(rule); }
리턴
ConditionalFormatRule[]
- 시트에 있는 모든 규칙의 배열입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
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
getDeveloperMetadata()
이 시트와 연결된 모든 개발자 메타데이터를 가져옵니다.
// 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 a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds developer metadata for testing. sheet.addDeveloperMetadata('CITY', 'PARIS'); // Gets all the developer metadata for the sheet. const developerMetaDataList = sheet.getDeveloperMetadata(); // Logs the developer metadata to the console. for (const developerMetaData of developerMetaDataList) { console.log(developerMetaData.getKey()); }
리턴
DeveloperMetadata[]
- 이 시트와 연결된 개발자 메타데이터입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDrawings()
시트의 그림 배열을 반환합니다.
// 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 a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all the drawings from the sheet. const allDrawings = sheet.getDrawings(); // Logs the number of drawings present on the sheet. console.log(allDrawings.length);
리턴
Drawing[]
- 이 시트의 그림 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
이 시트의 필터를 반환합니다. 필터가 없으면 null
을 반환합니다.
// Gets the filter on the active sheet. let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter();
리턴
Filter
- 필터입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormUrl()
이 시트에 응답을 보내는 양식의 URL, 또는 이 시트에 응답을 보내는 경우 null
를 반환합니다.
시트에 연결된 양식이 없습니다.
var sheet = SpreadsheetApp.getActiveSheet(); var url = sheet.getFormUrl();
리턴
String
: 이 시트에 응답을 배치하는 양식의 URL 또는 null
(이 경우 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
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
getIndex()
상위 스프레드시트에 있는 시트의 위치를 가져옵니다. 1부터 시작합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); // Note that the JavaScript index is 0, but this logs 1 var sheet = ss.getSheets()[0]; // ... because spreadsheets are 1-indexed Logger.log(sheet.getIndex());
리턴
Integer
- 상위 스프레드시트 내 시트의 위치입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
getMaxColumns()
콘텐츠에 관계없이 시트의 현재 열 수를 반환합니다.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); Logger.log(first.getMaxColumns());
리턴
Integer
- 시트의 최대 너비입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxRows()
콘텐츠에 관계없이 시트의 현재 행 수를 반환합니다.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); Logger.log(first.getMaxRows());
리턴
Integer
- 시트의 최대 높이입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getName()
시트의 이름을 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.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.getActiveSheet().getNamedRanges(); if (namedRanges.length > 1) { Logger.log(namedRanges[0].getName()); }
리턴
NamedRange[]
- 시트에서 이름이 지정된 모든 범위의 배열입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getParent()
이 시트가 포함된 Spreadsheet
를 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // parent is identical to ss var parent = sheet.getParent();
리턴
Spreadsheet
- 상위 스프레드시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getPivotTables()
이 시트의 모든 피벗 테이블을 반환합니다.
// 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 a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all the pivot table info for the sheet. const pivotTables = sheet.getPivotTables(); // Logs the pivot tables to the console. for (const pivotTable of pivotTables) { console.log(pivotTable.getSourceDataRange().getValues()); }
리턴
PivotTable[]
- 이 시트의 피벗 테이블입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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 sheet = SpreadsheetApp.getActiveSheet(); var protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove sheet protection from the active sheet, if the user has permission to edit it. var sheet = SpreadsheetApp.getActiveSheet(); var protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0]; if (protection && 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(row, column)
지정된 좌표에 왼쪽 상단 셀이 있는 범위를 반환합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Passing only two arguments returns a "range" with a single cell. var range = sheet.getRange(1, 1); var values = range.getValues(); Logger.log(values[0][0]);
매개변수
이름 | 유형 | 설명 |
---|---|---|
row | Integer | 반환할 셀의 행 색인입니다. 행 색인은 1로 시작합니다. |
column | Integer | 반환할 셀의 열 색인입니다. 열 색인 생성은 1로 시작합니다. |
리턴
Range
- 이 셀만 포함하는 범위입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column, numRows)
지정된 좌표에 왼쪽 상단 셀이 있는 범위와 행
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // When the "numRows" argument is used, only a single column of data is returned. var range = sheet.getRange(1, 1, 3); var values = range.getValues(); // Prints 3 values from the first column, starting from row 1. for (var row in values) { for (var col in values[row]) { Logger.log(values[row][col]); } }
매개변수
이름 | 유형 | 설명 |
---|---|---|
row | Integer | 범위의 시작 행 색인입니다. 행 색인은 1로 시작합니다. |
column | Integer | 범위의 열 색인입니다. 열 색인 생성은 1로 시작합니다. |
numRows | Integer | 반환할 행의 개수입니다. |
리턴
Range
- 지정된 행 수의 데이터 열이 포함된 범위입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column, numRows, numColumns)
지정된 수의 행을 사용하여 지정된 좌표의 왼쪽 상단 셀이 있는 범위를 반환합니다. 열입니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange(1, 1, 3, 3); var values = range.getValues(); // Print values from a 3x3 box. for (var row in values) { for (var col in values[row]) { Logger.log(values[row][col]); } }
매개변수
이름 | 유형 | 설명 |
---|---|---|
row | Integer | 범위의 시작 행 색인입니다. 행 색인은 1로 시작합니다. |
column | Integer | 범위의 시작 열 색인입니다. 열 색인 생성은 1로 시작합니다. |
numRows | Integer | 반환할 행의 개수입니다. |
numColumns | Integer | 반환할 열의 개수입니다. |
리턴
Range
- 지정된 영역에 해당하는 범위입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
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
getRowGroup(rowIndex, groupDepth)
지정된 색인과 그룹 깊이의 행 그룹을 반환합니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Returns the group whose control index is at row 2 and has a depth of 1, or // null if the group doesn’t exist. var rowGroup = sheet.getRowGroup(2, 1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowIndex | Integer | 그룹 컨트롤 전환 스위치의 행 색인 또는 그룹 내 색인입니다. |
groupDepth | Integer | 그룹의 깊이입니다. |
리턴
Group
- 대조군 색인 및 깊이의 행 그룹이거나 그룹인 경우 예외가 발생합니다.
존재하지 않습니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupControlPosition()
시트의 모든 행 그룹에 대해 GroupControlTogglePosition
를 반환합니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the row grouping control toggle is shown after the // group. var rowGroupControlPosition = sheet.getRowGroupControlPosition();
리턴
GroupControlTogglePosition
- 이 시트의 그룹 뒤에 행 그룹화 컨트롤 전환 버튼이 표시되는 경우 true
그 외에는 false
입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupDepth(rowIndex)
지정된 색인에서 행의 그룹 깊이를 반환합니다.
그룹 깊이는 행과 겹치는 그룹 수를 나타냅니다. 이 값은 0과 0 사이의 값을 가질 수 있습니다. 여덟 명입니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over rows 1 through 3 var groupDepth = sheet.getRowGroupDepth(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowIndex | Integer | 행의 색인입니다. |
리턴
Integer
- 지정된 색인에 있는 행의 그룹 깊이입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
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
getSlicers()
시트의 슬라이서 배열을 반환합니다.
// 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 a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all slicers in the spreadsheet. const slicers = sheet.getSlicers(); // Logs the slicer titles to the console. for (const slicer of slicers) { console.log(slicer.getTitle()); }
리턴
Slicer[]
- 이 시트의 슬라이서 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTabColorObject()
시트 탭 색상을 가져오거나 시트 탭에 색상이 없는 경우 null
를 가져옵니다.
// This example assumes there is a sheet named "Sheet1" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("Sheet1"); var color = first.getTabColorObject();
리턴
Color
- 시트 탭 색상 또는 시트 탭에 색상이 없는 경우 null
입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getType()
시트의 유형을 반환합니다.
시트의 기본 유형은 SheetType.GRID
입니다. 하나의 삽입된
EmbeddedChart
와 같은 객체는 SheetType.OBJECT
시트입니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getType());
리턴
SheetType
- 시트 유형입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hasHiddenGridlines()
시트의 격자선이 숨겨져 있으면 true
를 반환합니다. 그렇지 않으면 false
를 반환합니다.
격자선은 기본적으로 표시됩니다.
// 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 a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Checks if the spreadsheet has hidden gridelines and logs the result to the console. console.log(sheet.hasHiddenGridlines());
리턴
Boolean
: 격자선이 숨겨져 있는 경우 true
그 외에는 false
입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
hideColumns(columnIndex)
지정된 색인에서 단일 열을 숨깁니다. 이 메서드에는 1-색인을 사용합니다.
색인을 사용하여 둘 이상의 열을 숨기려면 hideColumns(columnIndex, numColumns)
를 사용합니다.
범위를 사용하여 둘 이상의 열을 숨기려면 hideColumn()
를 사용합니다.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // Hides the first column sheet.hideColumns(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnIndex | Integer | 숨길 열의 색인입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex, numColumns)
지정된 색인에서 시작하는 하나 이상의 연속 열을 숨깁니다. 이 메서드에는 1-색인을 사용합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three columns sheet.hideColumns(1, 3);
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnIndex | Integer | 숨길 열의 시작 색인입니다. |
numColumns | Integer | 숨길 열의 개수입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
hideRows(rowIndex)
지정된 색인에서 행을 숨깁니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first row sheet.hideRows(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowIndex | Integer | 숨길 행의 색인입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex, numRows)
지정된 색인에서 시작하는 하나 이상의 연속된 행을 숨깁니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three rows sheet.hideRows(1, 3);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowIndex | Integer | 숨길 행의 시작 색인입니다. |
numRows | Integer | 숨길 행 수입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideSheet()
이 시트를 숨깁니다. 시트가 이미 숨겨져 있으면 아무런 효과가 없습니다. 이 메서드가 표시 시트만 표시하면 예외가 발생합니다.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.hideSheet();
리턴
Sheet
- 현재 시트입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertChart(chart)
이 시트에 새 차트를 추가합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This creates a simple bar chart from the first three rows // of the first two columns of the spreadsheet var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B4")) .setPosition(5, 5, 0, 0) .setOption("title", "Dynamic Chart") .build(); sheet.insertChart(chart);
매개변수
이름 | 유형 | 설명 |
---|---|---|
chart | EmbeddedChart | 삽입할 차트입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
insertColumns(columnIndex)
시트의 지정된 위치에 빈 열을 삽입합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all columns by one sheet.insertColumns(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnIndex | Integer | 열을 삽입할 위치를 나타내는 색인입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex, numColumns)
시트에 지정된 위치에서 시작하여 하나 이상의 빈 열을 연속으로 삽입합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all columns by three sheet.insertColumns(1, 3);
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnIndex | Integer | 열을 삽입할 위치를 나타내는 색인입니다. |
numColumns | Integer | 삽입할 열의 개수입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
insertImage(blobSource, column, row)
문서의 지정된 행과 열에 BlobSource
를 이미지로 삽입합니다. 이미지
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)
문서의 지정된 행과 열에 BlobSource
을
픽셀 오프셋입니다. 이미지 크기는 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
insertRows(rowIndex)
시트의 지정된 위치에 빈 행을 삽입합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all rows down by one sheet.insertRows(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowIndex | Integer | 행을 삽입할 위치를 나타내는 색인입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex, numRows)
지정된 위치에서 시작하는 하나 이상의 빈 행을 시트에 연속으로 삽입합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all rows down by three sheet.insertRows(1, 3);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowIndex | Integer | 행을 삽입할 위치를 나타내는 색인입니다. |
numRows | Integer | 삽입할 행 수입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
insertSlicer(range, anchorRowPos, anchorColPos)
이 시트에 새 슬라이서를 추가합니다.
// 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 a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range of the sheet. const range = sheet.getRange('A1:D10'); // Inserts the slicer with a random range into the sheet. const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10); // Logs the insert slicer result to the console. console.log(insertSlicers);
매개변수
이름 | 유형 | 설명 |
---|---|---|
range | Range | 슬라이서 슬라이서가 생성되는 범위입니다. |
anchorRowPos | Integer | 슬라이서의 상단은 이 행에 고정됩니다. |
anchorColPos | Integer | 슬라이서의 상단은 이 열에 고정됩니다. |
리턴
Slicer
- 새로 삽입된 슬라이서입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)
이 시트에 새 슬라이서를 추가합니다.
// 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 a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range. const range = sheet.getRange('A1:D10'); // Inserts a slicer using the random range function. const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10, 0, 0); // Logs the insert slicer result to the console. console.log(insertSlicers);
매개변수
이름 | 유형 | 설명 |
---|---|---|
range | Range | 슬라이서 슬라이서가 생성되는 범위입니다. |
anchorRowPos | Integer | 슬라이서의 상단은 이 행에 고정됩니다. |
anchorColPos | Integer | 슬라이서의 상단은 이 열에 고정됩니다. |
offsetX | Integer | 셀 모서리로부터의 가로 오프셋(픽셀)입니다. |
offsetY | Integer | 셀 모서리로부터의 세로 오프셋(픽셀)입니다. |
리턴
Slicer
- 새로 삽입된 슬라이서입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
isRightToLeft()
이 시트 레이아웃이 오른쪽에서 왼쪽인 경우 true
를 반환합니다. 시트가 다음과 같으면 false
를 반환합니다.
는 기본 왼쪽에서 오른쪽 레이아웃을 사용합니다.
// 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 a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Checks if a spreadsheet is ordered from right to left and logs the result to the console. console.log(sheet.isRightToLeft());
리턴
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
isSheetHidden()
시트가 현재 숨겨져 있으면 true
를 반환합니다.
var sheet = SpreadsheetApp.getActiveSheet(); if (sheet.isSheetHidden()) { // do something... }
리턴
Boolean
— 시트가 숨겨져 있으면 true
, 시트가 숨겨져 있으면 false
입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveColumns(columnSpec, destinationIndex)
지정된 범위로 선택한 열을 destinationIndex
로 표시된 위치로 이동합니다. columnSpec
자체가 전체
열 또는 열 그룹—범위에 걸쳐 있는 모든 열을 선택합니다.
// The code below moves rows A-B to destination index 5. // This results in those columns becoming columns C-D. var sheet = SpreadsheetApp.getActiveSheet(); // Selects column A and column B to be moved. var columnSpec = sheet.getRange("A1:B1"); sheet.moveColumns(columnSpec, 5);
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnSpec | Range | 이동해야 하는 열에 걸쳐 있는 범위입니다. |
destinationIndex | Integer | 열을 이동해야 하는 색인입니다. 이 색인은 좌표를 기준으로 하는 가중치가 조정됩니다. 기존 데이터는 오른쪽으로 소스 열이 그리드에서 삭제되는 동안 이동한 열을 위한 공간을 확보하세요. 따라서 데이터가 원래 지정된 것과 다른 색인에 있을 수 있습니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveRows(rowSpec, destinationIndex)
지정된 범위로 선택된 행을 destinationIndex
로 표시된 위치로 이동합니다. rowSpec
자체가 전체 행을 정확하게 나타낼 필요는 없습니다.
또는 이동할 행 그룹을 선택합니다. 범위에 속하는 모든 행이 선택됩니다.
// The code below moves rows 1-2 to destination index 5. // This results in those rows becoming rows 3-4. var sheet = SpreadsheetApp.getActiveSheet(); // Selects row 1 and row 2 to be moved. var rowSpec = sheet.getRange("A1:A2"); sheet.moveRows(rowSpec, 5);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowSpec | Range | 이동해야 하는 행에 걸쳐 있는 범위입니다. |
destinationIndex | Integer | 행을 이동해야 하는 색인입니다. 이 색인은 좌표에 따라 가중치를 부여할 수 있습니다. 기존 데이터는 아래로 이동해서 소스 행이 그리드에서 삭제될 때까지 이동된 행을 위한 공간을 확보할 수 있습니다. 따라서 데이터는 원래 지정된 것과 다른 색인에 있을 수 있습니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
newChart()
이 시트의 새 차트를 만드는 빌더를 반환합니다.
다음 예는 새 차트를 만드는 방법을 보여줍니다.
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B8"); var chartBuilder = sheet.newChart(); chartBuilder.addRange(range) .setChartType(Charts.ChartType.LINE) .setPosition(2, 2, 0, 0) .setOption('title', 'My Line Chart!'); sheet.insertChart(chartBuilder.build());
리턴
EmbeddedChartBuilder
- 새 차트를 만드는 빌더입니다.
protect()
다음 권한이 있는 사용자를 제외한 시트가 수정되지 않도록 보호할 수 있는 객체를 만듭니다.
권한을 부여했는지 확인합니다. 스크립트가 시트의 편집자 목록을 실제로 변경하기 전에는
Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
또는 새로 설정
값 Protection.setDomainEdit(editable)
), 권한은
이는 사실상 시트가 보호되지 않는 상태로 남아 있다는 의미입니다. 시트가
이 메서드는 기존 보호 설정을 나타내는 객체를 반환합니다.
보호된 시트에는 보호되지 않는 영역이 포함될 수 있습니다.
// Protect the active sheet, then remove all other users from the list of editors. var sheet = SpreadsheetApp.getActiveSheet(); var protection = sheet.protect().setDescription('Sample protected sheet'); // Ensure the current user is an editor before removing others. Otherwise, if the user's edit // permission comes from a group, the script throws an exception upon removing the group. var me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
리턴
Protection
- 보호 설정을 나타내는 객체입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeChart(chart)
상위 시트에서 차트를 삭제합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This removes all the embedded charts from the spreadsheet var charts = sheet.getCharts(); for (var i in charts) { sheet.removeChart(charts[i]); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
chart | EmbeddedChart | 삭제할 차트입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
setColumnGroupControlPosition(position)
시트에서 열 그룹 컨트롤 전환 버튼의 위치를 설정합니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setColumnGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
매개변수
이름 | 유형 | 설명 |
---|---|---|
position | GroupControlTogglePosition | 열 그룹 컨트롤 전환의 위치입니다. |
리턴
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
setColumnWidths(startColumn, numColumns, width)
지정된 열의 너비를 픽셀 단위로 설정합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three columns to a width of 200 pixels sheet.setColumnWidths(1, 3, 200);
매개변수
이름 | 유형 | 설명 |
---|---|---|
startColumn | Integer | 변경할 시작 열 위치입니다. |
numColumns | Integer | 변경할 열의 개수입니다. |
width | Integer | 설정할 너비입니다(픽셀 단위). |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setConditionalFormatRules(rules)
시트에 있는 기존의 모든 조건부 서식 규칙을 입력 규칙으로 바꿉니다. 규칙은 입력 순서에 따라 평가됩니다.
// Remove one of the existing conditional format rules. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); rules.splice(1, 1); // Deletes the 2nd format rule. sheet.setConditionalFormatRules(rules);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rules | ConditionalFormatRule[] | 새 조건부 서식 규칙 |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
setHiddenGridlines(hideGridlines)
시트 격자선을 숨기거나 표시합니다.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can us eSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Hides the gridlines in the sheet. sheet.setHiddenGridlines(true);
매개변수
이름 | 유형 | 설명 |
---|---|---|
hideGridlines | Boolean | true 인 경우 이 시트에서 격자선을 숨깁니다. 그렇지 않으면
격자선을 탭합니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
시트 이름을 설정합니다.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setName("not first anymore");
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 시트의 새 이름입니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRightToLeft(rightToLeft)
시트 레이아웃을 오른쪽에서 왼쪽으로 설정하거나 설정 해제합니다.
// 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 a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets the sheet layout, so that the sheet is ordered from right to left. sheet.setRightToLeft(true);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rightToLeft | Boolean | true 인 경우 시트 레이아웃이 오른쪽에서 왼쪽으로 설정되고 A1 셀은
을 클릭합니다. false 인 경우 시트 레이아웃이 기본값으로 설정됩니다.
A1 셀을 왼쪽에서 오른쪽으로 이동합니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowGroupControlPosition(position)
시트에서 행 그룹 컨트롤 전환 버튼의 위치를 설정합니다.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setRowGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
매개변수
이름 | 유형 | 설명 |
---|---|---|
position | GroupControlTogglePosition | 행 그룹 컨트롤 전환 버튼의 위치입니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeight(rowPosition, height)
지정된 행의 행 높이를 픽셀 단위로 설정합니다. 기본적으로 행은 셀 콘텐츠에 맞게 확장됩니다. 만약
행을 지정된 높이로 강제 설정하려면 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
setRowHeights(startRow, numRows, height)
지정된 행의 높이를 픽셀 단위로 설정합니다. 기본적으로 행은 셀 콘텐츠에 맞게 확장됩니다. 만약
행을 지정된 높이로 강제 설정하려면 setRowHeightsForced(startRow, numRows, height)
를 사용합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three rows to a height of 20 pixels sheet.setRowHeights(1, 3, 20);
매개변수
이름 | 유형 | 설명 |
---|---|---|
startRow | Integer | 변경할 시작 행 위치입니다. |
numRows | Integer | 변경할 행 수입니다. |
height | Integer | 설정할 높이(픽셀)입니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeightsForced(startRow, numRows, height)
지정된 행의 높이를 픽셀 단위로 설정합니다. 기본적으로 행은 셀 콘텐츠에 맞게 확장됩니다. 날짜
setRowHeightsForced
를 사용하면
셀 콘텐츠의 높이가 행 높이보다 높기 때문입니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three rows to a height of 5 pixels. sheet.setRowHeightsForced(1, 3, 5);
매개변수
이름 | 유형 | 설명 |
---|---|---|
startRow | Integer | 변경할 시작 행 위치입니다. |
numRows | Integer | 변경할 행 수입니다. |
height | Integer | 설정할 높이(픽셀)입니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColor(color)
시트 탭 색상을 설정합니다.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setTabColor("ff0000"); // Set the color to red. first.setTabColor(null); // Unset the color.
매개변수
이름 | 유형 | 설명 |
---|---|---|
color | String | CSS 표기법 (예: '#ffffff' 또는 'white' )의 색상 코드
null : 탭 색상을 재설정합니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColorObject(color)
시트 탭 색상을 설정합니다.
// This example assumes there is a sheet named "Sheet1" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("Sheet1"); var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); first.setTabColorObject(color); // Set the color to theme accent 1. first.setTabColorObject(null); // Unset the color.
매개변수
이름 | 유형 | 설명 |
---|---|---|
color | Color | 설정할 시트 탭 색상입니다. |
리턴
Sheet
- 이 시트는 연결용입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex)
지정된 색인의 열 숨기기를 해제합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first column sheet.showColumns(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnIndex | Integer | 숨기기 해제할 열의 색인입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex, numColumns)
지정된 색인에서 시작하는 하나 이상의 연속된 열을 숨기기 해제합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first three columns sheet.showColumns(1, 3);
매개변수
이름 | 유형 | 설명 |
---|---|---|
columnIndex | Integer | 숨기기 해제할 열의 시작 색인입니다. |
numColumns | Integer | 숨기기 해제할 열의 수입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex)
지정된 색인의 행 숨기기를 해제합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first row sheet.showRows(1);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowIndex | Integer | 숨기기 해제할 행의 색인입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex, numRows)
지정된 색인에서 시작하는 하나 이상의 연속된 행을 숨기기 해제합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first three rows sheet.showRows(1, 3);
매개변수
이름 | 유형 | 설명 |
---|---|---|
rowIndex | Integer | 숨기기 해제할 행의 시작 색인입니다. |
numRows | Integer | 숨기기 해제할 행 수입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showSheet()
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
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
updateChart(chart)
이 시트의 차트를 업데이트합니다.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This code is going to loop through all the charts and change them to // column charts var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; var newChart = chart .modify() .setChartType(Charts.ChartType.COLUMN) .build(); sheet.updateChart(newChart); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
chart | EmbeddedChart | 업데이트할 차트입니다. |
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets