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

Class Range

Permite acceder a rangos de la hoja de cálculo y modificarlos. Un rango puede ser una sola celda en una hoja o un grupo de celdas adyacentes de una hoja.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`activate()`	`Range`	Establece el rango especificado como `active range`, con la parte superior. celda izquierda del rango como `current cell`.
`activateAsCurrentCell()`	`Range`	Establece la celda especificada como `current cell`.
`addDeveloperMetadata(key)`	`Range`	Agrega metadatos del desarrollador con la clave especificada al rango.
`addDeveloperMetadata(key, visibility)`	`Range`	Agrega metadatos del desarrollador con la clave y la visibilidad especificadas al rango.
`addDeveloperMetadata(key, value)`	`Range`	Agrega metadatos del desarrollador con la clave y el valor especificados al rango.
`addDeveloperMetadata(key, value, visibility)`	`Range`	Agrega metadatos del desarrollador con la clave, el valor y la visibilidad especificados al rango.
`applyColumnBanding()`	`Banding`	Aplica un tema de bandas de columnas predeterminado al rango.
`applyColumnBanding(bandingTheme)`	`Banding`	Aplica un tema de banda de columnas específico al rango.
`applyColumnBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Aplica un tema de banda de columnas específico al rango con el encabezado y el pie de página especificados configuración.
`applyRowBanding()`	`Banding`	Aplica un tema predeterminado de banda de filas al rango.
`applyRowBanding(bandingTheme)`	`Banding`	Aplica un tema de banda de filas específico al rango.
`applyRowBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Aplica un tema específico de banda de filas al rango con la configuración especificada de encabezado y pie de página.
`autoFill(destination, series)`	`void`	Completa el `destinationRange` con datos basados en los datos de este rango.
`autoFillToNeighbor(series)`	`void`	Calcula un rango para completar con datos nuevos en función de celdas vecinas y rellena automáticamente que varían con valores nuevos basados en los datos contenidos en ese rango.
`breakApart()`	`Range`	Vuelve a dividir en celdas individuales las celdas de varias columnas del rango.
`canEdit()`	`Boolean`	Determina si el usuario tiene permiso para editar todas las celdas del rango.
`check()`	`Range`	Cambia el estado de las casillas de verificación del rango a “marcado”.
`clear()`	`Range`	Borra el rango de contenido y formatos.
`clear(options)`	`Range`	Borra el rango de contenidos, el formato, las reglas de validación de datos o los comentarios, como se especifica con las opciones avanzadas indicadas.
`clearContent()`	`Range`	Borra el contenido del rango y deja el formato intacto.
`clearDataValidations()`	`Range`	Borra las reglas de validación de datos del rango.
`clearFormat()`	`Range`	Borra el formato de este rango.
`clearNote()`	`Range`	Borra la nota en una o varias celdas específicas.
`collapseGroups()`	`Range`	Contrae todos los grupos contenidos por completo dentro del rango.
`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Copia el formato del rango en la ubicación especificada.
`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Copia el formato del rango en la ubicación especificada.
`copyTo(destination)`	`void`	Copia los datos de un rango de celdas a otro rango de celdas.
`copyTo(destination, copyPasteType, transposed)`	`void`	Copia los datos de un rango de celdas a otro rango de celdas.
`copyTo(destination, options)`	`void`	Copia los datos de un rango de celdas a otro rango de celdas.
`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Copia el contenido del rango en la ubicación especificada.
`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Copia el contenido del rango en la ubicación especificada.
`createDataSourcePivotTable(dataSource)`	`DataSourcePivotTable`	Crea una tabla dinámica de fuente de datos vacía a partir de la fuente de datos, anclada en la primera celda de este rango.
`createDataSourceTable(dataSource)`	`DataSourceTable`	Crea una tabla de fuente de datos vacía a partir de la fuente de datos, anclada en la primera celda de esta del rango de destino de la ruta.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Muestra una DeveloperMetadataFinderApi para encontrar metadatos del desarrollador dentro del alcance de este. del rango de destino de la ruta.
`createFilter()`	`Filter`	Crea un filtro y lo aplica al rango especificado en la hoja.
`createPivotTable(sourceData)`	`PivotTable`	Crea una tabla dinámica vacía a partir del `sourceData` especificado anclado en la primera celda en este rango.
`createTextFinder(findText)`	`TextFinder`	Crea un buscador de texto para el intervalo, que puede buscar y reemplazar texto.
`deleteCells(shiftDimension)`	`void`	Elimina este rango de celdas.
`expandGroups()`	`Range`	Expande los grupos contraídos cuyo rango o botón de activación de control se cruza con este rango.
`getA1Notation()`	`String`	Muestra una descripción de cadena del rango, en notación A1.
`getBackground()`	`String`	Muestra el color de fondo de la celda superior izquierda del rango (por ejemplo, `'#ffffff'`).
`getBackgroundObject()`	`Color`	Muestra el color de fondo de la celda superior izquierda del rango.
`getBackgroundObjects()`	`Color[][]`	Devuelve los colores de fondo de las celdas en el rango.
`getBackgrounds()`	`String[][]`	Muestra los colores de fondo de las celdas en el rango (por ejemplo, `'#ffffff'`).
`getBandings()`	`Banding[]`	Muestra todas las bandas que se aplican a cualquier celda en este rango.
`getCell(row, column)`	`Range`	Muestra una celda determinada dentro de un rango.
`getColumn()`	`Integer`	Muestra la posición de la columna inicial para este rango.
`getDataRegion()`	`Range`	Muestra una copia del rango expandido en los cuatro `Direction` cardinales para abarcar todo celdas adyacentes con datos.
`getDataRegion(dimension)`	`Range`	Muestra una copia del rango expandido `Direction.UP` y `Direction.DOWN` si el la dimensión especificada es `Dimension.ROWS` o `Direction.NEXT` y `Direction.PREVIOUS` si la dimensión es `Dimension.COLUMNS`.
`getDataSourceFormula()`	`DataSourceFormula`	Muestra el `DataSourceFormula` para la primera celda en el rango o `null` si la celda no contiene una fórmula de fuente de datos.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Muestra los `DataSourceFormula` de las celdas en el rango.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Obtiene todas las tablas dinámicas de la fuente de datos que se cruzan con el rango.
`getDataSourceTables()`	`DataSourceTable[]`	Obtiene todas las tablas de fuentes de datos que se cruzan con el rango.
`getDataSourceUrl()`	`String`	Muestra una URL para los datos de este rango, que se puede usar para crear gráficos y consultas.
`getDataTable()`	`DataTable`	Muestra los datos dentro de este objeto como una DataTable.
`getDataTable(firstRowIsHeader)`	`DataTable`	Muestra los datos dentro de este rango como una DataTable.
`getDataValidation()`	`DataValidation`	Devuelve la regla de validación de datos para la celda superior izquierda del rango.
`getDataValidations()`	`DataValidation[][]`	Devuelve las reglas de validación de datos para todas las celdas del rango.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Obtiene los metadatos del programador asociados con este rango.
`getDisplayValue()`	`String`	Muestra el valor que se muestra de la celda superior izquierda del rango.
`getDisplayValues()`	`String[][]`	Muestra la cuadrícula rectangular de los valores de este rango.
`getFilter()`	`Filter`	Muestra el filtro en la hoja a la que pertenece este rango, o `null` si no hay ningún filtro en la hoja.
`getFontColorObject()`	`Color`	Muestra el color de fuente de la celda en la esquina superior izquierda del rango.
`getFontColorObjects()`	`Color[][]`	Muestra los colores de fuente de las celdas en el rango.
`getFontFamilies()`	`String[][]`	Muestra las familias de fuentes de las celdas del rango.
`getFontFamily()`	`String`	Muestra la familia de fuentes de la celda de la esquina superior izquierda del rango.
`getFontLine()`	`String`	Obtiene el estilo de línea de la celda en la esquina superior izquierda del rango (`'underline'`, `'line-through'` o `'none'`).
`getFontLines()`	`String[][]`	Obtiene el estilo de línea de las celdas del rango (`'underline'`, `'line-through'` o `'none'`).
`getFontSize()`	`Integer`	Muestra el tamaño de fuente en tamaño de punto de la celda en la esquina superior izquierda del rango.
`getFontSizes()`	`Integer[][]`	Muestra los tamaños de fuente de las celdas del rango.
`getFontStyle()`	`String`	Devuelve el estilo de fuente (`'italic'` o `'normal'`) de la celda en la parte superior izquierda. en la esquina superior del rango.
`getFontStyles()`	`String[][]`	Muestra los estilos de fuente de las celdas del rango.
`getFontWeight()`	`String`	Muestra el grosor de la fuente (normal/negrita) de la celda ubicada en la esquina superior izquierda del rango.
`getFontWeights()`	`String[][]`	Muestra el peso de la fuente de las celdas en el rango.
`getFormula()`	`String`	Devuelve la fórmula (notación A1) para la celda superior izquierda del rango, o una cadena vacía si el está vacía o no contiene ninguna fórmula.
`getFormulaR1C1()`	`String`	Muestra la fórmula (notación R1C1) para una celda determinada o `null` si no hay ninguna.
`getFormulas()`	`String[][]`	Muestra las fórmulas (notación A1) para las celdas en el rango.
`getFormulasR1C1()`	`String[][]`	Muestra las fórmulas (notación R1C1) para las celdas en el rango.
`getGridId()`	`Integer`	Muestra el ID de la cuadrícula de la hoja superior del rango.
`getHeight()`	`Integer`	Muestra la altura del rango.
`getHorizontalAlignment()`	`String`	Devuelve la alineación horizontal del texto (izquierda/centro/derecha) de la celda en la parte superior izquierda. en la esquina superior del rango.
`getHorizontalAlignments()`	`String[][]`	Muestra las alineaciones horizontales de las celdas en el rango.
`getLastColumn()`	`Integer`	Muestra la posición de la columna final.
`getLastRow()`	`Integer`	Muestra la posición de la fila final.
`getMergedRanges()`	`Range[]`	Muestra un array de objetos `Range` que representan celdas combinadas que están completas. dentro del rango actual o contener al menos una celda en el rango actual.
`getNextDataCell(direction)`	`Range`	Comenzando en la celda de la primera columna y fila del rango, devuelve la siguiente celda en la dirección determinada que es el borde de un rango contiguo de celdas con datos o la celda en el borde de la hoja de cálculo en esa dirección.
`getNote()`	`String`	Muestra la nota asociada al rango especificado.
`getNotes()`	`String[][]`	Devuelve las notas asociadas con las celdas del rango.
`getNumColumns()`	`Integer`	Muestra el número de columnas en este rango.
`getNumRows()`	`Integer`	Muestra el número de filas en este rango.
`getNumberFormat()`	`String`	Obtiene el formato de número o de fecha de la celda superior izquierda del rango especificado.
`getNumberFormats()`	`String[][]`	Muestra los formatos de número o fecha de las celdas del rango.
`getRichTextValue()`	`RichTextValue`	Muestra el valor de texto enriquecido de la celda superior izquierda del rango o `null` si la celda el valor no es texto.
`getRichTextValues()`	`RichTextValue[][]`	Devuelve los valores de texto enriquecido para las celdas en el rango.
`getRow()`	`Integer`	Muestra la posición de la fila para este rango.
`getRowIndex()`	`Integer`	Muestra la posición de la fila para este rango.
`getSheet()`	`Sheet`	Muestra la hoja a la que pertenece este rango.
`getTextDirection()`	`TextDirection`	Muestra la dirección del texto de la celda superior izquierda del rango.
`getTextDirections()`	`TextDirection[][]`	Devuelve las instrucciones de texto para las celdas en el rango.
`getTextRotation()`	`TextRotation`	Muestra la configuración de rotación de texto de la celda superior izquierda del rango.
`getTextRotations()`	`TextRotation[][]`	Muestra la configuración de rotación de texto de las celdas en el rango.
`getTextStyle()`	`TextStyle`	Muestra el estilo de texto de la celda superior izquierda del rango.
`getTextStyles()`	`TextStyle[][]`	Muestra los estilos de texto de las celdas del rango.
`getValue()`	`Object`	Muestra el valor de la celda superior izquierda del rango.
`getValues()`	`Object[][]`	Muestra la cuadrícula rectangular de los valores de este rango.
`getVerticalAlignment()`	`String`	Devuelve la alineación vertical (parte superior/central/inferior) de la celda en la esquina superior izquierda de del rango de destino de la ruta.
`getVerticalAlignments()`	`String[][]`	Muestra las alineaciones verticales de las celdas en el rango.
`getWidth()`	`Integer`	Muestra el ancho del rango en columnas.
`getWrap()`	`Boolean`	Muestra si se ajusta el texto de la celda.
`getWrapStrategies()`	`WrapStrategy[][]`	Muestra las estrategias de ajuste de texto para las celdas del rango.
`getWrapStrategy()`	`WrapStrategy`	Muestra la estrategia de ajuste de texto para la celda superior izquierda del rango.
`getWraps()`	`Boolean[][]`	Muestra si se ajusta el texto de las celdas.
`insertCells(shiftDimension)`	`Range`	Inserta celdas vacías en este rango.
`insertCheckboxes()`	`Range`	Inserta casillas de verificación en cada celda del rango, configuradas con `true` para elementos marcados y `false` para elementos desmarcados.
`insertCheckboxes(checkedValue)`	`Range`	Inserta casillas de verificación en cada celda del rango configuradas con un valor personalizado para las celdas marcadas y la cadena vacía es desmarcada.
`insertCheckboxes(checkedValue, uncheckedValue)`	`Range`	Inserta casillas de verificación en cada celda del rango configuradas con valores personalizados para las casillas marcadas. y sin marcar.
`isBlank()`	`Boolean`	Muestra `true` si el rango está completamente en blanco.
`isChecked()`	`Boolean`	Muestra si todas las celdas del rango tienen su estado de casilla de verificación como "marcado".
`isEndColumnBounded()`	`Boolean`	Determina si el final del rango está vinculado a una columna en particular.
`isEndRowBounded()`	`Boolean`	Determina si el final del rango está vinculado a una fila en particular.
`isPartOfMerge()`	`Boolean`	Muestra `true` si las celdas del rango actual se superponen con alguna celda combinada.
`isStartColumnBounded()`	`Boolean`	Determina si el inicio del rango está vinculado a una columna en particular.
`isStartRowBounded()`	`Boolean`	Determina si el inicio del rango está vinculado a una fila en particular.
`merge()`	`Range`	Combina las celdas del rango en un solo bloque.
`mergeAcross()`	`Range`	Combina las celdas del rango en las columnas del rango.
`mergeVertically()`	`Range`	Combina las celdas en el rango.
`moveTo(target)`	`void`	Corta y pega (tanto el formato como los valores) de este rango en el rango objetivo.
`offset(rowOffset, columnOffset)`	`Range`	Devuelve un nuevo rango que se desplaza de este rango por el número dado de filas y columnas (que puede ser negativo).
`offset(rowOffset, columnOffset, numRows)`	`Range`	Devuelve un nuevo rango relativo al rango actual, cuyo punto superior izquierdo está desplazado. del rango actual por las filas y columnas determinadas, y con la altura determinada en las celdas.
`offset(rowOffset, columnOffset, numRows, numColumns)`	`Range`	Devuelve un nuevo rango relativo al rango actual, cuyo punto superior izquierdo está desplazado. del rango actual por las filas y columnas determinadas, y con la altura y el ancho dados celdas.
`protect()`	`Protection`	Crea un objeto que puede proteger el rango para que no se pueda editar, excepto por los usuarios que tengan permiso.
`randomize()`	`Range`	Aleatoriza el orden de las filas en el rango determinado.
`removeCheckboxes()`	`Range`	Quita todas las casillas de verificación del rango.
`removeDuplicates()`	`Range`	Elimina las filas dentro de este rango que contienen valores que son duplicados de valores en cualquier fila anterior.
`removeDuplicates(columnsToCompare)`	`Range`	Quita las filas dentro de este rango que contienen valores duplicados en las columnas especificadas de valores de cualquier fila anterior.
`setBackground(color)`	`Range`	Establece el color de fondo de todas las celdas del rango en notación CSS (como `'#ffffff'`). o `'white'`).
`setBackgroundObject(color)`	`Range`	Establece el color de fondo de todas las celdas del rango.
`setBackgroundObjects(color)`	`Range`	Establece una cuadrícula rectangular de los colores de fondo (debe coincidir con las dimensiones de este rango).
`setBackgroundRGB(red, green, blue)`	`Range`	Establece el fondo en el color determinado mediante valores RGB (números enteros entre 0 y 255 inclusive).
`setBackgrounds(color)`	`Range`	Establece una cuadrícula rectangular de los colores de fondo (debe coincidir con las dimensiones de este rango).
`setBorder(top, left, bottom, right, vertical, horizontal)`	`Range`	Establece la propiedad del borde.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`Range`	Establece la propiedad de borde con color o estilo.
`setDataValidation(rule)`	`Range`	Establece una regla de validación de datos para todas las celdas del rango.
`setDataValidations(rules)`	`Range`	Establece las reglas de validación de datos para todas las celdas del rango.
`setFontColor(color)`	`Range`	Establece el color de la fuente en la notación CSS (como `'#ffffff'` o `'white'`).
`setFontColorObject(color)`	`Range`	Establece el color de fuente del rango especificado.
`setFontColorObjects(colors)`	`Range`	Establece una cuadrícula rectangular de los colores de fuente (debe coincidir con las dimensiones de este rango).
`setFontColors(colors)`	`Range`	Establece una cuadrícula rectangular de los colores de fuente (debe coincidir con las dimensiones de este rango).
`setFontFamilies(fontFamilies)`	`Range`	Establece una cuadrícula rectangular de las familias de fuentes (debe coincidir con las dimensiones de este rango).
`setFontFamily(fontFamily)`	`Range`	Configura la familia de fuentes, como "Arial". o "Helvetica".
`setFontLine(fontLine)`	`Range`	Establece el estilo de línea de fuente de un rango determinado (`'underline'`, `'line-through'` o `'none'`).
`setFontLines(fontLines)`	`Range`	Establece una cuadrícula rectangular de los estilos de línea (debe coincidir con las dimensiones de este rango).
`setFontSize(size)`	`Range`	Establece el tamaño de fuente, que corresponde al tamaño de punto que se usará.
`setFontSizes(sizes)`	`Range`	Establece una cuadrícula rectangular de los tamaños de fuente (debe coincidir con las dimensiones de este rango).
`setFontStyle(fontStyle)`	`Range`	Establece el estilo de fuente para el rango especificado (`'italic'` o `'normal'`).
`setFontStyles(fontStyles)`	`Range`	Establece una cuadrícula rectangular de estilos de fuente (debe coincidir con las dimensiones de este rango).
`setFontWeight(fontWeight)`	`Range`	Define el grosor de la fuente para el rango especificado (normal/negrita).
`setFontWeights(fontWeights)`	`Range`	Establece una cuadrícula rectangular de los tamaños de fuente (debe coincidir con las dimensiones de este rango).
`setFormula(formula)`	`Range`	Actualiza la fórmula de este rango.
`setFormulaR1C1(formula)`	`Range`	Actualiza la fórmula de este rango.
`setFormulas(formulas)`	`Range`	Establece una cuadrícula rectangular de fórmulas (debe coincidir con las dimensiones de este rango).
`setFormulasR1C1(formulas)`	`Range`	Establece una cuadrícula rectangular de fórmulas (debe coincidir con las dimensiones de este rango).
`setHorizontalAlignment(alignment)`	`Range`	Establece la alineación horizontal (de izquierda a derecha) para el rango determinado (izquierda/centro/derecha).
`setHorizontalAlignments(alignments)`	`Range`	Establece una cuadrícula rectangular de alineaciones horizontales.
`setNote(note)`	`Range`	Establece la nota en el valor dado.
`setNotes(notes)`	`Range`	Establece una cuadrícula rectangular de notas (debe coincidir con las dimensiones de este rango).
`setNumberFormat(numberFormat)`	`Range`	Establece el formato de número o fecha en la cadena de formato especificada.
`setNumberFormats(numberFormats)`	`Range`	Establece una cuadrícula rectangular en formato de número o fecha (debe coincidir con las dimensiones de este período).
`setRichTextValue(value)`	`Range`	Establece el valor de texto enriquecido para las celdas en el rango.
`setRichTextValues(values)`	`Range`	Establece una cuadrícula rectangular de los valores de texto enriquecido.
`setShowHyperlink(showHyperlink)`	`Range`	Establece si el rango debe mostrar hipervínculos o no.
`setTextDirection(direction)`	`Range`	Establece la dirección del texto de las celdas en el rango.
`setTextDirections(directions)`	`Range`	Establece una cuadrícula rectangular de las direcciones de texto.
`setTextRotation(degrees)`	`Range`	Establece la configuración de rotación de texto de las celdas del rango.
`setTextRotation(rotation)`	`Range`	Establece la configuración de rotación de texto de las celdas del rango.
`setTextRotations(rotations)`	`Range`	Establece una cuadrícula rectangular de las rotaciones de texto.
`setTextStyle(style)`	`Range`	Establece el estilo de texto para las celdas del rango.
`setTextStyles(styles)`	`Range`	Establece una cuadrícula rectangular de estilos de texto.
`setValue(value)`	`Range`	Establece el valor del rango.
`setValues(values)`	`Range`	Establece una cuadrícula rectangular de valores (debe coincidir con las dimensiones de este rango).
`setVerticalAlignment(alignment)`	`Range`	Establece la alineación vertical (de arriba a abajo) para el rango especificado (parte superior/medio/inferior).
`setVerticalAlignments(alignments)`	`Range`	Establece una cuadrícula rectangular de alineamientos verticales (debe coincidir con las dimensiones de este rango).
`setVerticalText(isVertical)`	`Range`	Establece si se apilan o no el texto de las celdas del rango.
`setWrap(isWrapEnabled)`	`Range`	Configura la unión de celdas para el rango determinado.
`setWrapStrategies(strategies)`	`Range`	Establece una cuadrícula rectangular de las estrategias de ajuste.
`setWrapStrategy(strategy)`	`Range`	Establece la estrategia de ajuste de texto para las celdas del rango.
`setWraps(isWrapEnabled)`	`Range`	Establece una cuadrícula rectangular de las políticas de ajuste de palabra (debe coincidir con las dimensiones de este rango).
`shiftColumnGroupDepth(delta)`	`Range`	Cambia la profundidad de agrupamiento de columnas del rango según la cantidad especificada.
`shiftRowGroupDepth(delta)`	`Range`	Cambia la profundidad de agrupación de filas del rango en la cantidad especificada.
`sort(sortSpecObj)`	`Range`	Ordena las celdas en el rango dado, por columna y orden especificados.
`splitTextToColumns()`	`void`	Divide una columna de texto en varias columnas según un delimitador detectado automáticamente.
`splitTextToColumns(delimiter)`	`void`	Divide una columna de texto en varias columnas con la cadena especificada como delimitador personalizado.
`splitTextToColumns(delimiter)`	`void`	Divide una columna de texto en varias columnas según el delimitador especificado.
`trimWhitespace()`	`Range`	Corta los espacios en blanco (como espacios, tabulaciones o líneas nuevas) en todas las celdas de este rango.
`uncheck()`	`Range`	Cambia el estado de las casillas de verificación del rango a "desmarcado".

Métodos obsoletos

Método	Tipo de datos que se muestra	Descripción breve
`getFontColor()`	`String`	Devuelve el color de fuente de la celda en la esquina superior izquierda del rango, en notación CSS (como como `'#ffffff'` o `'white'`).
`getFontColors()`	`String[][]`	Devuelve los colores de fuente de las celdas en el rango en notación CSS (como `'#ffffff'` o `'white'`).

Documentación detallada

`activate()`

Establece el rango especificado como active range, con la parte superior. celda izquierda del rango como current cell.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:D10');
range.activate();

var selection = sheet.getSelection();
// Current cell: A1
var currentCell = selection.getCurrentCell();
// Active Range: A1:D10
var activeRange = selection.getActiveRange();

Volver

Range: Este rango para el encadenamiento.

`activateAsCurrentCell()`

Establece la celda especificada como current cell.

Si la celda especificada se encuentra en un rango existente, ese rango se convierte en el activo. rango con la celda como celda actual.

Si la celda especificada no está presente en ningún rango existente, entonces la selección existente es y la celda se convierte en la celda actual y en el rango activo.

Nota: El Range especificado debe constar de una celda; de lo contrario, arrojará un excepción.

// Gets the first sheet of the spreadsheet.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];

// Gets the cell B5 and sets it as the active cell.
var range = sheet.getRange('B5');
var currentCell = range.activateAsCurrentCell();

// Logs the activated cell.
console.log(currentCell.getA1Notation());

Volver

Range: Este rango para el encadenamiento.

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

`addDeveloperMetadata(key)`

Agrega metadatos del desarrollador con la clave especificada al rango.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' to the developer metadata for row 2.
range.addDeveloperMetadata('NAME');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());

Parámetros

Nombre	Tipo	Descripción
`key`	`String`	La clave para los nuevos metadatos del desarrollador.

Volver

Range: Este rango para el encadenamiento.

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

`addDeveloperMetadata(key, visibility)`

Agrega metadatos del desarrollador con la clave y la visibilidad especificadas al rango.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT'
// for row 2 on Sheet1.
range.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getVisibility().toString());

Parámetros

Nombre	Tipo	Descripción
`key`	`String`	La clave para los nuevos metadatos del desarrollador.
`visibility`	`DeveloperMetadataVisibility`	La visibilidad de los nuevos metadatos del desarrollador

Volver

Range: Este rango para el encadenamiento.

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

`addDeveloperMetadata(key, value)`

Agrega metadatos del desarrollador con la clave y el valor especificados al rango.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 of Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());

Parámetros

Nombre	Tipo	Descripción
`key`	`String`	La clave para los nuevos metadatos del desarrollador.
`value`	`String`	El valor de los nuevos metadatos del desarrollador.

Volver

Range: Este rango para el encadenamiento.

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

`addDeveloperMetadata(key, value, visibility)`

Agrega metadatos del desarrollador con la clave, el valor y la visibilidad especificados al rango.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to PROJECT for row 2 on the sheet.
range.addDeveloperMetadata(
  'NAME',
  'GOOGLE',
  SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

Parámetros

Nombre	Tipo	Descripción
`key`	`String`	La clave para los nuevos metadatos del desarrollador.
`value`	`String`	El valor de los nuevos metadatos del desarrollador.
`visibility`	`DeveloperMetadataVisibility`	La visibilidad de los nuevos metadatos del desarrollador

Volver

Range: Este rango para el encadenamiento.

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

`applyColumnBanding()`

Aplica un tema de bandas de columnas predeterminado al rango. De forma predeterminada, las bandas tienen encabezado y no color del pie de página.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies column banding to row 2.
const colBanding = range.applyColumnBanding();

// Gets the first banding on the sheet and logs the color of the header column.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject().asRgbColor().asHexString());

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

Volver

Banding: Las nuevas bandas.

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

`applyColumnBanding(bandingTheme)`

Aplica un tema de bandas de columnas específico al rango. De forma predeterminada, las bandas tienen encabezado y sin color de pie de página.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies the INDIGO color banding theme to the columns in row 2.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

Parámetros

Nombre	Tipo	Descripción
`bandingTheme`	`BandingTheme`	Un tema de color para aplicar a las columnas del rango.

Volver

Banding: Las nuevas bandas.

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

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

Aplica un tema de banda de columnas específico al rango con el encabezado y el pie de página especificados configuración.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 12-22 on the sheet.
const range = sheet.getRange('12:22');

// Applies the BLUE color banding theme to rows 12-22.
// Sets the header visibility to false and the footer visibility to true.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.BLUE, false, true);

// Gets the banding color and logs it to the console.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

// Gets the header color object and logs it to the console. Returns null because the header
// visibility is set to false.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject());

// Gets the footer color and logs it to the console.
console.log(sheet.getBandings()[0].getFooterColumnColorObject().asRgbColor().asHexString());

Parámetros

Nombre	Tipo	Descripción
`bandingTheme`	`BandingTheme`	Un tema de color para aplicar a las columnas del rango.
`showHeader`	`Boolean`	Si es `true`, el color del encabezado del tema de bandas se aplica al primer .
`showFooter`	`Boolean`	Si es `true`, el color del pie de página del tema de bandas se aplica al último .

Volver

Banding: Las nuevas bandas.

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

`applyRowBanding()`

Aplica un tema predeterminado de banda de filas al rango. De forma predeterminada, las bandas tienen encabezado y no color del pie de página.

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies row banding to rows 1-30.
range.applyRowBanding();

// Gets the hex color of the second banded row.
const secondRowColor = range.getBandings()[0]
                            .getSecondRowColorObject()
                            .asRgbColor()
                            .asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

Volver

Banding: Las bandas.

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

`applyRowBanding(bandingTheme)`

Aplica un tema de banda de filas específico al rango. De forma predeterminada, las bandas tienen encabezado y no color del pie de página.

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding theme to rows 1-30.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the hex color of the second banded row.
const secondRowColor = range.getBandings()[0]
                            .getSecondRowColorObject()
                            .asRgbColor()
                            .asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

Parámetros

Nombre	Tipo	Descripción
`bandingTheme`	`BandingTheme`	Un tema de color para aplicar a las filas del rango.

Volver

Banding: Las nuevas bandas.

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

`applyRowBanding(bandingTheme, showHeader, showFooter)`

Aplica un tema específico de banda de filas al rango con la configuración especificada de encabezado y pie de página.

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding to rows 1-30 and
// specifies to hide the header and show the footer.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);

Parámetros

Nombre	Tipo	Descripción
`bandingTheme`	`BandingTheme`	Un tema de color para aplicar a las filas del rango.
`showHeader`	`Boolean`	Si es `true`, el color del encabezado del tema de bandas se aplica a la primera fila.
`showFooter`	`Boolean`	Si es `true`, el color del pie de página del tema de bandas se aplica a la última fila.

Volver

Banding: Las nuevas bandas.

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

`autoFill(destination, series)`

Completa el destinationRange con datos basados en los datos de este rango. Los valores nuevos también están determinadas por el tipo de series especificado. El rango de destino debe contener este rango y lo extienden en una sola dirección. Por ejemplo, lo siguiente completa A1:A20 con una serie de números crecientes basados en los valores actuales en A1:A4:

var sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
var sourceRange = sheet.getRange("A1:A4");
// The range to fill with values.
var destination = sheet.getRange("A1:A20");

// Inserts new values in A5:A20, continuing the pattern expressed in A1:A4
sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

Parámetros

Nombre	Tipo	Descripción
`destination`	`Range`	El rango que se completará automáticamente con los valores El rango de destino debe contener este rango y extenderlo solo en una dirección (hacia arriba, hacia abajo, hacia la izquierda o derecha).
`series`	`AutoFillSeries`	El tipo de serie de autocompletar que se debe usar para calcular valores nuevos. El efecto de esta serie difiere según el tipo y la cantidad de datos de origen.

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

`autoFillToNeighbor(series)`

Calcula un rango para completar con datos nuevos en función de celdas vecinas y rellena automáticamente que varían con valores nuevos basados en los datos contenidos en ese rango. Estos nuevos valores también son determinados por el tipo series especificado.

El rango de destino calculado considera los datos del entorno para determinar dónde se encuentra si hay datos inmediatos a la izquierda o derecha de una columna que Los valores nuevos solo se extienden hasta estos datos adyacentes.

Por ejemplo, si A1:A20 se completa con una serie de números crecientes y este método se llama en el rango B1:B4, que contiene una serie de fechas, los valores nuevos solo se se insertó en B5:B20. De esta manera, estos nuevos valores se quedan a las celdas que contienen valores en la columna A.

var sheet = SpreadsheetApp.getActiveSheet();

// A1:A20 has values [1, 2, 3, ... 20].
// B1:B4 has values [1/1/2017, 1/2/2017, ...]
var sourceRange = sheet.getRange("B1:B4");

// Results in B5:B20 having values [1/5/2017, ... 1/20/2017]
sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

Parámetros

Nombre	Tipo	Descripción
`series`	`AutoFillSeries`	El tipo de serie de autocompletar que se debe usar para calcular valores nuevos. El efecto de esta serie difiere según el tipo y la cantidad de datos de origen.

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

`breakApart()`

Vuelve a dividir en celdas individuales las celdas de varias columnas del rango.

Llamar a esta función en un rango equivale a seleccionar un rango y hacer clic Formato > Combinar celdas > Separar.

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Unmerges the range A1:C6 into individual cells.
range.breakApart();

Volver

Range: Este rango para el encadenamiento.

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

`canEdit()`

Determina si el usuario tiene permiso para editar todas las celdas del rango. La hoja de cálculo el propietario siempre puede editar rangos y hojas protegidos.

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Logs whether the user has permission to edit every cell in the range.
console.log(range.canEdit());

Volver

Boolean: Es true si el usuario tiene permiso para editar todas las celdas del rango. false de lo contrario.

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

`check()`

Cambia el estado de las casillas de verificación del rango a “marcado”. Ignora las celdas del rango que actualmente no incluyen el valor configurado ni el que está marcado ni desmarcado.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'checked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.check();

Volver

Range: Este rango para el encadenamiento.

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

`clear()`

Borra el rango de contenido y formatos.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clear();

Volver

Range: Este rango para el encadenamiento.

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

`clear(options)`

Borra el rango de contenidos, el formato, las reglas de validación de datos o los comentarios, como se especifica con las opciones avanzadas indicadas. Se borran todos los datos de forma predeterminada.

// The code below clears range C2:G7 in the active sheet, but preserves the format,
// data validation rules, and comments.
SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({contentsOnly: true});

Parámetros

Nombre	Tipo	Descripción
`options`	`Object`	Un objeto JavaScript que especifica parámetros avanzados, como se indica a continuación.

Parámetros avanzados

Nombre	Tipo	Descripción
`commentsOnly`	`Boolean`	Especifica si se deben borrar solo los comentarios.
`contentsOnly`	`Boolean`	Establece si solo se borran los contenidos.
`formatOnly`	`Boolean`	Si se borra solo el formato ten en cuenta que borrar también borra las reglas de validación de datos.
`validationsOnly`	`Boolean`	Especifica si se deben borrar solo las reglas de validación de datos.
`skipFilteredRows`	`Boolean`	Especifica si se debe evitar borrar las filas filtradas.

Volver

Range: Este rango para el encadenamiento.

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

`clearContent()`

Borra el contenido del rango y deja el formato intacto.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearContent();

Volver

Range: Este rango para el encadenamiento.

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

`clearDataValidations()`

Borra las reglas de validación de datos del rango.

// Clear the data validation rules for cells A1:B5.
var range = SpreadsheetApp.getActive().getRange('A1:B5');
range.clearDataValidations();

Volver

Range: Este rango para el encadenamiento.

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

`clearFormat()`

Borra el formato de este rango.

Esta acción borra el formato de texto de las celdas del rango, pero no restablece ninguna. las reglas de formato de número.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearFormat();

Volver

Range: Este rango para el encadenamiento.

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

`clearNote()`

Borra la nota en una o varias celdas específicas.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearNote();

Volver

Range: Este rango para el encadenamiento.

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

`collapseGroups()`

Contrae todos los grupos contenidos por completo dentro del rango. Si ningún grupo está completamente en el rango, el grupo expandido más profundo que se encuentra parcialmente dentro del rango se contrae.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are collapsed.
range.collapseGroups();

Volver

Range: Este rango para el encadenamiento.

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

`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`

Copia el formato del rango en la ubicación especificada. Si el destino es más grande o más pequeño que el rango de origen, la fuente se repite o se trunca según corresponda. Ten en cuenta que esta solo copia el formato.

Para obtener una descripción detallada del parámetro gridId, consulta getGridId().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId
// of a sheet by calling sheet.getSheetId() or range.getGridId().
range.copyFormatToRange(1555299895, 4, 6, 4, 6);

Parámetros

Nombre	Tipo	Descripción
`gridId`	`Integer`	El ID único de la hoja dentro de la hoja de cálculo, independientemente de la posición.
`column`	`Integer`	La primera columna del rango objetivo.
`columnEnd`	`Integer`	La columna final del rango objetivo.
`row`	`Integer`	Es la fila inicial del rango objetivo.
`rowEnd`	`Integer`	Es la fila final del rango objetivo.

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

Consulta también

getGridId()

`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyFormatToRange(destination, 4, 6, 4, 6);

Parámetros

Nombre	Tipo	Descripción
`sheet`	`Sheet`	La hoja de destino.
`column`	`Integer`	La primera columna del rango objetivo.
`columnEnd`	`Integer`	La columna final del rango objetivo.
`row`	`Integer`	Es la fila inicial del rango objetivo.
`rowEnd`	`Integer`	Es la fila final del rango objetivo.

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

`copyTo(destination)`

Copia los datos de un rango de celdas a otro rango de celdas. Tanto los valores como el formato se copian.

// The code below copies the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5);
rangeToCopy.copyTo(sheet.getRange(1, 6));

Parámetros

Nombre	Tipo	Descripción
`destination`	`Range`	Un rango de destino al cual copiar; solo es relevante la posición de la celda superior izquierda.

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

`copyTo(destination, copyPasteType, transposed)`

Copia los datos de un rango de celdas a otro rango de celdas.

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), SpreadsheetApp.CopyPasteType.PASTE_VALUES,
false);

Parámetros

Nombre	Tipo	Descripción
`destination`	`Range`	Un rango de destino al cual copiar; solo es relevante la posición de la celda superior izquierda.
`copyPasteType`	`CopyPasteType`	Un tipo que especifica cómo se pega el contenido del rango en la destino.
`transposed`	`Boolean`	Indica si el rango debe pegarse en su orientación transpuesta.

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

`copyTo(destination, options)`

Copia los datos de un rango de celdas a otro rango de celdas. De forma predeterminada, los valores y pero el formato se copia, pero se puede anular con argumentos avanzados.

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});

Parámetros

Nombre	Tipo	Descripción
`destination`	`Range`	Un rango de destino al cual copiar; solo es relevante la posición de la celda superior izquierda.
`options`	`Object`	Un objeto JavaScript que especifica parámetros avanzados, como se indica a continuación.

Parámetros avanzados

Nombre	Tipo	Descripción
`formatOnly`	`Boolean`	designa que solo se debe copiar el formato
`contentsOnly`	`Boolean`	designa que solo se debe copiar el contenido

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

`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`

Copia el contenido del rango en la ubicación especificada. Si el destino es más grande o más pequeño que el rango de origen, la fuente se repite o se trunca según corresponda.

Para obtener una descripción detallada del parámetro gridId, consulta getGridId().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 0
range.copyValuesToRange(0, 4, 6, 4, 6);

Parámetros

Nombre	Tipo	Descripción
`gridId`	`Integer`	El ID único de la hoja dentro de la hoja de cálculo, independientemente de la posición.
`column`	`Integer`	La primera columna del rango objetivo.
`columnEnd`	`Integer`	La columna final del rango objetivo.
`row`	`Integer`	Es la fila inicial del rango objetivo.
`rowEnd`	`Integer`	Es la fila final del rango objetivo.

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

Consulta también

getGridId()

`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`

Copia el contenido del rango en la ubicación especificada. Si el destino es más grande o más pequeño que el rango de origen, la fuente se repite o se trunca según corresponda.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyValuesToRange(destination, 4, 6, 4, 6);

Parámetros

Nombre	Tipo	Descripción
`sheet`	`Sheet`	La hoja de destino.
`column`	`Integer`	La primera columna del rango objetivo.
`columnEnd`	`Integer`	La columna final del rango objetivo.
`row`	`Integer`	Es la fila inicial del rango objetivo.
`rowEnd`	`Integer`	Es la fila final del rango objetivo.

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

`createDataSourcePivotTable(dataSource)`

Crea una tabla dinámica de fuente de datos vacía a partir de la fuente de datos, anclada en la primera celda de este rango.

En este ejemplo, se muestra cómo crear y configurar una nueva tabla dinámica de fuente de datos.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var pivotTable = anchorCell.createDataSourcePivotTable(dataSource);
pivotTable.addRowGroup('dataColumnA');
pivotTable.addColumnGroup('dataColumnB');
pivotTable.addPivotValue('dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM);
pivotTable.addFilter('dataColumnA',
                     SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build());

Parámetros

Nombre	Tipo	Descripción
`dataSource`	`DataSource`	La fuente de datos a partir de la cual se creará la tabla dinámica.

Volver

DataSourcePivotTable: Es la tabla dinámica de fuente de datos recién creada.

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

`createDataSourceTable(dataSource)`

Crea una tabla de fuente de datos vacía a partir de la fuente de datos, anclada en la primera celda de esta del rango de destino de la ruta.

En este ejemplo, se muestra cómo crear y configurar una nueva tabla de fuente de datos.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var dataSourceTable = anchorCell.createDataSourceTable(dataSource);
    .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC')
    .addSortSpec('dataColumnA', /* ascending= *\/ true)
    .addSortSpec('dataColumnB', /* ascending= *\/ false);

Parámetros

Nombre	Tipo	Descripción
`dataSource`	`DataSource`	La fuente de datos a partir de la cual se creará la tabla dinámica.

Volver

DataSourceTable: la tabla de fuente de datos recién creada.

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

`createDeveloperMetadataFinder()`

Muestra una DeveloperMetadataFinderApi para encontrar metadatos del desarrollador dentro del alcance de este. del rango de destino de la ruta. Los metadatos están dentro del alcance del rango solo si están completamente contenidos dentro de ese rango. del rango de destino de la ruta. Por ejemplo, los metadatos asociados con la fila “3:3” no están dentro del alcance de un rango. “A1:D5”, pero está dentro del alcance de un rango “1:5”.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6.
const range = sheet.getRange('A1:C6');

// Creates a developer metadata finder to search for metadata in the scope of this range.
const developerMetaDataFinder = range.createDeveloperMetadataFinder();

// Logs information about the developer metadata finder to the console.
const developerMetaData = developerMetaDataFinder.find()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

Volver

DeveloperMetadataFinder: Es un buscador de metadatos del desarrollador para buscar metadatos dentro del alcance de este rango.

`createFilter()`

Crea un filtro y lo aplica al rango especificado en la hoja. No puedes crear más de un filtro por hoja. Para acceder al filtro y modificarlo después de crearlo, usa getFilter() o Sheet.getFilter().

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");

// Creates a new filter and applies it to the range A1:C20 on the active sheet.
function createFilter() {
  range.createFilter();
}
// Gets the filter and applies criteria that only shows cells that aren't empty.
function getFilterAddCriteria() {
  let filter = range.getFilter();
  let criteria = SpreadsheetApp.newFilterCriteria()
    .whenCellNotEmpty()
    .build();
  filter.setColumnFilterCriteria(2, criteria);
}

Usa este método para crear filtros para hojas Grid, el tipo de hoja predeterminado. Las hojas de cuadrícula son hojas que no están conectadas a una base de datos. Para crear otros tipos de filtros, consulta lo siguiente:

Crea un filtro de tabla dinámica con PivotTable.addFilter(sourceDataColumn, filterCriteria)
Crea un filtro para una hoja conectada a una base de datos con DataSourceSheet.addFilter(columnName, filterCriteria)
Crea un filtro para una tabla dinámica conectada a una base de datos con DataSourcePivotTable.addFilter(columnName, filterCriteria)

Volver

Filter: Es el filtro nuevo.

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

`createPivotTable(sourceData)`

Crea una tabla dinámica vacía a partir del sourceData especificado anclado en la primera celda en este rango.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A1 as a range in order to place the pivot table.
const range = sheet.getRange('A1');

// Gets the range of the source data for the pivot table.
const dataRange = sheet.getRange('E12:G20');

// Creates an empty pivot table from the specified source data.
const pivotTable = range.createPivotTable(dataRange);

// Logs the values from the pivot table's source data to the console.
console.log(pivotTable.getSourceDataRange().getValues());

Parámetros

Nombre	Tipo	Descripción
`sourceData`	`Range`	Los datos a partir de los cuales se creará la tabla dinámica.

Volver

PivotTable: el PivotTable recién creado.

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

`createTextFinder(findText)`

Crea un buscador de texto para el intervalo, que puede buscar y reemplazar texto.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// Creates  a text finder for the range.
var textFinder = range.createTextFinder('dog');

// Returns the first occurrence of 'dog'.
var firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
var numOccurrencesReplaced = textFinder.replaceWith('cat');

Parámetros

Nombre	Tipo	Descripción
`findText`	`String`	El texto que se va a buscar

Volver

TextFinder: Es el TextFinder del rango.

`deleteCells(shiftDimension)`

Elimina este rango de celdas. Se cambian los datos existentes en la hoja junto con la dimensión proporcionada hacia el rango borrado.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

Parámetros

Nombre	Tipo	Descripción
`shiftDimension`	`Dimension`	La dimensión a lo que se deben desplazar los datos existentes.

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

`expandGroups()`

Expande los grupos contraídos cuyo rango o botón de activación de control se cruza con este rango. El la ubicación del botón de activación del control es el índice en el que se muestra el botón de activación, justo antes o después del grupo según la configuración. Si hay más de un grupo en la misma ubicación, el grupo más bajo se expande.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are expanded.
range.expandGroups();

Volver

Range: Este rango para el encadenamiento.

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

`getA1Notation()`

Muestra una descripción de cadena del rango, en notación A1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange(1, 1, 2, 5);

// Logs "A1:E2"
Logger.log(range.getA1Notation());

Volver

String: la descripción de la cadena del rango en notación A1.

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

`getBackground()`

Muestra el color de fondo de la celda superior izquierda del rango (por ejemplo, '#ffffff').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackground());

Volver

String: Indica el código de color del fondo.

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

`getBackgroundObject()`

Muestra el color de fondo de la celda superior izquierda del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

Volver

Color: Es el color de fondo de la celda superior izquierda del rango.

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

`getBackgroundObjects()`

Devuelve los colores de fondo de las celdas en el rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgroundObjects();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j].asRgbColor().asHexString());
  }
}

Volver

Color[][]: Es un array bidimensional de colores de fondo.

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

`getBackgrounds()`

Muestra los colores de fondo de las celdas en el rango (por ejemplo, '#ffffff').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgrounds();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j]);
  }
}

Volver

String[][]: Es un array bidimensional de códigos de color de los fondos.

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

`getBandings()`

Muestra todas las bandas que se aplican a cualquier celda en este rango.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets a range.
const range = sheet.getRange('A1:K50');

// Gets the banding info for the range.
const bandings = range.getBandings();

// Logs the second row color for each banding to the console.
for (let banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Volver

Banding[]: Todas las bandas que se aplican a cualquier celda en este rango.

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

`getCell(row, column)`

Muestra una celda determinada dentro de un rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");

// The row and column here are relative to the range
// getCell(1,1) in this code returns the cell at B2
var cell = range.getCell(1, 1);
Logger.log(cell.getValue());

Parámetros

Nombre	Tipo	Descripción
`row`	`Integer`	Fila de la celda en relación con el rango.
`column`	`Integer`	Columna de la celda en relación con el rango

Volver

Range: Indica un rango que contiene una sola celda en las coordenadas especificadas.

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

`getColumn()`

Muestra la posición de la columna inicial para este rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "2.0"
Logger.log(range.getColumn());

Volver

Integer: Indica la posición de la columna inicial del rango en 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

`getDataRegion()`

Muestra una copia del rango expandido en los cuatro Direction cardinales para abarcar todo celdas adyacentes con datos. Si el rango está rodeado de celdas vacías sin incluir aquellas a lo largo de las diagonales, se devuelve el rango mismo. Esto es similar a seleccionar el rango y Escribe Ctrl+A en el editor.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "B2:D4"
Logger.log(sheet.getRange("C3").getDataRegion().getA1Notation());

Volver

Range: Indica la región de datos del rango o un rango de toda 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

`getDataRegion(dimension)`

Muestra una copia del rango expandido Direction.UP y Direction.DOWN si el la dimensión especificada es Dimension.ROWS o Direction.NEXT y Direction.PREVIOUS si la dimensión es Dimension.COLUMNS. La expansión del rango se basa en la detección de datos junto al rango que se organiza como una tabla. El rango expandido abarca todas las celdas adyacentes con datos en ellas a lo largo de la dimensión especificada, incluida la tabla límites. Si el rango original está rodeado de celdas vacías en la dimensión especificada, se devuelve el rango en sí. Este método es similar a seleccionar el rango y escribir Ctrl+Space para las columnas o Shift+Space para las filas en el editor.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "C2:C4"
Logger.log(sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.ROWS).getA1Notation());
// Logs "B3:D3"
Logger.log(
    sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.COLUMNS).getA1Notation());

Parámetros

Nombre	Tipo	Descripción
`dimension`	`Dimension`	Es la dimensión en la que se expande el rango.

Volver

Range: Indica la región de datos del rango o un rango que cubre cada columna o cada fila que abarca la rango original.

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

`getDataSourceFormula()`

Muestra el DataSourceFormula para la primera celda en el rango o null si la celda no contiene una fórmula de fuente de datos.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1 on Sheet1.
const range = sheet.getRange('A1');

// Gets the data source formula from cell A1.
const dataSourceFormula = range.getDataSourceFormula();

// Gets the formula.
const formula = dataSourceFormula.getFormula();

// Logs the formula.
console.log(formula);

Volver

DataSourceFormula: Es el DataSourceFormula de la celda.

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

`getDataSourceFormulas()`

Muestra los DataSourceFormula de las celdas en el rango.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:B5 on Sheet1.
const range = sheet.getRange('A1:B5');

// Gets an array of the data source formulas in the range A1:B5.
const dataSourceFormulas = range.getDataSourceFormulas();

// Logs the first formula in the array.
console.log(dataSourceFormulas[0].getFormula());

Volver

DataSourceFormula[]: Es un array de DataSourceFormula.

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

`getDataSourcePivotTables()`

Obtiene todas las tablas dinámicas de la fuente de datos que se cruzan con el rango.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets an array of the data source pivot tables in the range A1:G50.
const dataSourcePivotTables = range.getDataSourcePivotTables();

// Logs the last time that the first pivot table in the array was refreshed.
console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());

Volver

DataSourcePivotTable[]: Es una lista de tablas dinámicas de fuente de datos.

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

`getDataSourceTables()`

Obtiene todas las tablas de fuentes de datos que se cruzan con el rango.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets the first data source table in the range A1:G50.
const dataSourceTable = range.getDataSourceTables()[0];

// Logs the time of the last completed data execution on the data source table.
console.log(dataSourceTable.getStatus().getLastExecutionTime());

Volver

DataSourceTable[]: Es una lista de tablas de fuentes de datos.

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

`getDataSourceUrl()`

Muestra una URL para los datos de este rango, que se puede usar para crear gráficos y consultas.

Code.gs

function doGet() {
  var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c');
  var sheet = ss.getSheetByName('ContinentData');
  var range = sheet.getRange('A1:B8');

  var template = HtmlService.createTemplateFromFile('piechart');
  template.dataSourceUrl = range.getDataSourceUrl();
  return template.evaluate();
}

piechart.html

<!DOCTYPE html>
<html>
  <head>
    <!--Load the AJAX API-->
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      // Load the Visualization API and the corechart package.
      google.charts.load('current', {'packages': ['corechart']});

      // Set a callback to run when the Google Visualization API is loaded.
      google.charts.setOnLoadCallback(queryData);

      function queryData() {
        var query = new google.visualization.Query('<?= dataSourceUrl ?>');
        query.send(drawChart);
      }

      // Callback that creates and populates a data table,
      // instantiates the pie chart, passes in the data and
      // draws it.
      function drawChart(response) {
        if (response.isError()) {
          alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage());
          return;
        }
        var data = response.getDataTable();

        // Set chart options.
        var options = {
          title: 'Population by Continent',
          width: 400,
          height: 300
        };

        // Instantiate and draw the chart, passing in some options.
        var chart = new google.visualization.PieChart(document.getElementById('chart_div'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <!-- Div that holds the pie chart. -->
    <div id="chart_div"></div>
  </body>
</html>

Volver

String: Es una URL para este rango como una fuente de datos que se puede pasar a otras APIs, como gráficos.

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

`getDataTable()`

Muestra los datos dentro de este objeto como una DataTable.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:B7 on Sheet1.
const range = sheet.getRange('A1:B7');

// Gets the range A1:B7 as a data table. The values in each column must be of the same type.
const datatable = range.getDataTable();

// Uses the Charts service to build a bar chart from the data table.
// This doesn't build an embedded chart. To do that, use sheet.newChart().addRange() instead.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Chart Title Here')
                  .build();

Volver

DataTable: Son los datos como una tabla de datos.

`getDataTable(firstRowIsHeader)`

Muestra los datos dentro de este rango como una DataTable.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B7");

// Calling this method with "true" sets the first line to be the title of the axes
var datatable = range.getDataTable(true);

// Note that this doesn't build an EmbeddedChart, so you can't just use
// Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead.
var chart = Charts.newBarChart()
    .setDataTable(datatable)
    .setOption("title", "Your Title Here")
    .build();

Parámetros

Nombre	Tipo	Descripción
`firstRowIsHeader`	`Boolean`	Establece si se debe tratar la primera fila como un encabezado.

Volver

DataTable: Son los datos como una tabla de datos.

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

`getDataValidation()`

Devuelve la regla de validación de datos para la celda superior izquierda del rango. Si la validación de datos no en la celda, este método muestra null.

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

Volver

DataValidation: Es la regla de validación de datos de la celda superior izquierda del rango.

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

`getDataValidations()`

Devuelve las reglas de validación de datos para todas las celdas del rango. Si la validación de datos no se ha establecido en una celda determinada, este método muestra null para la posición de esa celda en el array.

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

Volver

DataValidation[][]: Es un array bidimensional de reglas de validación de datos asociadas con las celdas de la del rango de destino de la ruta.

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

`getDeveloperMetadata()`

Obtiene los metadatos del programador asociados con este rango.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds metadata to row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Logs the metadata to console.
for (const metadata of range.getDeveloperMetadata()) {
  console.log(`${metadata.getKey()}: ${metadata.getValue()}`);
}

Volver

DeveloperMetadata[]: los metadatos del programador asociados con este rango.

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

`getDisplayValue()`

Muestra el valor que se muestra de la celda superior izquierda del rango. El valor es String. El valor que se muestra tiene en cuenta el formato de fecha, hora y moneda, lo que incluye formatos aplicados automáticamente por la configuración regional de la hoja de cálculo. Las celdas vacías muestran un mensaje vacío una cadena vacía.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A30 and sets its value to 'Test code.'
const cell = sheet.getRange('A30');
cell.setValue('Test code');

// Gets the value and logs it to the console.
console.log(cell.getDisplayValue());

Volver

String: el valor que se muestra en esta celda.

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

`getDisplayValues()`

Muestra la cuadrícula rectangular de los valores de este rango.

Muestra un array bidimensional de los valores que se muestran, indexados por fila y, luego, por columna. El los valores son objetos String. El valor que se muestra tiene en cuenta la fecha, la hora y formato de moneda, incluidos los formatos que se aplican automáticamente según la configuración regional de la hoja de cálculo del lugar. Las celdas vacías se representan con una cadena vacía en el array. Recuerda que, si bien índice de rango comienza en 1, 1, el array de JavaScript se indexa desde [0][0].

// The code below gets the displayed values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

Volver

String[][]: Es un array de valores bidimensional.

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

`getFilter()`

Muestra el filtro en la hoja a la que pertenece este rango, o null si no hay ningún filtro en la hoja.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Gets the existing filter on the sheet that the given range belongs to.
let filter = range.getFilter();

Volver

Filter: Es el filtro.

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

`getFontColorObject()`

Muestra el color de fuente de la celda en la esquina superior izquierda del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontColorObject().asRgbColor().asHexString());

Volver

Color: Indica el color de fuente de la celda superior izquierda del rango.

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

`getFontColorObjects()`

Muestra los colores de fuente de las celdas en el rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontColorObjects();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j].asRgbColor().asHexString());
  }
}

Volver

Color[][]: Es un array bidimensional de colores de fuente asociados con celdas del rango.

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

`getFontFamilies()`

Muestra las familias de fuentes de las celdas del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontFamilies();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Volver

String[][]: Es un array bidimensional de familias de fuentes asociadas con celdas del rango.

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

`getFontFamily()`

Muestra la familia de fuentes de la celda de la esquina superior izquierda del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontFamily());

Volver

String: Indica la familia de fuentes de la celda.

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

`getFontLine()`

Obtiene el estilo de línea de la celda en la esquina superior izquierda del rango ('underline', 'line-through' o 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontLine());

Volver

String: Es la línea de fuente.

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

`getFontLines()`

Obtiene el estilo de línea de las celdas del rango ('underline', 'line-through' o 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontLines();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Volver

String[][]: Es un array bidimensional de líneas de fuente asociadas con celdas del rango.

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

`getFontSize()`

Muestra el tamaño de fuente en tamaño de punto de la celda en la esquina superior izquierda del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontSize());

Volver

Integer: Es el tamaño de la fuente en punto.

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

`getFontSizes()`

Muestra los tamaños de fuente de las celdas del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontSizes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Volver

Integer[][]: Es un array bidimensional de tamaños de fuente de texto asociados con celdas del rango.

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

`getFontStyle()`

Devuelve el estilo de fuente ('italic' o 'normal') de la celda en la parte superior izquierda. en la esquina superior del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontStyle());

Volver

String: Es el estilo de fuente del texto de la celda.

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

`getFontStyles()`

Muestra los estilos de fuente de las celdas del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontStyles();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Volver

String[][]: Es un array bidimensional de estilos de fuente de texto asociados con celdas del rango.

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

`getFontWeight()`

Muestra el grosor de la fuente (normal/negrita) de la celda ubicada en la esquina superior izquierda del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontWeight());

Volver

String: Es el grosor de la fuente del texto de la celda.

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

`getFontWeights()`

Muestra el peso de la fuente de las celdas en el rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontWeights();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Volver

String[][]: Es un array bidimensional de grosores de fuente del texto asociado con celdas del rango.

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

`getFormula()`

Devuelve la fórmula (notación A1) para la celda superior izquierda del rango, o una cadena vacía si el está vacía o no contiene ninguna fórmula.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This assumes you have a function in B5 that sums up
// B2:B4
var range = sheet.getRange("B5");

// Logs the calculated value and the formula
Logger.log("Calculated value: %s Formula: %s",
           range.getValue(),
           range.getFormula());

Volver

String: Es la fórmula de la celda.

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

`getFormulaR1C1()`

Muestra la fórmula (notación R1C1) para una celda determinada o null si no hay ninguna.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5");
var formula = range.getFormulaR1C1();
Logger.log(formula);

Volver

String: Es la fórmula en notación R1C1.

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

`getFormulas()`

Muestra las fórmulas (notación A1) para las celdas en el rango. Las entradas del array 2D se cadenas vacías para celdas sin fórmula.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulas();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

Volver

String[][]: Es un array bidimensional de fórmulas en formato de cadena.

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

`getFormulasR1C1()`

Muestra las fórmulas (notación R1C1) para las celdas en el rango. Las entradas del array 2D se null para las celdas sin fórmula.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulasR1C1();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

Volver

String[][]: Es un array bidimensional de fórmulas en notación R1C1.

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

`getGridId()`

Muestra el ID de la cuadrícula de la hoja superior del rango. Los ID son valores int aleatorios no negativos.

// Log the grid ID of the first sheet (by tab position) in the spreadsheet.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getGridId());

Volver

Integer: Es el ID de cuadrícula de la hoja superior.

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

`getHeight()`

Muestra la altura del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// logs 3.0
Logger.log(range.getHeight());

Volver

Integer: Es la altura del rango.

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

`getHorizontalAlignment()`

Devuelve la alineación horizontal del texto (izquierda/centro/derecha) de la celda en la parte superior izquierda. en la esquina superior del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getHorizontalAlignment());

Volver

String: Indica la alineación horizontal del texto en la celda.

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

`getHorizontalAlignments()`

Muestra las alineaciones horizontales de las celdas en el rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getHorizontalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Volver

String[][]: Es un array bidimensional de alineamientos horizontales de texto asociados con celdas en la del rango de destino de la ruta.

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

`getLastColumn()`

Muestra la posición de la columna final.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastColumn());

Volver

Integer: Indica la posición de la columna final del rango en 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

`getLastRow()`

Muestra la posición de la fila final.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastRow());

Volver

Integer: Es la posición de la fila final del rango en 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

`getMergedRanges()`

Muestra un array de objetos Range que representan celdas combinadas que están completas. dentro del rango actual o contener al menos una celda en el rango actual.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B3");

var mergedRanges = range.getMergedRanges();
for (var i = 0; i < mergedRanges.length; i++) {
  Logger.log(mergedRanges[i].getA1Notation());
  Logger.log(mergedRanges[i].getDisplayValue());
}

Volver

Range[]: Es un array de objetos Range que representa celdas combinadas que se superponen con el rango.

`getNextDataCell(direction)`

Comenzando en la celda de la primera columna y fila del rango, devuelve la siguiente celda en la dirección determinada que es el borde de un rango contiguo de celdas con datos o la celda en el borde de la hoja de cálculo en esa dirección. Esto equivale a escribir Ctrl+[arrow key] en el editor.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("C3:E5");
// Logs "C1"
Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());

Parámetros

Nombre	Tipo	Descripción
`direction`	`Direction`	La dirección en la que se encuentra la siguiente celda perimetral de la región de datos.

Volver

Range: Es la celda perimetral de la región de datos o la celda en el borde 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

`getNote()`

Muestra la nota asociada al rango especificado.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getNote());

Volver

String: Es la nota asociada con la celda determinada.

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

`getNotes()`

Devuelve las notas asociadas con las celdas del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getNotes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Volver

String[][]: Es un array bidimensional de notas asociadas con celdas del rango.

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

`getNumColumns()`

Muestra el número de columnas en este rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumColumns());

Volver

Integer: la cantidad de columnas de este rango.

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

`getNumRows()`

Muestra el número de filas en este rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumRows());

Volver

Integer: la cantidad de filas de este rango.

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

`getNumberFormat()`

Obtiene el formato de número o de fecha de la celda superior izquierda del rango especificado. El formato que se muestra los patrones se describen en la API de Hojas de cálculo documentación.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("C4");
Logger.log(cell.getNumberFormat());

Volver

String: Es el formato de número de la celda superior izquierda del rango.

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

`getNumberFormats()`

Muestra los formatos de número o fecha de las celdas del rango. Los patrones de formato devueltos se que se describe en la documentación de la API de Hojas de cálculo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formats = range.getNumberFormats();
for (var i in formats) {
  for (var j in formats[i]) {
    Logger.log(formats[i][j]);
  }
}

Volver

String[][]: Es un array bidimensional de formatos de número.

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

`getRichTextValue()`

Muestra el valor de texto enriquecido de la celda superior izquierda del rango o null si la celda el valor no es texto.

// Gets the Rich Text value of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var richText = range.getRichTextValue();
console.log(richText.getText());

Volver

RichTextValue: el valor de texto enriquecido de la celda superior izquierda del rango, o null si la celda el valor no es texto.

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

`getRichTextValues()`

Devuelve los valores de texto enriquecido para las celdas en el rango.

// Gets the Rich Text values for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var values = range.getRichTextValues();

for (var i = 0; i < values.length; i++) {
  for (var j = 0; j < values[i].length; j++) {
    console.log(values[i][j].getText());
  }
}

Volver

RichTextValue[][]: Es un array bidimensional de valores de texto enriquecido.

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

`getRow()`

Muestra la posición de la fila para este rango. Idéntico a getRowIndex().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2");
Logger.log(range.getRow());

Volver

Integer: Es la posición de la fila del rango.

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

`getRowIndex()`

Muestra la posición de la fila para este rango. Idéntico a getRow().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2");
Logger.log(range.getRowIndex());

Volver

Integer: Es la posición de la fila del rango.

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

Consulta también

getRow()

`getSheet()`

Muestra la hoja a la que pertenece este rango.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the sheet that the range belongs to.
const rangeSheet = range.getSheet();

// Gets the sheet name and logs it to the console.
console.log(rangeSheet.getName());

Volver

Sheet: Es la hoja a la que pertenece este rango.

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

`getTextDirection()`

Muestra la dirección del texto de la celda superior izquierda del rango. Muestra null si la celda la dirección del texto se determina mediante la detección automática.

// Get the text direction of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getTextDirection());

Volver

TextDirection: Indica la dirección del texto de la celda superior izquierda del rango.

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

`getTextDirections()`

Devuelve las instrucciones de texto para las celdas en el rango. Las entradas del array 2D son null para las celdas que usan la detección automática.

// Get the text directions for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var directions = range.getTextDirections();

for (var i = 0; i < directions.length; i++) {
  for (var j = 0; j < directions[i].length; j++) {
    Logger.log(directions[i][j]);
  }
}

Volver

TextDirection[][]: Es un array bidimensional de direcciones de texto.

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

`getTextRotation()`

Muestra la configuración de rotación de texto de la celda superior izquierda del rango.

// Log the text rotation settings for a cell.
var sheet = SpreadsheetApp.getActiveSheet();

var cell = sheet.getRange("A1");
Logger.log(cell.getTextRotation());

Volver

TextRotation: Indica la configuración de rotación de texto.

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

`getTextRotations()`

Muestra la configuración de rotación de texto de las celdas en el rango.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

var results = range.getTextRotations();

for (var i in results) {
  for (var j in results[i]) {
    var rotation = results[i][j];
    Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation);
  }
}

Volver

TextRotation[][]: Es un array bidimensional de rotaciones de texto asociadas con celdas del rango.

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

`getTextStyle()`

Muestra el estilo de texto de la celda superior izquierda del rango.

// Get the text style of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var style = range.getTextStyle();
Logger.log(style);

Volver

TextStyle: Es el estilo de texto de la celda superior izquierda del rango.

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

`getTextStyles()`

Muestra los estilos de texto de las celdas del rango.

// Get the text styles for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var styles = range.getTextStyles();

for (var i = 0; i < styles.length; i++) {
  for (var j = 0; j < styles[i].length; j++) {
    Logger.log(styles[i][j]);
  }
}

Volver

TextStyle[][]: Es un array bidimensional de estilos de texto.

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

`getValue()`

Muestra el valor de la celda superior izquierda del rango. El valor puede ser del tipo Number Boolean, Date o String, según el valor de la celda. Vacío las celdas muestran una cadena vacía.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the value of the top-left cell in the range and logs it to the console.
console.log(range.getValue());

Volver

Object: Es el valor de esta celda.

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

`getValues()`

Muestra la cuadrícula rectangular de los valores de este rango.

Muestra un array de valores bidimensional, indexados por fila y, luego, por columna. Los valores pueden ser de tipo Number, Boolean, Date o String, según la de la celda. Las celdas vacías se representan con una cadena vacía en el array. Recuerda que mientras que un índice de rango comienza en 1, 1, el array de JavaScript se indexa desde [0][0].

// The code below gets the values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);

En las aplicaciones web, el valor Date no es un parámetro legal. No se puede mostrar getValues() datos a una app web si el rango contiene una celda con un valor Date. En cambio, transforma todos los valores recuperados de la hoja a un primitivo de JavaScript compatible, como Number, Boolean o String.

Volver

Object[][]: Es un array de valores bidimensional.

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

`getVerticalAlignment()`

Devuelve la alineación vertical (parte superior/central/inferior) de la celda en la esquina superior izquierda de del rango de destino de la ruta.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getVerticalAlignment());

Volver

String: Indica la alineación vertical del texto en la celda.

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

`getVerticalAlignments()`

Muestra las alineaciones verticales de las celdas en el rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Volver

String[][]: Es un array bidimensional de alineaciones verticales de texto asociadas con las celdas de la del rango de destino de la ruta.

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

`getWidth()`

Muestra el ancho del rango en columnas.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the width of the range in number of columns and logs it to the console.
console.log(range.getWidth());

Volver

Integer: Indica la cantidad de columnas del rango.

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

`getWrap()`

Muestra si se ajusta el texto de la celda. Para obtener una estrategia de ajuste más detallada, usa getWrapStrategy().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getWrap());

Volver

Boolean: Indica si el texto de esta celda se ajusta o no.

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

`getWrapStrategies()`

Muestra las estrategias de ajuste de texto para las celdas del rango.

// Get the text wrapping strategies for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var strategies = range.getWrapStrategies();

for (var i = 0; i < strategies.length; i++) {
  for (var j = 0; j < strategies[i].length; j++) {
    Logger.log(strategies[i][j]);
  }
}

Volver

WrapStrategy[][]: Es un array bidimensional de estrategias de ajuste de texto.

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

`getWrapStrategy()`

Muestra la estrategia de ajuste de texto para la celda superior izquierda del rango.

// Get the text wrapping strategy of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getWrapStrategy());

Volver

WrapStrategy: Es la estrategia de ajuste de texto de la celda superior izquierda del rango.

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

`getWraps()`

Muestra si se ajusta el texto de las celdas. Para obtener una estrategia de ajuste más detallada, usa getWrapStrategies().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    var isWrapped = results[i][j];
    if (isWrapped) {
       Logger.log("Cell [%s, %s] has wrapped text", i, j);
    }
  }
}

Volver

Boolean[][]: Es un array bidimensional de alineaciones verticales de texto asociadas con las celdas de la del rango de destino de la ruta.

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

`insertCells(shiftDimension)`

Inserta celdas vacías en este rango. Las celdas nuevas conservan el formato presente en ellas que antes ocupaban este rango. Los datos existentes en la hoja junto a la dimensión proporcionada son se ha alejado del rango insertado.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

Parámetros

Nombre	Tipo	Descripción
`shiftDimension`	`Dimension`	La dimensión a lo que se deben desplazar los datos existentes.

Volver

Range: Este rango para el encadenamiento.

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

`insertCheckboxes()`

Inserta casillas de verificación en cada celda del rango, configuradas con true para elementos marcados y false para elementos desmarcados. Establece el valor de todas las celdas en el rango en false.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'false'.
range.insertCheckboxes();

Volver

Range: Este rango para el encadenamiento.

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

`insertCheckboxes(checkedValue)`

Inserta casillas de verificación en cada celda del rango configuradas con un valor personalizado para las celdas marcadas y la cadena vacía es desmarcada. Establece el valor de cada celda del rango en la cadena vacía.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the range A1:B10 to
//  the empty string.
range.insertCheckboxes('yes');

Parámetros

Nombre	Tipo	Descripción
`checkedValue`	`Object`	El valor marcado para la validación de datos de la casilla de verificación.

Volver

Range: Este rango para el encadenamiento.

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

`insertCheckboxes(checkedValue, uncheckedValue)`

Inserta casillas de verificación en cada celda del rango configuradas con valores personalizados para las casillas marcadas. y sin marcar. Establece el valor de cada celda del rango en el valor personalizado sin marcar.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'no'.
range.insertCheckboxes('yes', 'no');

Parámetros

Nombre	Tipo	Descripción
`checkedValue`	`Object`	El valor marcado para la validación de datos de la casilla de verificación.
`uncheckedValue`	`Object`	El valor desmarcado de la casilla de verificación de validación de datos.

Volver

Range: Este rango para el encadenamiento.

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

`isBlank()`

Muestra true si el rango está completamente en blanco.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.isBlank());

Volver

Boolean: true si el rango está en blanco; De lo contrario, false.

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

`isChecked()`

Muestra si todas las celdas del rango tienen su estado de casilla de verificación como "marcado". Muestra null si algunas celdas están marcadas y el resto no está marcado, o si algunas celdas no tienen una casilla de verificación la validación de datos.

var range = SpreadsheetApp.getActive().getRange('A1:A3');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:A3.
range.insertCheckboxes('yes', 'no');

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Sets the value of isRange1Checked as true as it contains the checked value.
var isRange1Checked = range1.isChecked();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('no');
// Sets the value of isRange2Checked as false as it contains the unchecked value.
var isRange2Checked = range2.isChecked();

var range3 = SpreadsheetApp.getActive().getRange('A3');
range3.setValue('random');
// Sets the value of isRange3Checked as null, as it contains an invalid checkbox value.
var isRange3Checked = range3.isChecked();

Volver

Boolean: true, si todas las celdas del rango están marcadas, false si todas las celdas de rango están desmarcados, o null si alguna de las celdas no está marcada o no tiene y la validación de datos de la casilla de verificación.

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

`isEndColumnBounded()`

Determina si el final del rango está vinculado a una columna en particular. Por ejemplo, para la rangos A1:B10 o B:B, que están vinculados a columnas al final del rango, esta el método muestra true; para los rangos 3:7 o A1:5, que solo están vinculados a filas específicas al final del rango, este método muestra false.

 // Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular column and logs it to the
// console.
console.log(range.isEndColumnBounded());

Volver

Boolean: true si el final del rango está vinculado a una columna en particular. false de lo contrario.

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

`isEndRowBounded()`

Determina si el final del rango está vinculado a una fila en particular. Por ejemplo, para la rangos A1:B10 o 3:7, que están vinculados a filas al final del rango, este el método muestra true; para los rangos B:B o A1:C, que solo están vinculados a columnas específicas al final del rango, este método muestra false.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular row and logs it to the console.
console.log(range.isEndRowBounded());

Volver

Boolean: true si el final del rango está vinculado a una fila en particular. false de lo contrario.

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

`isPartOfMerge()`

Muestra true si las celdas del rango actual se superponen con alguna celda combinada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B3");

// True if any of the cells in A1:B3 is included in a merge.
var isPartOfMerge = range.isPartOfMerge();

Volver

Boolean: Es true si el rango se superpone con alguna celda combinada; de lo contrario, muestra false.

`isStartColumnBounded()`

Determina si el inicio del rango está vinculado a una columna en particular. Por ejemplo, para la rangos A1:B10 o B:B, que están vinculados a columnas al comienzo del rango, este método muestra true; para el rango 3:7, que está vinculado solo a una fila en el inicio del rango, este método muestra false.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular column and logs it to the
// console.
console.log(range.isStartColumnBounded());

Volver

Boolean: true si el inicio del rango está vinculado a una columna en particular. false de lo contrario.

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

`isStartRowBounded()`

Determina si el inicio del rango está vinculado a una fila en particular. Por ejemplo, para la rangos A1:B10 o 3:7, que están vinculados a filas al comienzo del rango, este el método muestra true; para el rango B:B, que está vinculado solo a un determinado al comienzo del rango, este método muestra false.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular row and logs it to the
// console.
console.log(range.isStartRowBounded());

Volver

Boolean: true si el inicio del rango está vinculado a una fila en particular. false de lo contrario.

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

`merge()`

Combina las celdas del rango en un solo bloque.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below 2-dimensionally merges the cells in A1 to B3
sheet.getRange('A1:B3').merge();

Volver

Range: Este rango para el encadenamiento.

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

`mergeAcross()`

Combina las celdas del rango en las columnas del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The code below merges cells C5:E5 into one cell
var range1 = sheet.getRange("C5:E5");
range1.mergeAcross();

// The code below creates 2 horizontal cells, F5:H5 and F6:H6
var range2 = sheet.getRange("F5:H6");
range2.mergeAcross();

Volver

Range: Este rango para el encadenamiento.

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

`mergeVertically()`

Combina las celdas en el rango.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below vertically merges the cells in A1 to A10
sheet.getRange('A1:A10').mergeVertically();

// The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10
sheet.getRange('B1:D10').mergeVertically();

Volver

Range: Este rango para el encadenamiento.

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

`moveTo(target)`

Corta y pega (tanto el formato como los valores) de este rango en el rango objetivo.

// The code below moves the first 5 columns over to the 6th column
var sheet = SpreadsheetApp.getActiveSheet()
sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));

Parámetros

Nombre	Tipo	Descripción
`target`	`Range`	Un rango objetivo al que se copiará este rango. solo la posición de la celda superior izquierda es relevante.

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

`offset(rowOffset, columnOffset)`

Devuelve un nuevo rango que se desplaza de este rango por el número dado de filas y columnas (que puede ser negativo). El nuevo rango tiene el mismo tamaño que el original.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2
var newCell = cell.offset(1, 1);

Parámetros

Nombre	Tipo	Descripción
`rowOffset`	`Integer`	el número de filas hacia abajo desde la celda superior izquierda del rango; valores negativos representar las filas hacia arriba desde la celda superior izquierda del rango.
`columnOffset`	`Integer`	El número de columnas a la derecha de la celda superior izquierda del rango; valores negativos representan las columnas a la izquierda de la celda superior izquierda del rango.

Volver

Range: Este rango para el encadenamiento.

`offset(rowOffset, columnOffset, numRows)`

Devuelve un nuevo rango relativo al rango actual, cuyo punto superior izquierdo está desplazado. del rango actual por las filas y columnas determinadas, y con la altura determinada en las celdas.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2:B3
var newRange = cell.offset(1, 1, 2);

Parámetros

Nombre	Tipo	Descripción
`rowOffset`	`Integer`	el número de filas hacia abajo desde la celda superior izquierda del rango; valores negativos representar las filas hacia arriba desde la celda superior izquierda del rango.
`columnOffset`	`Integer`	El número de columnas a la derecha de la celda superior izquierda del rango; valores negativos representan las columnas a la izquierda de la celda superior izquierda del rango.
`numRows`	`Integer`	La altura en las filas del nuevo rango.

Volver

Range: Este rango para el encadenamiento.

`offset(rowOffset, columnOffset, numRows, numColumns)`

Devuelve un nuevo rango relativo al rango actual, cuyo punto superior izquierdo está desplazado. del rango actual por las filas y columnas determinadas, y con la altura y el ancho dados celdas.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2:C3
var newRange = cell.offset(1, 1, 2, 2);

Parámetros

Nombre	Tipo	Descripción
`rowOffset`	`Integer`	el número de filas hacia abajo desde la celda superior izquierda del rango; valores negativos representar las filas hacia arriba desde la celda superior izquierda del rango.
`columnOffset`	`Integer`	El número de columnas a la derecha de la celda superior izquierda del rango; valores negativos representan las columnas a la izquierda de la celda superior izquierda del rango.
`numRows`	`Integer`	La altura en las filas del nuevo rango.
`numColumns`	`Integer`	El ancho en columnas del nuevo rango.

Volver

Range: Este rango para el encadenamiento.

`protect()`

Crea un objeto que puede impedir que se edite el rango, excepto por los usuarios que hayan permiso. Hasta que la secuencia de comandos cambie la lista de editores del rango (llamando a Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user) o Protection.addEditors(emailAddresses), o puedes establecer una nueva valor para Protection.setDomainEdit(editable)), los permisos replican los de la hoja de cálculo propiamente dicha, lo que efectivamente significa que el rango permanece desprotegido. Si el rango es ya está protegido, este método crea un nuevo rango protegido que se superpone al existente. Si una celda está protegida por varios rangos protegidos y cualquiera de ellos impide que un usuario en particular editar la celda, el usuario no podrá editarla.

// Protect range A1:B10, then remove all other users from the list of editors.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var protection = range.protect().setDescription('Sample protected range');

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Volver

Protection: Es un objeto que representa la configuración de protección.

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

`randomize()`

Aleatoriza el orden de las filas en el rango determinado.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Randomizes the range
range.randomize();

Volver

Range: Este rango para el encadenamiento.

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

`removeCheckboxes()`

Quita todas las casillas de verificación del rango. Borra la validación de datos de cada celda. Además, borra su valor si la celda contiene el valor marcado o no marcado.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('random');
// Removes the checkbox data validation in cell A2 but does not clear its value.
range2.removeCheckboxes();

Volver

Range: Este rango para el encadenamiento.

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

`removeDuplicates()`

Elimina las filas dentro de este rango que contienen valores que son duplicados de valores en cualquier fila anterior. Filas con valores idénticos, pero con mayúsculas y minúsculas, formatos o fórmulas diferentes se consideran duplicados. Este método también quita las filas duplicadas ocultas de la vista (por ejemplo, debido a un filtro). El contenido fuera de este rango no se quita.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove duplicate rows in the range.
range.removeDuplicates();

Volver

Range: Es el rango resultante después de quitar los duplicados. El tamaño del rango se reduce en una para cada fila que se quite.

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

`removeDuplicates(columnsToCompare)`

Quita las filas dentro de este rango que contienen valores duplicados en las columnas especificadas de valores en cualquier fila anterior. Filas con valores idénticos, pero con mayúsculas y minúsculas diferentes, formato o fórmulas se consideran duplicados. Este método también quita las filas duplicadas ocultas de la vista (por ejemplo, debido a un filtro). El contenido fuera de este rango no se quita.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove rows which have duplicate values in column B.
range.removeDuplicates([2]);

// Remove rows which have duplicate values in both columns B and D.
range.removeDuplicates([2,4]);

Parámetros

Nombre	Tipo	Descripción
`columnsToCompare`	`Integer[]`	Las columnas en las que se analizarán los valores duplicados. Si no se proporcionan columnas y, luego, todas las columnas se analizan en busca de duplicados.

Volver

Range: Es el rango resultante después de quitar los duplicados. El tamaño del rango se reduce en una para cada fila que se quite.

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

`setBackground(color)`

Establece el color de fondo de todas las celdas del rango en notación CSS (como '#ffffff'). o 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
range.setBackground("red");

Parámetros

Nombre	Tipo	Descripción
`color`	`String`	Un código de color en notación CSS (como `'#ffffff'` o `'white'`) pañal El valor `null` restablece el color.

Volver

Range: Este rango para el encadenamiento.

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

`setBackgroundObject(color)`

Establece el color de fondo de todas las celdas del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var bgColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();

var range = sheet.getRange("B2:D5");
range.setBackgroundObject(bgColor);

Parámetros

Nombre	Tipo	Descripción
`color`	`Color`	El color de fondo que se establecerá; El valor `null` restablece el color de fondo.

Volver

Range: Este rango para el encadenamiento.

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

`setBackgroundObjects(color)`

Establece una cuadrícula rectangular de los colores de fondo (debe coincidir con las dimensiones de este intervalo).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setBackgroundObjects(colors);

Parámetros

Nombre	Tipo	Descripción
`color`	`Color[][]`	Un array de colores bidimensional. Los valores de `null` restablecen el color.

Volver

Range: Este rango para el encadenamiento.

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

`setBackgroundRGB(red, green, blue)`

Establece el fondo en el color determinado mediante valores RGB (números enteros entre 0 y 255 inclusive).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");

// Sets the background to white
cell.setBackgroundRGB(255, 255, 255);

// Sets the background to red
cell.setBackgroundRGB(255, 0, 0);

Parámetros

Nombre	Tipo	Descripción
`red`	`Integer`	Es el valor rojo en notación RGB.
`green`	`Integer`	Es el valor verde en notación RGB.
`blue`	`Integer`	Es el valor azul en notación RGB.

Volver

Range: Este rango para el encadenamiento.

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

`setBackgrounds(color)`

Establece una cuadrícula rectangular de los colores de fondo (debe coincidir con las dimensiones de este rango). Los colores están en notación CSS (como '#ffffff' o 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setBackgrounds(colors);

Parámetros

Nombre	Tipo	Descripción
`color`	`String[][]`	Array bidimensional de colores en notación CSS (como `'#ffffff'` o `'white'`); Los valores de `null` restablecen el color.

Volver

Range: Este rango para el encadenamiento.

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

`setBorder(top, left, bottom, right, vertical, horizontal)`

Establece la propiedad del borde. Los valores válidos son true (activado), false (desactivado) y null (sin cambios).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
cell.setBorder(true, null, true, null, false, false);

Parámetros

Nombre	Tipo	Descripción
`top`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`left`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`bottom`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`right`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`vertical`	`Boolean`	`true` para bordes verticales internos, `false` para ninguno, `null` para ningún cambio.
`horizontal`	`Boolean`	`true` para bordes horizontales internos, `false` para ninguno, `null` para ningún cambio.

Volver

Range: Este rango para el encadenamiento.

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

`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`

Establece la propiedad de borde con color o estilo. Los valores válidos son true (activado), false (desactivado) y null (sin cambios). Para el color, usa Color en la notación CSS (como '#ffffff' o 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
// Also sets the color to "red", and the border to "DASHED".
cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);

Parámetros

Nombre	Tipo	Descripción
`top`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`left`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`bottom`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`right`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`vertical`	`Boolean`	`true` para bordes verticales internos, `false` para ninguno, `null` para ningún cambio.
`horizontal`	`Boolean`	`true` para bordes horizontales internos, `false` para ninguno, `null` para ningún cambio.
`color`	`String`	Es un color en notación CSS (como `'#ffffff'` o `'white'`), `null` para el color predeterminado (negro).
`style`	`BorderStyle`	Es un estilo para los bordes, `null` para el estilo predeterminado (continuo).

Volver

Range: Este rango para el encadenamiento.

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

`setDataValidation(rule)`

Establece una regla de validación de datos para todas las celdas del rango.

// Set the data validation rule for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parámetros

Nombre	Tipo	Descripción
`rule`	`DataValidation`	La regla de validación de datos que se establecerá o `null` para quitar la validación de datos.

Volver

Range: Este rango para el encadenamiento.

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

`setDataValidations(rules)`

Establece las reglas de validación de datos para todas las celdas del rango. Este método toma un modelo de array de validaciones de datos, indexados por fila y, luego, por columna. Las dimensiones del array deben corresponder a las dimensiones del rango.

// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10.
var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
var rules = destinationRange.getDataValidations();
for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

Parámetros

Nombre	Tipo	Descripción
`rules`	`DataValidation[][]`	Un array bidimensional de reglas de validación de datos para configurar; `null` valores quitar la validación de datos.

Volver

Range: Este rango para el encadenamiento.

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

`setFontColor(color)`

Establece el color de la fuente en la notación CSS (como '#ffffff' o 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontColor("red");

Parámetros

Nombre	Tipo	Descripción
`color`	`String`	Es el color de la fuente en la notación CSS (como `'#ffffff'` o `'white'`). pañal El valor `null` restablece el color.

Volver

Range: Este rango para el encadenamiento.

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

`setFontColorObject(color)`

Establece el color de fuente del rango especificado.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();

var cell = sheet.getRange("B2");
cell.setFontColor(color);

Parámetros

Nombre	Tipo	Descripción
`color`	`Color`	El color de fuente que se establecerá; un valor de `null` restablece el color.

Volver

Range: Este rango para el encadenamiento.

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

`setFontColorObjects(colors)`

Establece una cuadrícula rectangular de los colores de fuente (debe coincidir con las dimensiones de este rango).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setFontColorObjects(colors);

Parámetros

Nombre	Tipo	Descripción
`colors`	`Color[][]`	Un array de colores bidimensional. Los valores `null` restablecen el color de la fuente.

Volver

Range: Este rango para el encadenamiento.

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

`setFontColors(colors)`

Establece una cuadrícula rectangular de los colores de fuente (debe coincidir con las dimensiones de este rango). Los colores están en Notación de CSS (como '#ffffff' o 'white')

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setFontColors(colors);

Parámetros

Nombre	Tipo	Descripción
`colors`	`Object[][]`	Array bidimensional de colores en notación CSS (como `'#ffffff'` o `'white'`); Los valores de `null` restablecen el color.

Volver

Range: Este rango para el encadenamiento.

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

`setFontFamilies(fontFamilies)`

Establece una cuadrícula rectangular de las familias de fuentes (debe coincidir con las dimensiones de este rango). Ejemplos de las familias de fuentes son “Arial” o "Helvetica".

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var fonts = [
  ["Arial", "Helvetica", "Verdana"],
  ["Courier New", "Arial", "Helvetica]
];

var cell = sheet.getRange("B2:D3");
cell.setFontFamilies(fonts);

Parámetros

Nombre	Tipo	Descripción
`fontFamilies`	`Object[][]`	una matriz bidimensional de familias de fuentes; Los valores de `null` restablecen el familia de fuentes.

Volver

Range: Este rango para el encadenamiento.

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

`setFontFamily(fontFamily)`

Configura la familia de fuentes, como "Arial". o "Helvetica".

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontFamily("Helvetica");

Parámetros

Nombre	Tipo	Descripción
`fontFamily`	`String`	La familia de fuentes que se va a establecer; un valor de `null` restablece la familia de fuentes.

Volver

Range: Este rango para el encadenamiento.

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

`setFontLine(fontLine)`

Establece el estilo de línea de fuente de un rango determinado ('underline', 'line-through' o 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontLine("line-through");

Parámetros

Nombre	Tipo	Descripción
`fontLine`	`String`	El estilo de línea de la fuente, ya sea `'underline'`, `'line-through'` o `'none'`; un valor `null` restablece el estilo de la línea de la fuente.

Volver

Range: Este rango para el encadenamiento.

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

`setFontLines(fontLines)`

Establece una cuadrícula rectangular de los estilos de línea (debe coincidir con las dimensiones de este rango).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontLines = [
  ["underline", "line-through", "none"]
];

var range = sheet.getRange("B2:D2");
range.setFontLines(fontLines);

Parámetros

Nombre	Tipo	Descripción
`fontLines`	`Object[][]`	Un array bidimensional de estilos de línea de fuente (`'underline'`, `'line-through'` o `'none'`) Los valores de `null` restablecen el estilo de línea de la fuente.

Volver

Range: Este rango para el encadenamiento.

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

`setFontSize(size)`

Establece el tamaño de fuente, que corresponde al tamaño de punto que se usará.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontSize(20);

Parámetros

Nombre	Tipo	Descripción
`size`	`Integer`	Es un tamaño de fuente expresado en puntos.

Volver

Range: Este rango para el encadenamiento.

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

`setFontSizes(sizes)`

Establece una cuadrícula rectangular de los tamaños de fuente (debe coincidir con las dimensiones de este rango). Los tamaños están en puntos.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontSizes = [
  [16, 20, 24]
];

var range = sheet.getRange("B2:D2");
range.setFontSizes(fontSizes);

Parámetros

Nombre	Tipo	Descripción
`sizes`	`Object[][]`	Un array de tamaños bidimensional.

Volver

Range: Este rango para el encadenamiento.

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

`setFontStyle(fontStyle)`

Establece el estilo de fuente para el rango especificado ('italic' o 'normal').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontStyle("italic");

Parámetros

Nombre	Tipo	Descripción
`fontStyle`	`String`	El estilo de fuente, `'italic'` o `'normal'`; un `null` valor restablece el estilo de fuente.

Volver

Range: Este rango para el encadenamiento.

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

`setFontStyles(fontStyles)`

Establece una cuadrícula rectangular de estilos de fuente (debe coincidir con las dimensiones de este rango).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  ["italic", "normal"]
];

var range = sheet.getRange("B2:C2");
range.setFontStyles(fontStyles);

Parámetros

Nombre	Tipo	Descripción
`fontStyles`	`Object[][]`	Es un array bidimensional de estilos de fuente, ya sea `'italic'` o `'normal'`. Los valores `null` restablecen el estilo de fuente.

Volver

Range: Este rango para el encadenamiento.

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

`setFontWeight(fontWeight)`

Define el grosor de la fuente para el rango especificado (normal/negrita).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontWeight("bold");

Parámetros

Nombre	Tipo	Descripción
`fontWeight`	`String`	El grosor de la fuente, que puede ser `'bold'` o `'normal'`; un `null` restablece el grosor de la fuente.

Volver

Range: Este rango para el encadenamiento.

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

`setFontWeights(fontWeights)`

Establece una cuadrícula rectangular de los tamaños de fuente (debe coincidir con las dimensiones de este rango). Un ejemplo de un el grosor de la fuente está en “negrita”.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  [ "bold", "bold", "normal" ]
];

var range = sheet.getRange("B2:D2");
range.setFontWeights(fontStyles);

Parámetros

Nombre	Tipo	Descripción
`fontWeights`	`Object[][]`	Es un array bidimensional de grosores de fuente, ya sea `'bold'` o `'normal'`. Los valores `null` restablecen el grosor de la fuente.

Volver

Range: Este rango para el encadenamiento.

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

`setFormula(formula)`

Actualiza la fórmula de este rango. La fórmula proporcionada debe estar en notación A1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
cell.setFormula("=SUM(B3:B4)");

Parámetros

Nombre	Tipo	Descripción
`formula`	`String`	Es una cadena que representa la fórmula que se debe establecer para la celda.

Volver

Range: Este rango para el encadenamiento.

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

`setFormulaR1C1(formula)`

Actualiza la fórmula de este rango. La fórmula proporcionada debe estar en la notación R1C1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
// This sets the formula to be the sum of the 3 rows above B5
cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");

Parámetros

Nombre	Tipo	Descripción
`formula`	`String`	Fórmula en cadena.

Volver

Range: Este rango para el encadenamiento.

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

`setFormulas(formulas)`

Establece una cuadrícula rectangular de fórmulas (debe coincidir con las dimensiones de este rango). Las fórmulas proporcionadas debe estar en notación A1. Este método toma un array bidimensional de fórmulas, indexadas por fila, luego por columna. Las dimensiones del array deben corresponder a las dimensiones del rango.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This sets the formulas to be a row of sums, followed by a row of averages right below.
// The size of the two-dimensional array must match the size of the range.
var formulas = [
  ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"],
  ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"]
];

var cell = sheet.getRange("B5:D6");
cell.setFormulas(formulas);

Parámetros

Nombre	Tipo	Descripción
`formulas`	`String[][]`	Es un array de fórmulas en cadena bidimensional.

Volver

Range: Este rango para el encadenamiento.

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

`setFormulasR1C1(formulas)`

Establece una cuadrícula rectangular de fórmulas (debe coincidir con las dimensiones de este rango). Las fórmulas proporcionadas debe estar en la notación R1C1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This creates formulas for a row of sums, followed by a row of averages.
var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])";
var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])";

// The size of the two-dimensional array must match the size of the range.
var formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove]
];

var cell = sheet.getRange("B5:D6");
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

Parámetros

Nombre	Tipo	Descripción
`formulas`	`String[][]`	Matriz bidimensional de fórmulas en formato R1C1.

Volver

Range: Este rango para el encadenamiento.

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

`setHorizontalAlignment(alignment)`

Establece la alineación horizontal (de izquierda a derecha) para el rango determinado (izquierda/centro/derecha).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setHorizontalAlignment("center");

Parámetros

Nombre	Tipo	Descripción
`alignment`	`String`	La alineación, ya sea `'left'`, `'center'` o `'normal'` pañal El valor `null` restablece la alineación.

Volver

Range: Este rango para el encadenamiento.

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

`setHorizontalAlignments(alignments)`

Establece una cuadrícula rectangular de alineaciones horizontales. consulta setHorizontalAlignment(alignment)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var horizontalAlignments = [
  [ "left", "right", "center" ]
];

var range = sheet.getRange("B2:D2");
range.setHorizontalAlignments(horizontalAlignments);

Parámetros

Nombre	Tipo	Descripción
`alignments`	`Object[][]`	Un array bidimensional de alineamientos, ya sea `'left'`, `'center'` o `'normal'` un valor `null` restablece la alineación.

Volver

Range: Este rango para el encadenamiento.

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

Consulta también

setHorizontalAlignment(alignment)

`setNote(note)`

Establece la nota en el valor dado.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setNote("This is a note");

Parámetros

Nombre	Tipo	Descripción
`note`	`String`	El valor de la nota que se va a establecer para el rango; un valor `null` quita la nota.

Volver

Range: Este rango para el encadenamiento.

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

`setNotes(notes)`

Establece una cuadrícula rectangular de notas (debe coincidir con las dimensiones de este rango).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var notes = [
  ["it goes", "like this", "the fourth, the fifth"],
  ["the minor fall", "and the", "major lift"]
];

var cell = sheet.getRange("B2:D3");
cell.setNotes(notes)

Parámetros

Nombre	Tipo	Descripción
`notes`	`Object[][]`	un array bidimensional de notas; Los valores de `null` quitan la nota.

Volver

Range: Este rango para el encadenamiento.

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

Consulta también

setNote(note)

`setNumberFormat(numberFormat)`

Establece el formato de número o fecha en la cadena de formato especificada. Los patrones de formato aceptados son que se describe en la documentación de la API de Hojas de cálculo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Always show 3 decimal points
cell.setNumberFormat("0.000");

Parámetros

Nombre	Tipo	Descripción
`numberFormat`	`String`	Es una cadena de formato de número.

Volver

Range: Este rango para el encadenamiento.

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

`setNumberFormats(numberFormats)`

Establece una cuadrícula rectangular en formatos de número o fecha (debe coincidir con las dimensiones de este período). El los valores son cadenas de patrón de formato como se describe en el artículo Documentación de la API de Hojas de cálculo

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var formats = [
  [ "0.000", "0,000,000", "$0.00" ]
];

var range = sheet.getRange("B2:D2");
range.setNumberFormats(formats);

Parámetros

Nombre	Tipo	Descripción
`numberFormats`	`Object[][]`	Es un array bidimensional de formatos de número.

Volver

Range: Este rango para el encadenamiento.

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

`setRichTextValue(value)`

Establece el valor de texto enriquecido para las celdas en el rango.

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var richText = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
range.setRichTextValue(richText);

Parámetros

Nombre	Tipo	Descripción
`value`	`RichTextValue`	Es el valor de texto enriquecido deseado.

Volver

Range: Este rango para el encadenamiento.

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

`setRichTextValues(values)`

Establece una cuadrícula rectangular de los valores de texto enriquecido.

// Sets the cells in range A1:A2 to have Rich Text values.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:A2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var italic = SpreadsheetApp.newTextStyle()
    .setItalic(true)
    .build();
var richTextA1 = SpreadsheetApp.newRichTextValue()
    .setText("This cell is bold")
    .setTextStyle(bold)
    .build();
var richTextA2 = SpreadsheetApp.newRichTextValue()
    .setText("bold words, italic words")
    .setTextStyle(0, 11, bold)
    .setTextStyle(12, 24, italic)
    .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

Parámetros

Nombre	Tipo	Descripción
`values`	`RichTextValue[][]`	Son los valores deseados de texto enriquecido.

Volver

Range: Este rango para el encadenamiento.

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

`setShowHyperlink(showHyperlink)`

Establece si el rango debe mostrar hipervínculos o no.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A30 and sets its hyperlink value.
const range = sheet.getRange('A30');
range.setValue('https://www.example.com');

// Sets cell A30 to show hyperlinks.
range.setShowHyperlink(true);

Parámetros

Nombre	Tipo	Descripción
`showHyperlink`	`Boolean`	Indica si se muestra o no el hipervínculo.

Volver

Range: Este rango para el encadenamiento.

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

`setTextDirection(direction)`

Establece la dirección del texto de las celdas en el rango. Si una dirección especificada es null, la dirección se infiere y, luego, se establece.

// Sets right-to-left text direction for the range.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parámetros

Nombre	Tipo	Descripción
`direction`	`TextDirection`	La dirección deseada del texto si `null`, la dirección se infiere antes del lugar.

Volver

Range: Este rango para el encadenamiento.

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

`setTextDirections(directions)`

Establece una cuadrícula rectangular de las direcciones de texto. Si una dirección especificada es null, el valor se infiere y luego se establece la dirección.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextDirections());

Parámetros

Nombre	Tipo	Descripción
`directions`	`TextDirection[][]`	las direcciones de texto deseadas; si una dirección especificada es `null`, es inferido antes de la configuración.

Volver

Range: Este rango para el encadenamiento.

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

`setTextRotation(degrees)`

Establece la configuración de rotación de texto de las celdas del rango. La entrada corresponde al ángulo entre la orientación estándar del texto y la orientación deseada. Una entrada de cero indica que el texto tenga la orientación estándar.

Para la dirección de texto de izquierda a derecha, los ángulos positivos son en sentido antihorario, mientras que de derecha a izquierda están en el sentido de las agujas del reloj.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setTextRotation(45);

Parámetros

Nombre	Tipo	Descripción
`degrees`	`Integer`	El ángulo deseado entre la orientación estándar y la deseada. Para el texto de izquierda a derecha, los ángulos positivos son en sentido antihorario.

Volver

Range: Este rango para el encadenamiento.

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

`setTextRotation(rotation)`

Establece la configuración de rotación de texto de las celdas del rango.

// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1.
var sheet = SpreadsheetApp.getActiveSheet();

var rotation = sheet.getRange("A1").getTextRotation();

sheet.getRange("B2:D4").setTextRotation(rotation);

Parámetros

Nombre	Tipo	Descripción
`rotation`	`TextRotation`	La configuración de rotación de texto deseada

Volver

Range: Este rango para el encadenamiento.

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

`setTextRotations(rotations)`

Establece una cuadrícula rectangular de las rotaciones de texto.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextRotations());

Parámetros

Nombre	Tipo	Descripción
`rotations`	`TextRotation[][]`	La configuración de rotación de texto deseada

Volver

Range: Este rango para el encadenamiento.

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

`setTextStyle(style)`

Establece el estilo de texto para las celdas del rango.

// Sets the cells in range C5:D6 to have underlined size 15 font.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("C5:D6");
var style = SpreadsheetApp.newTextStyle()
    .setFontSize(15)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

Parámetros

Nombre	Tipo	Descripción
`style`	`TextStyle`	El estilo de texto deseado

Volver

Range: Este rango para el encadenamiento.

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

`setTextStyles(styles)`

Establece una cuadrícula rectangular de estilos de texto.

// Sets text styles for cells in range A1:B2
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var otherStyle = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .setUnderline(true)
    .setItalic(true)
    .setForegroundColor("#335522")
    .setFontSize(44)
    .build();
range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);

Parámetros

Nombre	Tipo	Descripción
`styles`	`TextStyle[][]`	Los estilos de texto deseados.

Volver

Range: Este rango para el encadenamiento.

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

`setValue(value)`

Establece el valor del rango. El valor puede ser numérico, de cadena, booleano o de fecha. Si comienza con '=' se interpreta como una fórmula.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setValue(100);

Parámetros

Nombre	Tipo	Descripción
`value`	`Object`	Es el valor del rango.

Volver

Range: Este rango para el encadenamiento.

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

`setValues(values)`

Establece una cuadrícula rectangular de valores (debe coincidir con las dimensiones de este rango). Si un valor comienza con =, se interpreta como una fórmula.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var values = [
  [ "2.000", "1,000,000", "$2.99" ]
];

var range = sheet.getRange("B2:D2");
range.setValues(values);

Parámetros

Nombre	Tipo	Descripción
`values`	`Object[][]`	Es un array de valores bidimensional.

Volver

Range: Este rango para el encadenamiento.

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

`setVerticalAlignment(alignment)`

Establece la alineación vertical (de arriba a abajo) para el rango especificado (parte superior/medio/inferior).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setVerticalAlignment("middle");

Parámetros

Nombre	Tipo	Descripción
`alignment`	`String`	La alineación, ya sea `'top'`, `'middle'` o `'bottom'` pañal El valor `null` restablece la alineación.

Volver

Range: Este rango para el encadenamiento.

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

`setVerticalAlignments(alignments)`

Establece una cuadrícula rectangular de alineamientos verticales (debe coincidir con las dimensiones de este rango).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var alignments = [
  [ "top", "middle", "bottom" ]
];

var range = sheet.getRange("B2:D2");
range.setVerticalAlignments(alignments);

Parámetros

Nombre	Tipo	Descripción
`alignments`	`Object[][]`	Un array bidimensional de alineamientos, ya sea `'top'` o `'middle'` o `'bottom'`; un valor `null` restablece la alineación.

Volver

Range: Este rango para el encadenamiento.

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

Consulta también

setVerticalAlignment(alignment)

`setVerticalText(isVertical)`

Establece si se apilan o no el texto de las celdas del rango. Si el texto está apilado verticalmente, la configuración de rotación de grados se ignora.

// Sets all cell's in range B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setVerticalText(true);

Parámetros

Nombre	Tipo	Descripción
`isVertical`	`Boolean`	Indica si se debe apilar o no el texto.

Volver

Range: Este rango para el encadenamiento.

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

`setWrap(isWrapEnabled)`

Configura la unión de celdas para el rango determinado.

Las celdas con la función de ajuste habilitado (configuración predeterminada) cambian de tamaño para mostrar su contenido completo. Celdas con ajuste inhabilitados se muestran tanto como sea posible en la celda sin cambiar el tamaño ni ejecutar varias líneas.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setWrap(true);

Parámetros

Nombre	Tipo	Descripción
`isWrapEnabled`	`Boolean`	Indica si se debe ajustar o no el texto.

Volver

Range: Este rango para el encadenamiento.

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

`setWrapStrategies(strategies)`

Establece una cuadrícula rectangular de las estrategias de ajuste.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setWrapStrategies(range1.getWrapStrategies());

Parámetros

Nombre	Tipo	Descripción
`strategies`	`WrapStrategy[][]`	Las estrategias de unión deseadas

Volver

Range: Este rango para el encadenamiento.

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

`setWrapStrategy(strategy)`

Establece la estrategia de ajuste de texto para las celdas del rango.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parámetros

Nombre	Tipo	Descripción
`strategy`	`WrapStrategy`	La estrategia de unión deseada

Volver

Range: Este rango para el encadenamiento.

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

`setWraps(isWrapEnabled)`

Establece una cuadrícula rectangular de las políticas de ajuste de palabra (debe coincidir con las dimensiones de este rango). Celdas con ajuste habilitado (predeterminado) cambia su tamaño para mostrar todo su contenido. Celdas con ajuste inhabilitado mostrar tanto como sea posible en la celda sin cambiar el tamaño ni ejecutar varias líneas.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var wraps = [
  [ true, true, false ]
];

var range = sheet.getRange("B2:D2");
range.setWraps(wraps);

Parámetros

Nombre	Tipo	Descripción
`isWrapEnabled`	`Object[][]`	Array bidimensional de variables de unión que determina si se debe realizar o no texto en una celda o no.

Volver

Range: Este rango para el encadenamiento.

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

Consulta también

setWrap(isWrapEnabled)

`shiftColumnGroupDepth(delta)`

Cambia la profundidad de agrupamiento de columnas del rango según la cantidad especificada.

Esto tiene el efecto de crear, modificar o borrar grupos que se cruzan con la del rango de destino de la ruta. Para los deltas positivos, se crean o modifican grupos. Para los deltas negativos, los grupos se se destruyen o modifican.

Esto no tiene efecto cuando se disminuye la profundidad del grupo por debajo de cero o por encima de ocho.

Si el column group control position es BEFORE, esto arroja un error cuando se intenta cambiar la profundidad de la primera fila.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The column grouping depth is increased by 1.
range.shiftColumnGroupDepth(1);

// The column grouping depth is decreased by 1.
range.shiftColumnGroupDepth(-1);

Parámetros

Nombre	Tipo	Descripción
`delta`	`Integer`	La cantidad por la que se cambia la profundidad del grupo de columnas de este rango.

Volver

Range: Este rango para el encadenamiento.

Arroja

Error: Cuando intentas cambiar la profundidad de la primera columna cuando la posición de control es GroupControlTogglePosition.BEFORE

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

`shiftRowGroupDepth(delta)`

Cambia la profundidad de agrupación de filas del rango en la cantidad especificada.

Esto no tiene efecto cuando se disminuye la profundidad del grupo por debajo de cero o por encima de ocho.

Si row group control position es BEFORE, se muestra un error cuando se intenta cambiar el valor profundidad de la primera fila.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

Parámetros

Nombre	Tipo	Descripción
`delta`	`Integer`	La cantidad por la que se cambia la profundidad del grupo de filas de este rango.

Volver

Range: Este rango para el encadenamiento.

Arroja

Error: Cuando se intenta cambiar la profundidad de la primera fila cuando el control la posición es GroupControlTogglePosition.BEFORE

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

`sort(sortSpecObj)`

Ordena las celdas en el rango dado, por columna y orden especificados.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Sorts by the values in the first column (A)
range.sort(1);

// Sorts by the values in the second column (B)
range.sort(2);

// Sorts descending by column B
range.sort({column: 2, ascending: false});

// Sorts descending by column B, then ascending by column A
// Note the use of an array
range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]);

// For rows that are sorted in ascending order, the "ascending" parameter is
// optional, and just an integer with the column can be used instead. Note that
// in general, keeping the sort specification consistent results in more readable
// code. You can express the earlier sort as:
range.sort([{column: 2, ascending: false}, 1]);

// Alternatively, if you want all columns to be in ascending order, you can use
// the following (this makes column 2 ascending)
range.sort([2, 1]);
// ... which is equivalent to
range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);

Parámetros

Nombre	Tipo	Descripción
`sortSpecObj`	`Object`	Las columnas por las que se va a ordenar.

Volver

Range: Este rango para el encadenamiento.

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

`splitTextToColumns()`

Divide una columna de texto en varias columnas según un delimitador detectado automáticamente.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns();

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

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

`splitTextToColumns(delimiter)`

Divide una columna de texto en varias columnas con la cadena especificada como delimitador personalizado.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns('#');

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parámetros

Nombre	Tipo	Descripción
`delimiter`	`String`	El delimitador personalizado para dividir.

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

`splitTextToColumns(delimiter)`

Divide una columna de texto en varias columnas según el delimitador especificado.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parámetros

Nombre	Tipo	Descripción
`delimiter`	`TextToColumnsDelimiter`	El delimitador predeterminado para dividir.

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

`trimWhitespace()`

Corta los espacios en blanco (como espacios, tabulaciones o líneas nuevas) en todas las celdas de este rango. Quita espacio en blanco desde el principio y el final del texto de cada celda y reduce las subsecuencias de caracteres de espacio en blanco restantes a un solo espacio.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)'])

range.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

Volver

Range: Este rango para el encadenamiento.

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

`uncheck()`

Cambia el estado de las casillas de verificación del rango a "desmarcado". Ignora las celdas del rango que actualmente no incluyen el valor configurado ni el que está marcado ni desmarcado.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'unchecked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.uncheck();

Volver

Range: Este rango para el encadenamiento.

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

Métodos obsoletos

`getFontColor()`

Obsoleto. Se reemplazó por getFontColorObject()

Devuelve el color de fuente de la celda en la esquina superior izquierda del rango, en notación CSS (como como '#ffffff' o 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontColor());

Volver

String: Indica el color de fuente en notación CSS (como '#ffffff' o 'white').

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

`getFontColors()`

Obsoleto. Se reemplazó por getFontColorObjects()

Devuelve los colores de fuente de las celdas en el rango en notación CSS (como '#ffffff' o 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontColors();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Volver

String[][]: Es un array bidimensional de colores de fuente asociados con celdas del rango.

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