Se usó la API de Cloud Translation para traducir esta página.

Class NamedRange

Un Range que tiene un nombre y un ID para permitir la recuperación más adelante. Los nombres no son necesariamente únicos; varios rangos diferentes en la misma pestaña pueden compartir el mismo nombre, al igual que una clase en HTML. Por el contrario, los IDs son únicos dentro de la pestaña, como un ID en HTML. Una vez que se agrega un NamedRange a una pestaña, no se puede modificar, solo quitar.

Cualquier secuencia de comandos que acceda a la pestaña puede acceder a un NamedRange. Para evitar conflictos imprevistos entre las secuencias de comandos, considera anteponer a los nombres de los rangos una cadena única.

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

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`getId()`	`String`	Obtiene el ID de este `NamedRange`.
`getName()`	`String`	Obtiene el nombre de este `NamedRange`.
`getRange()`	`Range`	Obtiene el rango de elementos asociados con este `NamedRange`.
`remove()`	`void`	Quita este `NamedRange` de la pestaña.

Documentación detallada

`getId()`

Obtiene el ID de este NamedRange. El ID es único dentro de la pestaña.

Volver

String: Es el ID del rango, que es único dentro de la pestaña.

`getName()`

Obtiene el nombre de este NamedRange. El nombre no tiene por qué ser único.

Volver

String: Es el nombre del rango, que no es necesariamente único.

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/documents.currentonly
https://www.googleapis.com/auth/documents

`getRange()`

Obtiene el rango de elementos asociados con este NamedRange.

Volver

Range: Es el rango de elementos asociados con el nombre y el ID.

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/documents.currentonly
https://www.googleapis.com/auth/documents

`remove()`

Quita este NamedRange de la pestaña. Este método no borra el contenido del rango, solo quita la referencia. Llamar a este método en un NamedRange que ya se quitó no tiene ningún efecto.

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/documents.currentonly
https://www.googleapis.com/auth/documents