스프레드시트에서 이름이 지정된 범위를 만들고 액세스하고 수정합니다. 이름이 지정된 범위는 연관된 문자열 별칭이 있는 범위입니다. 범위 이름은 Sheets UI의 데이터 > 이름이 지정된 범위... 메뉴에서 보고 수정할 수 있습니다.
방법
| 메서드 | 반환 유형 | 간략한 설명 |
|---|---|---|
getName() | String | 이 이름이 지정된 범위의 이름을 가져옵니다. |
getRange() | Range | 이 이름이 지정된 범위에서 참조되는 범위를 가져옵니다. |
remove() | void | 이 이름이 지정된 범위를 삭제합니다. |
setName(name) | NamedRange | 이름이 지정된 범위의 이름을 설정/업데이트합니다. |
setRange(range) | NamedRange | 이 이름이 지정된 범위의 범위를 설정/업데이트합니다. |
자세한 문서
getName()
이 이름이 지정된 범위의 이름을 가져옵니다.
리턴
String: 이 이름이 지정된 범위의 이름
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getRange()
remove()
이 이름이 지정된 범위를 삭제합니다.
// The code below deletes all the named ranges in the spreadsheet.
var namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
namedRanges[i].remove();
}
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setName(name)
이름이 지정된 범위의 이름을 설정/업데이트합니다.
// The code below updates the name for the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
namedRanges[0].setName("UpdatedNamedRange");
}
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
name | String | 이름이 지정된 범위의 새 이름입니다. |
리턴
NamedRange: 호출로 이름이 설정된 범위
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setRange(range)
이 이름이 지정된 범위의 범위를 설정/업데이트합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
range | Range | 이 이름이 지정된 범위와 연결할 스프레드시트 범위입니다. |
리턴
NamedRange: 스프레드시트 범위가 설정된 이름이 지정된 범위
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets