Class NamedRange

Именованный диапазон

Создавайте, получайте доступ и изменяйте именованные диапазоны в электронной таблице. Именованные диапазоны — это диапазоны, которым присвоены псевдонимы строк. Их можно просматривать и редактировать через пользовательский интерфейс Таблиц в меню Данные > Именованные диапазоны....

Методы

Метод Тип возврата Краткое описание
get Name() String Получает имя этого именованного диапазона.
get Range() Range Получает диапазон, на который ссылается этот именованный диапазон.
remove() void Удаляет этот именованный диапазон.
set Name(name) Named Range Устанавливает/обновляет имя именованного диапазона.
set Range(range) Named Range Устанавливает/обновляет диапазон для этого именованного диапазона.

Подробная документация

get Name()

Получает имя этого именованного диапазона.

Возвращаться

String — имя этого именованного диапазона.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Range()

Получает диапазон, на который ссылается этот именованный диапазон.

Возвращаться

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

set Name(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');
}

Параметры

Имя Тип Описание
name String Новое имя именованного диапазона.

Возвращаться

Named Range — диапазон, имя которого было задано вызовом.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

set Range(range)

Устанавливает/обновляет диапазон для этого именованного диапазона.

Параметры

Имя Тип Описание
range Range Диапазон электронной таблицы, который необходимо связать с этим именованным диапазоном.

Возвращаться

Named Range — именованный диапазон, для которого был установлен диапазон электронной таблицы.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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