Class NamedRange

NamedRange

Permite crear, acceder y modificar rangos con nombre en una hoja de cálculo. Los rangos con nombre son rangos alias de cadena asociados. Se pueden ver y editar en la IU de Hojas de cálculo en la pestaña Datos > Menú Rangos con nombre...

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 alcances:

• 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 a 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 alcances:

• 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.
var namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (var 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 alcances:

• 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.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName("UpdatedNamedRange");
}

Parámetros

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

Volver

NamedRange: Es el rango cuyo nombre estableció la llamada.

Autorización

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

• 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	El rango de la hoja de cálculo que se asociará a 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 alcances:

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