Class NamedRange

이름이지정된 범위

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

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

리턴

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.
const namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (let 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.
const 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