Class NamedRange

NamedRange

스프레드시트에서 이름이 지정된 범위를 만들고 액세스하고 수정할 수 있습니다. 이름이 지정된 범위는 관련 문자열 별칭입니다. 스프레드시트 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()

이 이름이 지정된 범위에서 참조하는 범위를 가져옵니다.

리턴

Range: 이름이 지정된 범위와 연결된 스프레드시트 범위

승인

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

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

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");
}

매개변수

이름유형설명
nameString이름이 지정된 범위의 새 이름입니다.

리턴

NamedRange: 호출로 이름이 설정된 범위

승인

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

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

setRange(range)

이름이 지정된 범위의 범위를 설정하거나 업데이트합니다.

매개변수

이름유형설명
rangeRange이름이 지정된 범위와 연결할 스프레드시트 범위입니다.

리턴

NamedRange: 스프레드시트 범위가 설정된 이름이 지정된 범위입니다.

승인

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

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