Class NamedRange

NamedRange

나중에 검색할 수 있는 이름과 ID가 있는 Range입니다. 이름은 고유합니다. 같은 탭에 있는 여러 다른 범위는 클래스에 대해 자세히 알아보세요. 반대로 ID는 HTML의 ID처럼 탭 내에서 고유합니다. NamedRange을 탭에 추가하면 수정할 수 없고 삭제만 됩니다.

NamedRange는 탭에 액세스하는 모든 스크립트에서 액세스할 수 있습니다. 의도치 않은 상황을 방지하기 위해 충돌하지 않는 경우 범위 이름 앞에 고유한 문자열을 사용하는 것이 좋습니다. 

// Create a named range that includes every table in the active tab.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());

메서드

메서드반환 유형간략한 설명
getId()String이 NamedRange의 ID를 가져옵니다.
getName()String이 NamedRange의 이름을 가져옵니다.
getRange()Range이 NamedRange와 연결된 요소의 범위를 가져옵니다.
remove()void탭에서 이 NamedRange를 삭제합니다.

자세한 문서

getId()

이 NamedRange의 ID를 가져옵니다. ID는 탭 내에서 고유합니다.

리턴

String - 범위 ID로, 탭 내에서 고유합니다.

getName()

이 NamedRange의 이름을 가져옵니다. 이름은 반드시 고유하지는 않습니다.

리턴

String - 범위 이름으로, 반드시 고유하지는 않습니다.

승인

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

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

getRange()

이 NamedRange와 연결된 요소의 범위를 가져옵니다.

리턴

Range - 이름 및 ID와 연결된 요소의 범위입니다.

승인

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

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

remove()

탭에서 이 NamedRange를 삭제합니다. 이 메서드는 범위; 단지 참조를 삭제할 뿐입니다. NamedRange에서 이 메서드를 호출하면 이미 삭제되어도 아무런 효력이 없습니다.

승인

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

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