Class NamedRange

Rango con nombre

Crear, acceder y modificar rangos con nombre en una hoja de cálculo Los rangos con nombre son rangos que tienen alias de cadenas asociados. Se pueden ver y editar a través de la IU de Hojas de cálculo en el menú Datos > Rangos nombrados….

Métodos

Método	Tipo de datos que se muestra	Descripción breve
getName()	String	Obtiene el nombre de este rango con nombre.
getRange()	Range	Obtiene el rango al que hace referencia este rango con nombre.
remove()	void	Borra este rango con nombre.
setName(name)	NamedRange	Establece o actualiza el nombre del rango con nombre.
setRange(range)	NamedRange	Establece o actualiza el rango de este rango con nombre.

Documentación detallada

getName()

Obtiene el nombre de este rango con nombre.

Volver

String: Es el nombre de este rango con nombre.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

getRange()

Obtiene el rango al que hace referencia este rango con nombre.

Volver

Range: Es el rango de la hoja de cálculo asociado con este rango con nombre.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

remove()

Borra este rango con nombre.

// 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();
}

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

setName(name)

Establece o actualiza el nombre del rango con nombre.

// The code below updates the name for the first named range.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName('UpdatedNamedRange');
}

Parámetros

Nombre	Tipo	Descripción
name	String	Es el nombre nuevo del rango con nombre.

Volver

NamedRange: Es el rango cuyo nombre se configuró con la llamada.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

setRange(range)

Establece o actualiza el rango de este rango con nombre.

Parámetros

Nombre	Tipo	Descripción
range	Range	Es el rango de la hoja de cálculo que se asociará con este rango con nombre.

Volver

NamedRange: Es el rango con nombre para el que se estableció el rango de la hoja de cálculo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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