Class Range

Bereich

Zugreifen auf und Ändern von Tabellenbereichen. Ein Bereich kann eine einzelne Zelle auf einem Blatt oder eine Gruppe benachbarter Zellen auf einem Blatt sein.

Methoden

MethodeRückgabetypKurzbeschreibung
activate()RangeLegt den angegebenen Bereich als active range fest, wobei die linke obere Zelle im Bereich als current cell festgelegt ist.
activateAsCurrentCell()RangeLegt die angegebene Zelle als current cell fest.
addDeveloperMetadata(key)RangeFügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel hinzu.
addDeveloperMetadata(key, visibility)RangeFügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel und Sichtbarkeit hinzu.
addDeveloperMetadata(key, value)RangeFügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel und Wert hinzu.
addDeveloperMetadata(key, value, visibility)RangeFügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel, Wert und der Sichtbarkeit hinzu.
applyColumnBanding()BandingWendet ein standardmäßiges Spalten-Banddesign auf den Bereich an.
applyColumnBanding(bandingTheme)BandingWendet ein bestimmtes Spalten-Bandthema auf den Bereich an.
applyColumnBanding(bandingTheme, showHeader, showFooter)BandingWendet ein bestimmtes Spaltendesign auf den Bereich mit den angegebenen Kopf- und Fußzeileneinstellungen an.
applyRowBanding()BandingWendet ein Standarddesign für Zeilenbänder auf den Bereich an.
applyRowBanding(bandingTheme)BandingWendet ein bestimmtes Zeilen-Band-Design auf den Bereich an.
applyRowBanding(bandingTheme, showHeader, showFooter)BandingWendet ein bestimmtes Zeilendesign auf den Bereich mit den angegebenen Kopf- und Fußzeileneinstellungen an.
autoFill(destination, series)voidFüllt destinationRange mit Daten aus den Daten in diesem Bereich.
autoFillToNeighbor(series)voidBerechnet einen Bereich zum Füllen mit neuen Daten basierend auf benachbarten Zellen und füllt diesen Bereich automatisch mit neuen Werten basierend auf den in diesem Bereich enthaltenen Daten.
breakApart()RangeTeilen Sie alle mehrspaltigen Zellen im Bereich in einzelne Zellen auf.
canEdit()BooleanBestimmt, ob der Nutzer berechtigt ist, jede Zelle im Bereich zu bearbeiten.
check()RangeÄndert den Status der Kästchen im Bereich in „aktiviert“.
clear()RangeLöscht den Inhalts- und Formatbereich.
clear(options)RangeLöscht den Inhalt, das Format, die Datenvalidierungsregeln und/oder Kommentare, wie in den angegebenen erweiterten Optionen angegeben.
clearContent()RangeLöscht den Inhalt des Bereichs, wobei die Formatierung intakt bleibt.
clearDataValidations()RangeLöscht die Datenvalidierungsregeln für den Bereich.
clearFormat()RangeLöscht die Formatierung für diesen Bereich.
clearNote()RangeLöscht die Notiz in der angegebenen Zelle oder Zellen.
collapseGroups()RangeMinimiert alle Gruppen, die vollständig im Bereich enthalten sind.
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)voidKopiert die Formatierung des Bereichs an den angegebenen Ort.
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)voidKopiert die Formatierung des Bereichs an den angegebenen Ort.
copyTo(destination)voidKopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich.
copyTo(destination, copyPasteType, transposed)voidKopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich.
copyTo(destination, options)voidKopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich.
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)voidKopiert den Inhalt des Bereichs an den angegebenen Standort.
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)voidKopiert den Inhalt des Bereichs an den angegebenen Standort.
createDataSourcePivotTable(dataSource)DataSourcePivotTableErstellt eine leere Datenquellen-Pivot-Tabelle aus der Datenquelle, die an der ersten Zelle in diesem Bereich verankert ist.
createDataSourceTable(dataSource)DataSourceTableErstellt eine leere Datenquellentabelle aus der Datenquelle, die an der ersten Zelle in diesem Bereich verankert ist.
createDeveloperMetadataFinder()DeveloperMetadataFinderGibt eine DeveloperMetadataFinderApi zum Suchen von Entwicklermetadaten im Bereich dieses Bereichs zurück.
createFilter()FilterErstellt einen Filter und wendet ihn auf den angegebenen Bereich im Tabellenblatt an.
createPivotTable(sourceData)PivotTableErstellt eine leere Pivot-Tabelle aus dem angegebenen sourceData und ist an der ersten Zelle in diesem Bereich verankert.
createTextFinder(findText)TextFinderErstellt eine Textsuche für den Bereich, mit der Text in diesem Bereich gesucht und ersetzt werden kann.
deleteCells(shiftDimension)voidLöscht diesen Zellenbereich
expandGroups()RangeMaximiert die minimierten Gruppen, deren Bereich oder Ein-/Aus-Schaltflächen sich mit diesem Bereich überschneiden.
getA1Notation()StringGibt eine Zeichenfolgenbeschreibung des Bereichs in A1-Notation zurück.
getBackground()StringGibt die Hintergrundfarbe der oberen linken Zelle im Bereich zurück (z. B. '#ffffff').
getBackgroundObject()ColorGibt die Hintergrundfarbe der oberen linken Zelle im Bereich zurück.
getBackgroundObjects()Color[][]Gibt die Hintergrundfarben der Zellen im Bereich zurück.
getBackgrounds()String[][]Gibt die Hintergrundfarben der Zellen im Bereich zurück (z. B. '#ffffff').
getBandings()Banding[]Gibt alle Bandings zurück, die auf alle Zellen in diesem Bereich angewendet werden.
getCell(row, column)RangeGibt eine bestimmte Zelle in einem Bereich zurück.
getColumn()IntegerGibt die Startposition der Spalte für diesen Bereich zurück.
getDataRegion()RangeGibt eine Kopie des Bereichs zurück, der in den vier Kardinal-Directions maximiert wurde, um alle benachbarten Zellen mit Daten abzudecken.
getDataRegion(dimension)RangeGibt eine Kopie des erweiterten Bereichs Direction.UP und Direction.DOWN zurück, wenn die angegebene Dimension Dimension.ROWS ist, oder Direction.NEXT und Direction.PREVIOUS, wenn die Dimension Dimension.COLUMNS ist.
getDataSourceFormula()DataSourceFormulaGibt DataSourceFormula für die erste Zelle im Bereich oder null zurück, wenn die Zelle keine Datenquellenformel enthält.
getDataSourceFormulas()DataSourceFormula[]Gibt die DataSourceFormulas für die Zellen im Bereich zurück.
getDataSourcePivotTables()DataSourcePivotTable[]Ruft alle Pivot-Tabellen der Datenquelle ab, die sich mit dem Bereich überschneiden.
getDataSourceTables()DataSourceTable[]Ruft alle Datenquellentabellen ab, die sich mit dem Bereich überschneiden.
getDataSourceUrl()StringGibt eine URL für die Daten in diesem Bereich zurück, die zum Erstellen von Diagrammen und Abfragen verwendet werden kann.
getDataTable()DataTableGibt die Daten in diesem Objekt als DataTable zurück.
getDataTable(firstRowIsHeader)DataTableGibt die Daten in diesem Bereich als DataTable zurück.
getDataValidation()DataValidationGibt die Datenvalidierungsregel für die linke obere Zelle im Bereich zurück.
getDataValidations()DataValidation[][]Gibt die Datenvalidierungsregeln für alle Zellen im Bereich zurück.
getDeveloperMetadata()DeveloperMetadata[]Ruft die mit diesem Bereich verknüpften Entwicklermetadaten ab
getDisplayValue()StringGibt den angezeigten Wert der linken oberen Zelle im Bereich zurück
getDisplayValues()String[][]Gibt das rechteckige Werteraster für diesen Bereich zurück.
getFilter()FilterGibt den Filter für das Tabellenblatt zurück, zu dem dieser Bereich gehört, oder null, wenn im Tabellenblatt kein Filter vorhanden ist
getFontColorObject()ColorGibt die Schriftfarbe der Zelle in der oberen linken Ecke des Bereichs zurück.
getFontColorObjects()Color[][]Gibt die Schriftfarben der Zellen im Bereich zurück.
getFontFamilies()String[][]Gibt die Schriftfamilien der Zellen im Bereich zurück.
getFontFamily()StringGibt die Schriftfamilie der Zelle in der oberen linken Ecke des Bereichs zurück.
getFontLine()StringRuft den Linienstil der Zelle in der oberen linken Ecke des Bereichs ab ('underline', 'line-through' oder 'none').
getFontLines()String[][]Ruft den Linienstil der Zellen im Bereich ab ('underline', 'line-through' oder 'none').
getFontSize()IntegerGibt die Schriftgröße der Zelle in der oberen linken Ecke des Bereichs als Punktgröße zurück.
getFontSizes()Integer[][]Gibt die Schriftgrößen der Zellen im Bereich zurück.
getFontStyle()StringGibt den Schriftstil ('italic' oder 'normal') der Zelle in der oberen linken Ecke des Bereichs zurück.
getFontStyles()String[][]Gibt die Schriftstile der Zellen im Bereich zurück
getFontWeight()StringGibt die Schriftstärke (normal/fett) der Zelle in der oberen linken Ecke des Bereichs zurück.
getFontWeights()String[][]Gibt die Schriftstärken der Zellen im Bereich zurück.
getFormula()StringGibt die Formel (A1-Notation) für die linke obere Zelle des Bereichs oder einen leeren String zurück, wenn die Zelle leer ist oder keine Formel enthält.
getFormulaR1C1()StringGibt die Formel (R1C1-Notation) für eine bestimmte Zelle zurück oder null, wenn keine Zelle ausgegeben wird.
getFormulas()String[][]Gibt die Formeln (A1-Notation) für die Zellen im Bereich zurück.
getFormulasR1C1()String[][]Gibt die Formeln (R1C1-Notation) für die Zellen im Bereich zurück.
getGridId()IntegerGibt die Raster-ID des übergeordneten Tabellenblatts des Bereichs zurück
getHeight()IntegerGibt die Höhe des Bereichs zurück
getHorizontalAlignment()StringGibt die horizontale Ausrichtung des Texts (links/zentriert/rechts) der Zelle in der oberen linken Ecke des Bereichs zurück.
getHorizontalAlignments()String[][]Gibt die horizontalen Ausrichtungen der Zellen im Bereich zurück.
getLastColumn()IntegerGibt die Position der Endspalte zurück.
getLastRow()IntegerGibt die Position der Endzeile zurück
getMergedRanges()Range[]Gibt ein Array von Range-Objekten zurück, die zusammengeführte Zellen darstellen, die entweder vollständig im aktuellen Bereich liegen oder mindestens eine Zelle im aktuellen Bereich enthalten.
getNextDataCell(direction)RangeAusgehend von der Zelle in der ersten Spalte und Zeile des Bereichs wird die nächste Zelle in der angegebenen Richtung zurückgegeben, also der Rand eines zusammenhängenden Zellenbereichs mit Daten in ihnen oder der Zelle am Rand der Tabelle in dieser Richtung.
getNote()StringGibt den Hinweis zurück, der dem angegebenen Bereich zugeordnet ist.
getNotes()String[][]Gibt die mit den Zellen im Bereich verknüpften Notizen zurück.
getNumColumns()IntegerGibt die Anzahl der Spalten in diesem Bereich zurück.
getNumRows()IntegerGibt die Anzahl der Zeilen in diesem Bereich zurück.
getNumberFormat()StringRuft die Zahlen- oder Datumsformatierung der oberen linken Zelle des angegebenen Bereichs ab.
getNumberFormats()String[][]Gibt das Zahlen- oder Datumsformat für die Zellen im Bereich zurück.
getRichTextValue()RichTextValueGibt den Rich-Text-Wert für die linke obere Zelle des Bereichs oder null zurück, wenn der Zellenwert kein Text ist.
getRichTextValues()RichTextValue[][]Gibt die Rich-Text-Werte für die Zellen im Bereich zurück.
getRow()IntegerGibt die Zeilenposition für diesen Bereich zurück.
getRowIndex()IntegerGibt die Zeilenposition für diesen Bereich zurück.
getSheet()SheetGibt das Tabellenblatt zurück, zu dem dieser Bereich gehört
getTextDirection()TextDirectionGibt die Textrichtung für die obere linke Zelle des Bereichs zurück.
getTextDirections()TextDirection[][]Gibt die Textrichtungen für die Zellen im Bereich zurück.
getTextRotation()TextRotationGibt die Einstellungen für die Textdrehung für die linke obere Zelle des Bereichs zurück
getTextRotations()TextRotation[][]Gibt die Textrotationseinstellungen für die Zellen im Bereich zurück.
getTextStyle()TextStyleGibt den Textstil für die linke obere Zelle des Bereichs zurück
getTextStyles()TextStyle[][]Gibt die Textstile für die Zellen im Bereich zurück.
getValue()ObjectGibt den Wert der oberen linken Zelle im Bereich zurück.
getValues()Object[][]Gibt das rechteckige Werteraster für diesen Bereich zurück.
getVerticalAlignment()StringGibt die vertikale Ausrichtung (oben/Mitte/unten) der Zelle in der oberen linken Ecke des Bereichs zurück.
getVerticalAlignments()String[][]Gibt die vertikalen Ausrichtung der Zellen im Bereich zurück.
getWidth()IntegerGibt die Breite des Bereichs in Spalten zurück.
getWrap()BooleanGibt zurück, ob der Text in der Zelle umgebrochen wird.
getWrapStrategies()WrapStrategy[][]Gibt die Strategien für den Textumbruch für die Zellen im Bereich zurück.
getWrapStrategy()WrapStrategyGibt die Textumbruchstrategie für die obere linke Zelle des Bereichs zurück.
getWraps()Boolean[][]Gibt zurück, ob der Text in den Zellen umgebrochen wird.
insertCells(shiftDimension)RangeFügt leere Zellen in diesen Bereich ein.
insertCheckboxes()RangeFügt in jede Zelle des Bereichs ein Kästchen ein, das mit true (aktiviert) und false (deaktiviert) konfiguriert ist.
insertCheckboxes(checkedValue)RangeFügt in jede Zelle des Bereichs Kästchen ein, die mit einem benutzerdefinierten Wert für aktiviert und dem leeren String für deaktivierte Zellen konfiguriert ist.
insertCheckboxes(checkedValue, uncheckedValue)RangeFügt in jede Zelle des Bereichs Kästchen ein, die mit benutzerdefinierten Werten für den aktivierten und deaktivierten Status konfiguriert sind.
isBlank()BooleanGibt true zurück, wenn der Bereich vollständig leer ist.
isChecked()BooleanGibt zurück, ob das Kästchen für alle Zellen im Bereich „aktiviert“ ist.
isEndColumnBounded()BooleanBestimmt, ob das Ende des Bereichs an eine bestimmte Spalte gebunden ist.
isEndRowBounded()BooleanBestimmt, ob das Ende des Bereichs an eine bestimmte Zeile gebunden ist.
isPartOfMerge()BooleanGibt true zurück, wenn sich die Zellen im aktuellen Bereich mit verbundenen Zellen überschneiden.
isStartColumnBounded()BooleanBestimmt, ob der Anfang des Bereichs an eine bestimmte Spalte gebunden ist.
isStartRowBounded()BooleanBestimmt, ob der Anfang des Bereichs an eine bestimmte Zeile gebunden ist.
merge()RangeFührt die Zellen in dem Bereich zu einem einzelnen Block zusammen.
mergeAcross()RangeFühren Sie die Zellen in dem Bereich über die Spalten des Bereichs hinweg zusammen.
mergeVertically()RangeFührt die Zellen im Bereich zusammen.
moveTo(target)voidAusschneiden und Einfügen (sowohl Format als auch Werte) aus diesem Bereich in den Zielbereich.
offset(rowOffset, columnOffset)RangeGibt einen neuen Bereich zurück, der um die angegebene Anzahl von Zeilen und Spalten (die negativ sein kann) von diesem Bereich entfernt sind.
offset(rowOffset, columnOffset, numRows)RangeGibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist, dessen oberer linker Punkt vom aktuellen Bereich um die angegebenen Zeilen und Spalten versetzt ist und mit der angegebenen Höhe in Zellen.
offset(rowOffset, columnOffset, numRows, numColumns)RangeGibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist, dessen oberer linker Punkt vom aktuellen Bereich um die angegebenen Zeilen und Spalten versetzt ist und mit der angegebenen Höhe und Breite in den Zellen.
protect()ProtectionErstellt ein Objekt, das verhindern kann, dass der Bereich bearbeitet wird, außer von Nutzern mit entsprechender Berechtigung.
randomize()RangeOrdnet die Reihenfolge der Zeilen im angegebenen Bereich zufällig an.
removeCheckboxes()RangeEntfernt alle Kästchen aus dem Bereich.
removeDuplicates()RangeEntfernt Zeilen in diesem Bereich, die Werte enthalten, die Duplikate von Werten in einer vorherigen Zeile sind.
removeDuplicates(columnsToCompare)RangeEntfernt Zeilen in diesem Bereich, die Werte in den angegebenen Spalten enthalten, die Duplikate von Werten aus einer vorherigen Zeile sind.
setBackground(color)RangeLegt die Hintergrundfarbe aller Zellen im Bereich in CSS-Notation fest (z. B. '#ffffff' oder 'white').
setBackgroundObject(color)RangeLegt die Hintergrundfarbe aller Zellen im Bereich fest.
setBackgroundObjects(color)RangeLegt ein rechteckiges Raster mit Hintergrundfarben fest (muss den Abmessungen dieses Bereichs entsprechen).
setBackgroundRGB(red, green, blue)RangeLegt den Hintergrund mithilfe von RGB-Werten (Ganzzahlen zwischen 0 und 255 einschließlich) auf die angegebene Farbe fest.
setBackgrounds(color)RangeLegt ein rechteckiges Raster mit Hintergrundfarben fest (muss den Abmessungen dieses Bereichs entsprechen).
setBorder(top, left, bottom, right, vertical, horizontal)RangeLegt die Eigenschaft Rahmen fest.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)RangeLegt die Rahmeneigenschaft mit Farbe und/oder Stil fest.
setDataValidation(rule)RangeLegt eine Datenvalidierungsregel für alle Zellen im Bereich fest.
setDataValidations(rules)RangeLegt die Datenvalidierungsregeln für alle Zellen im Bereich fest.
setFontColor(color)RangeLegt die Schriftfarbe in CSS-Notation (z. B. '#ffffff' oder 'white') fest.
setFontColorObject(color)RangeLegt die Schriftfarbe des angegebenen Bereichs fest.
setFontColorObjects(colors)RangeLegt ein rechteckiges Raster mit Schriftfarben fest (muss den Abmessungen dieses Bereichs entsprechen).
setFontColors(colors)RangeLegt ein rechteckiges Raster mit Schriftfarben fest (muss den Abmessungen dieses Bereichs entsprechen).
setFontFamilies(fontFamilies)RangeLegt ein rechteckiges Raster von Schriftfamilien fest (muss den Abmessungen dieses Bereichs entsprechen).
setFontFamily(fontFamily)RangeLegt die Schriftfamilie fest, z. B. "Arial" oder "Helvetica"
setFontLine(fontLine)RangeLegt den Schriftlinienstil des angegebenen Bereichs fest ('underline', 'line-through' oder 'none').
setFontLines(fontLines)RangeLegt ein rechteckiges Raster von Linienstilen fest (muss den Abmessungen dieses Bereichs entsprechen).
setFontSize(size)RangeLegt die Schriftgröße fest, wobei die Größe die zu verwendende Punktgröße ist.
setFontSizes(sizes)RangeLegt ein rechteckiges Raster mit Schriftgrößen fest (muss den Abmessungen dieses Bereichs entsprechen).
setFontStyle(fontStyle)RangeLegen Sie den Schriftstil für den angegebenen Bereich fest ('italic' oder 'normal').
setFontStyles(fontStyles)RangeLegt ein rechteckiges Raster mit Schriftstilen fest (muss den Abmessungen dieses Bereichs entsprechen).
setFontWeight(fontWeight)RangeLegt die Schriftstärke für den angegebenen Bereich fest (normal/fett).
setFontWeights(fontWeights)RangeLegt ein rechteckiges Raster mit Schriftstärken fest (muss den Abmessungen dieses Bereichs entsprechen).
setFormula(formula)RangeAktualisiert die Formel für diesen Bereich.
setFormulaR1C1(formula)RangeAktualisiert die Formel für diesen Bereich.
setFormulas(formulas)RangeLegt ein rechteckiges Raster aus Formeln fest (muss den Abmessungen dieses Bereichs entsprechen).
setFormulasR1C1(formulas)RangeLegt ein rechteckiges Raster aus Formeln fest (muss den Abmessungen dieses Bereichs entsprechen).
setHorizontalAlignment(alignment)RangeLegen Sie die horizontale Ausrichtung (links nach rechts) für den angegebenen Bereich fest (links/zentriert/rechts).
setHorizontalAlignments(alignments)RangeLegt ein rechteckiges Raster mit horizontalen Ausrichtungen fest.
setNote(note)RangeSetzt die Notiz auf den angegebenen Wert.
setNotes(notes)RangeLegt ein rechteckiges Raster aus Notizen fest (muss den Abmessungen dieses Bereichs entsprechen).
setNumberFormat(numberFormat)RangeLegt das Zahlen- oder Datumsformat auf den angegebenen Formatierungsstring fest.
setNumberFormats(numberFormats)RangeLegt ein rechteckiges Raster mit Zahlen- oder Datumsformaten fest (muss den Abmessungen dieses Bereichs entsprechen).
setRichTextValue(value)RangeLegt den Rich-Text-Wert für die Zellen im Bereich fest.
setRichTextValues(values)RangeLegt ein rechteckiges Raster mit Rich-Text-Werten fest.
setShowHyperlink(showHyperlink)RangeLegt fest, ob im Bereich Hyperlinks angezeigt werden sollen.
setTextDirection(direction)RangeLegt die Textrichtung für die Zellen im Bereich fest.
setTextDirections(directions)RangeLegt ein rechteckiges Raster mit Textrichtungen fest.
setTextRotation(degrees)RangeLegt die Textrotationseinstellungen für die Zellen im Bereich fest.
setTextRotation(rotation)RangeLegt die Textrotationseinstellungen für die Zellen im Bereich fest.
setTextRotations(rotations)RangeLegt ein rechteckiges Raster von Textrotationen fest.
setTextStyle(style)RangeLegt den Textstil für die Zellen im Bereich fest.
setTextStyles(styles)RangeLegt ein rechteckiges Raster mit Textstilen fest.
setValue(value)RangeLegt den Wert des Bereichs fest.
setValues(values)RangeLegt ein rechteckiges Werteraster fest (muss den Dimensionen dieses Bereichs entsprechen).
setVerticalAlignment(alignment)RangeLegen Sie die vertikale Ausrichtung (von oben nach unten) für den angegebenen Bereich (oben/Mitte/unten) fest.
setVerticalAlignments(alignments)RangeLegt ein rechteckiges Raster mit vertikalen Ausrichtungen fest (muss den Abmessungen dieses Bereichs entsprechen).
setVerticalText(isVertical)RangeLegt fest, ob der Text für die Zellen im Bereich gestapelt werden soll.
setWrap(isWrapEnabled)RangeLegt den Zellenumbruch des angegebenen Bereichs fest.
setWrapStrategies(strategies)RangeLegt ein rechteckiges Raster mit Zusammenfassungsstrategien fest.
setWrapStrategy(strategy)RangeLegt die Textumbruchstrategie für die Zellen im Bereich fest.
setWraps(isWrapEnabled)RangeLegt ein rechteckiges Raster von Richtlinien für den Zeilenumbruch fest (muss den Abmessungen dieses Bereichs entsprechen).
shiftColumnGroupDepth(delta)RangeÄndert die Spaltengruppierungstiefe des Bereichs um den angegebenen Wert.
shiftRowGroupDepth(delta)RangeÄndert die Tiefe der Zeilengruppierung des Bereichs um den angegebenen Wert.
sort(sortSpecObj)RangeSortiert die Zellen im angegebenen Bereich nach der angegebenen Spalte und Reihenfolge.
splitTextToColumns()voidTeilt eine Textspalte anhand eines automatisch erkannten Trennzeichens in mehrere Spalten auf.
splitTextToColumns(delimiter)voidTeilt eine Textspalte mithilfe des angegebenen Strings als benutzerdefiniertes Trennzeichen in mehrere Spalten auf.
splitTextToColumns(delimiter)voidTeilt eine Textspalte basierend auf dem angegebenen Trennzeichen in mehrere Spalten auf.
trimWhitespace()RangeHierbei werden Leerräume (z. B. Leerzeichen, Tabulatoren oder neue Zeilen) in allen Zellen in diesem Bereich entfernt.
uncheck()RangeÄndert den Status der Kästchen im Bereich zu „Nicht angeklickt“.

Detaillierte Dokumentation

activate()

Legt den angegebenen Bereich als active range fest, wobei die linke obere Zelle im Bereich als current cell festgelegt ist.

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

Rückflug

Range: Dieser Bereich für Verkettungen.


activateAsCurrentCell()

Legt die angegebene Zelle als current cell fest.

Wenn sich die angegebene Zelle in einem vorhandenen Bereich befindet, wird dieser Bereich zum aktiven Bereich mit der Zelle als aktuelle Zelle.

Wenn die angegebene Zelle in keinem vorhandenen Bereich vorhanden ist, wird die vorhandene Auswahl entfernt und die Zelle wird zur aktuellen Zelle und zum aktiven Bereich.

Hinweis:Der angegebene Range muss aus einer Zelle bestehen. Andernfalls wird eine Ausnahme ausgelöst.

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

addDeveloperMetadata(key)

Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel hinzu.

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

Parameter

NameTypBeschreibung
keyStringDer Schlüssel für die neuen Entwicklermetadaten.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

addDeveloperMetadata(key, visibility)

Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel und Sichtbarkeit hinzu.

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

Parameter

NameTypBeschreibung
keyStringDer Schlüssel für die neuen Entwicklermetadaten.
visibilityDeveloperMetadataVisibilityDie Sichtbarkeit der neuen Entwicklermetadaten.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

addDeveloperMetadata(key, value)

Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel und Wert hinzu.

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

Parameter

NameTypBeschreibung
keyStringDer Schlüssel für die neuen Entwicklermetadaten.
valueStringDer Wert für die neuen Entwicklermetadaten.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

addDeveloperMetadata(key, value, visibility)

Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel, Wert und der Sichtbarkeit hinzu.

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

Parameter

NameTypBeschreibung
keyStringDer Schlüssel für die neuen Entwicklermetadaten.
valueStringDer Wert für die neuen Entwicklermetadaten.
visibilityDeveloperMetadataVisibilityDie Sichtbarkeit der neuen Entwicklermetadaten.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

applyColumnBanding()

Wendet ein standardmäßiges Spalten-Banddesign auf den Bereich an. Standardmäßig wird für das Banding eine Kopf- und keine Fußzeile verwendet.

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

Rückflug

Banding – Das neue Banding.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

applyColumnBanding(bandingTheme)

Wendet ein bestimmtes Spalten-Bandthema auf den Bereich an. Standardmäßig wird für das Banding eine Kopf- und keine Fußzeile verwendet.

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

Parameter

NameTypBeschreibung
bandingThemeBandingThemeEin Farbdesign, das auf die Spalten im Bereich angewendet werden soll.

Rückflug

Banding – Das neue Banding.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

applyColumnBanding(bandingTheme, showHeader, showFooter)

Wendet ein bestimmtes Spaltendesign auf den Bereich mit den angegebenen Kopf- und Fußzeileneinstellungen an.

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

Parameter

NameTypBeschreibung
bandingThemeBandingThemeEin Farbdesign, das auf die Spalten im Bereich angewendet werden soll.
showHeaderBooleanBei true wird die Kopfzeilenfarbe des Banding-Designs auf die erste Spalte angewendet.
showFooterBooleanWenn true, wird die Fußzeile des Streifendesigns auf die letzte Spalte angewendet.

Rückflug

Banding – Das neue Banding.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

applyRowBanding()

Wendet ein Standarddesign für Zeilenbänder auf den Bereich an. Standardmäßig wird für das Banding eine Kopf- und keine Fußzeile verwendet.

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

Rückflug

Banding: Das Banding.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

applyRowBanding(bandingTheme)

Wendet ein bestimmtes Zeilen-Band-Design auf den Bereich an. Standardmäßig wird für das Banding eine Kopf- und keine Fußzeile verwendet.

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

Parameter

NameTypBeschreibung
bandingThemeBandingThemeEin Farbdesign, das auf die Zeilen im Bereich angewendet werden soll.

Rückflug

Banding – Das neue Banding.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

applyRowBanding(bandingTheme, showHeader, showFooter)

Wendet ein bestimmtes Zeilendesign auf den Bereich mit den angegebenen Kopf- und Fußzeileneinstellungen an.

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

Parameter

NameTypBeschreibung
bandingThemeBandingThemeEin Farbdesign, das auf die Zeilen im Bereich angewendet werden soll.
showHeaderBooleanBei true wird die Kopfzeilenfarbe des Streifendesigns auf die erste Zeile angewendet.
showFooterBooleanWenn true, wird die Fußzeilenfarbe des Streifendesigns auf die letzte Zeile angewendet.

Rückflug

Banding – Das neue Banding.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

autoFill(destination, series)

Füllt destinationRange mit Daten aus den Daten in diesem Bereich. Die neuen Werte werden auch durch den angegebenen series-Typ bestimmt. Der Zielbereich muss diesen Bereich enthalten und nur in eine Richtung erweitert werden. Im folgenden Beispiel wird A1:A20 mit einer Reihe ansteigender Zahlen basierend auf den aktuellen Werten in A1:A4 gefüllt:

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);

Parameter

NameTypBeschreibung
destinationRangeBereich, der automatisch mit Werten gefüllt werden soll Der Zielbereich sollte diesen Bereich enthalten und nur in eine Richtung erweitert werden (nach oben, unten, links oder rechts).
seriesAutoFillSeriesDer Typ der AutoFill-Serie, die zur Berechnung neuer Werte verwendet werden soll. Die Auswirkungen dieser Reihe variieren je nach Typ und Menge der Quelldaten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

autoFillToNeighbor(series)

Berechnet einen Bereich zum Füllen mit neuen Daten basierend auf benachbarten Zellen und füllt diesen Bereich automatisch mit neuen Werten basierend auf den in diesem Bereich enthaltenen Daten. Diese neuen Werte werden auch durch den angegebenen series-Typ bestimmt.

Der berechnete Zielbereich berücksichtigt die umgebenden Daten, um zu bestimmen, wo die neuen Werte eingefügt werden sollen: Wenn sich direkt links oder rechts einer Spalte befinden, die automatisch ausgefüllt wird, reichen neue Werte nur bis zu diesen benachbarten Daten.

Wenn A1:A20 beispielsweise mit einer Reihe ansteigender Zahlen gefüllt wird und diese Methode für den Bereich B1:B4 aufgerufen wird, der eine Reihe von Datumsangaben enthält, werden neue Werte nur in B5:B20 eingefügt. Auf diese Weise bleiben diese neuen Werte an den Zellen fixiert, die Werte in Spalte A enthalten.

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);

Parameter

NameTypBeschreibung
seriesAutoFillSeriesDer Typ der AutoFill-Serie, die zur Berechnung neuer Werte verwendet werden soll. Die Auswirkungen dieser Reihe variieren je nach Typ und Menge der Quelldaten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

breakApart()

Teilen Sie alle mehrspaltigen Zellen im Bereich in einzelne Zellen auf.

Der Aufruf dieser Funktion für einen Bereich entspricht dem Auswählen eines Bereichs und Klicken auf Format > Zellen verbinden > Verbindung aufheben.

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

canEdit()

Bestimmt, ob der Nutzer berechtigt ist, jede Zelle im Bereich zu bearbeiten. Der Eigentümer der Tabelle kann geschützte Bereiche und Tabellenblätter jederzeit bearbeiten.

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

Rückflug

Boolean: true, wenn der Nutzer berechtigt ist, jede Zelle im Bereich zu bearbeiten; andernfalls false.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

check()

Ändert den Status der Kästchen im Bereich in „aktiviert“. Die Zellen im Bereich, die derzeit weder den konfigurierten als auch den deaktivierten Wert enthalten, werden ignoriert.

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

clear()

Löscht den Inhalts- und Formatbereich.

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

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

clear(options)

Löscht den Inhalt, das Format, die Datenvalidierungsregeln und/oder Kommentare, wie in den angegebenen erweiterten Optionen angegeben. Standardmäßig werden alle Daten gelöscht.

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

Parameter

NameTypBeschreibung
optionsObjectEin JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt.

Erweiterte Parameter

NameTypBeschreibung
commentsOnlyBooleanGibt an, ob nur die Kommentare gelöscht werden sollen.
contentsOnlyBooleanGibt an, ob nur der Inhalt gelöscht werden soll.
formatOnlyBooleanGibt an, ob nur das Format gelöscht werden soll. Beim Löschen des Formats werden auch die Datenvalidierungsregeln gelöscht.
validationsOnlyBooleanGibt an, ob nur Datenvalidierungsregeln gelöscht werden sollen.
skipFilteredRowsBooleanGibt an, ob gefilterte Zeilen nicht gelöscht werden sollen.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

clearContent()

Löscht den Inhalt des Bereichs, wobei die Formatierung intakt bleibt.

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

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

clearDataValidations()

Löscht die Datenvalidierungsregeln für den Bereich.

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

clearFormat()

Löscht die Formatierung für diesen Bereich.

Dadurch wird die Textformatierung der Zelle oder Zellen im Bereich gelöscht, aber keine Formatierungsregeln für Zahlen zurückgesetzt.

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

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

clearNote()

Löscht die Notiz in der angegebenen Zelle oder Zellen.

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

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

collapseGroups()

Minimiert alle Gruppen, die vollständig im Bereich enthalten sind. Wenn sich keine Gruppe vollständig innerhalb des Bereichs befindet, wird die tiefste erweiterte Gruppe, die sich teilweise innerhalb des Bereichs befindet, minimiert.

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

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

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

Kopiert die Formatierung des Bereichs an den angegebenen Ort. Wenn das Ziel größer oder kleiner als der Quellbereich ist, wird die Quelle wiederholt oder entsprechend gekürzt. Beachten Sie, dass bei dieser Methode nur die Formatierung kopiert wird.

Eine ausführliche Beschreibung des Parameters GridId finden Sie unter 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);

Parameter

NameTypBeschreibung
gridIdIntegerDie eindeutige ID des Tabellenblatts innerhalb der Tabelle, unabhängig von der Position.
columnIntegerDie erste Spalte des Zielbereichs.
columnEndIntegerDie Endspalte des Zielbereichs.
rowIntegerStartzeile des Zielbereichs.
rowEndIntegerDie Endzeile des Zielbereichs.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen


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

Kopiert die Formatierung des Bereichs an den angegebenen Ort. Wenn das Ziel größer oder kleiner als der Quellbereich ist, wird die Quelle wiederholt oder entsprechend gekürzt. Beachten Sie, dass bei dieser Methode nur die Formatierung kopiert wird.

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);

Parameter

NameTypBeschreibung
sheetSheetDas Zielblatt.
columnIntegerDie erste Spalte des Zielbereichs.
columnEndIntegerDie Endspalte des Zielbereichs.
rowIntegerStartzeile des Zielbereichs.
rowEndIntegerDie Endzeile des Zielbereichs.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

copyTo(destination)

Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich. Sowohl die Werte als auch die Formatierung werden kopiert.

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

Parameter

NameTypBeschreibung
destinationRangeZielbereich, in den kopiert werden soll. Nur die Position der Zelle oben links ist relevant.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

copyTo(destination, copyPasteType, transposed)

Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich.

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

Parameter

NameTypBeschreibung
destinationRangeZielbereich, in den kopiert werden soll. Nur die Position der Zelle oben links ist relevant.
copyPasteTypeCopyPasteTypeEin Typ, der angibt, wie die Bereichsinhalte in das Ziel eingefügt werden.
transposedBooleanLegt fest, ob der Bereich in transponierter Ausrichtung eingefügt werden soll.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

copyTo(destination, options)

Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich. Standardmäßig werden sowohl die Werte als auch die Formatierung kopiert. Dies kann jedoch mit erweiterten Argumenten überschrieben werden.

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

Parameter

NameTypBeschreibung
destinationRangeZielbereich, in den kopiert werden soll. Nur die Position der Zelle oben links ist relevant.
optionsObjectEin JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt.

Erweiterte Parameter

NameTypBeschreibung
formatOnlyBooleangibt an, dass nur das Format kopiert werden soll
contentsOnlyBooleangibt an, dass nur der Inhalt kopiert werden soll

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

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

Kopiert den Inhalt des Bereichs an den angegebenen Standort. Wenn das Ziel größer oder kleiner als der Quellbereich ist, wird die Quelle wiederholt oder entsprechend gekürzt.

Eine ausführliche Beschreibung des Parameters GridId finden Sie unter 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);

Parameter

NameTypBeschreibung
gridIdIntegerDie eindeutige ID des Tabellenblatts innerhalb der Tabelle, unabhängig von der Position.
columnIntegerDie erste Spalte des Zielbereichs.
columnEndIntegerDie Endspalte des Zielbereichs.
rowIntegerStartzeile des Zielbereichs.
rowEndIntegerDie Endzeile des Zielbereichs.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen


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

Kopiert den Inhalt des Bereichs an den angegebenen Standort. Wenn das Ziel größer oder kleiner als der Quellbereich ist, wird die Quelle wiederholt oder entsprechend gekürzt.

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);

Parameter

NameTypBeschreibung
sheetSheetDas Zielblatt.
columnIntegerDie erste Spalte des Zielbereichs.
columnEndIntegerDie Endspalte des Zielbereichs.
rowIntegerStartzeile des Zielbereichs.
rowEndIntegerDie Endzeile des Zielbereichs.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

createDataSourcePivotTable(dataSource)

Erstellt eine leere Datenquellen-Pivot-Tabelle aus der Datenquelle, die an der ersten Zelle in diesem Bereich verankert ist.

In diesem Beispiel wird gezeigt, wie Sie eine neue Pivot-Tabelle für Datenquellen erstellen und konfigurieren.

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

Parameter

NameTypBeschreibung
dataSourceDataSourceDie Datenquelle, aus der die Pivot-Tabelle erstellt werden soll.

Rückflug

DataSourcePivotTable: Die neu erstellte Pivot-Tabelle der Datenquelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

createDataSourceTable(dataSource)

Erstellt eine leere Datenquellentabelle aus der Datenquelle, die an der ersten Zelle in diesem Bereich verankert ist.

In diesem Beispiel wird gezeigt, wie Sie eine neue Datenquellentabelle erstellen und konfigurieren.

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);

Parameter

NameTypBeschreibung
dataSourceDataSourceDie Datenquelle, aus der die Pivot-Tabelle erstellt werden soll.

Rückflug

DataSourceTable: Die neu erstellte Datenquellentabelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

createDeveloperMetadataFinder()

Gibt eine DeveloperMetadataFinderApi zum Suchen von Entwicklermetadaten im Bereich dieses Bereichs zurück. Metadaten fallen nur dann in den Bereich des Bereichs, wenn sie vollständig in diesem Bereich enthalten sind. Beispielsweise liegen Metadaten, die mit der Zeile „3:3“ verknüpft sind, nicht im Bereich „A1:D5“, sondern im Bereich „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());

Rückflug

DeveloperMetadataFinder: Eine Suchfunktion für Entwickler-Metadaten zur Suche nach Metadaten in diesem Bereich.


createFilter()

Erstellt einen Filter und wendet ihn auf den angegebenen Bereich im Tabellenblatt an. Pro Tabelle kann nur ein Filter erstellt werden. Wenn Sie den Filter nach dem Erstellen aufrufen und ändern möchten, verwenden Sie getFilter() oder 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);
}
Mit dieser Methode können Sie Filter für Grid-Tabellenblätter, den Standard-Tabellenblatttyp, erstellen. Rasterblätter sind Tabellenblätter, die nicht mit einer Datenbank verbunden sind. Informationen zum Erstellen anderer Filtertypen finden Sie unter:

Rückflug

Filter: Der neue Filter.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

createPivotTable(sourceData)

Erstellt eine leere Pivot-Tabelle aus dem angegebenen sourceData und ist an der ersten Zelle in diesem Bereich verankert.

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

Parameter

NameTypBeschreibung
sourceDataRangeDie Daten, aus denen die Pivot-Tabelle erstellt werden soll.

Rückflug

PivotTable: Das neu erstellte PivotTable.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

createTextFinder(findText)

Erstellt eine Textsuche für den Bereich, mit der Text in diesem Bereich gesucht und ersetzt werden kann.

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');

Parameter

NameTypBeschreibung
findTextStringDer Text, nach dem gesucht werden soll.

Rückflug

TextFinder: TextFinder für den Bereich


deleteCells(shiftDimension)

Löscht diesen Zellenbereich Die vorhandenen Daten im Tabellenblatt werden entlang der angegebenen Dimension in den gelöschten Bereich verschoben.

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

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

Parameter

NameTypBeschreibung
shiftDimensionDimensionDie Dimension, in die vorhandene Daten verschoben werden sollen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

expandGroups()

Maximiert die minimierten Gruppen, deren Bereich oder Ein-/Aus-Schaltflächen sich mit diesem Bereich überschneiden. Die Position der Ein-/Aus-Schaltfläche ist der Index, an dem die Ein-/Aus-Schaltfläche angezeigt wird, je nach Einstellungen direkt vor oder nach der Gruppe. Wenn sich am selben Standort mehr als eine Gruppe befindet, wird die oberflächlichste Gruppe erweitert.

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

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getA1Notation()

Gibt eine Zeichenfolgenbeschreibung des Bereichs in A1-Notation zurück.

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

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

Rückflug

String: Die Stringbeschreibung des Bereichs in A1-Notation.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getBackground()

Gibt die Hintergrundfarbe der oberen linken Zelle im Bereich zurück (z. B. '#ffffff').

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

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

Rückflug

String: Der Farbcode des Hintergrunds.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getBackgroundObject()

Gibt die Hintergrundfarbe der oberen linken Zelle im Bereich zurück.

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

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

Rückflug

Color: Die Hintergrundfarbe der linken oberen Zelle im Bereich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getBackgroundObjects()

Gibt die Hintergrundfarben der Zellen im Bereich zurück.

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

Rückflug

Color[][]: Ein zweidimensionales Array von Hintergrundfarben.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getBackgrounds()

Gibt die Hintergrundfarben der Zellen im Bereich zurück (z. B. '#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]);
  }
}

Rückflug

String[][]: ein zweidimensionales Array von Farbcodes der Hintergründe.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getBandings()

Gibt alle Bandings zurück, die auf alle Zellen in diesem Bereich angewendet werden.

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

Rückflug

Banding[]: Alle Farbbänder, die auf die Zellen in diesem Bereich angewendet werden.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getCell(row, column)

Gibt eine bestimmte Zelle in einem Bereich zurück.

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

Parameter

NameTypBeschreibung
rowIntegerDie Zeile der Zelle im Verhältnis zum Bereich.
columnIntegerDie Spalte der Zelle im Verhältnis zum Bereich.

Rückflug

Range: Ein Bereich, der eine einzelne Zelle an den angegebenen Koordinaten enthält.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getColumn()

Gibt die Startposition der Spalte für diesen Bereich zurück.

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

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

Rückflug

Integer: Position der ersten Spalte des Bereichs in der Tabelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDataRegion()

Gibt eine Kopie des Bereichs zurück, der in den vier Kardinal-Directions maximiert wurde, um alle benachbarten Zellen mit Daten abzudecken. Wenn der Bereich von leeren Zellen umgeben ist, die nicht auf den Diagonalen liegen, wird der Bereich selbst zurückgegeben. Dies entspricht in etwa der Auswahl des Bereichs und der Eingabe von Ctrl+A in den 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());

Rückflug

Range: Der Datenbereich des Bereichs oder ein Bereich für die gesamte Tabelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDataRegion(dimension)

Gibt eine Kopie des erweiterten Bereichs Direction.UP und Direction.DOWN zurück, wenn die angegebene Dimension Dimension.ROWS ist, oder Direction.NEXT und Direction.PREVIOUS, wenn die Dimension Dimension.COLUMNS ist. Die Erweiterung des Bereichs basiert auf der Erkennung von Daten neben dem Bereich, der wie eine Tabelle organisiert ist. Der erweiterte Bereich umfasst alle angrenzenden Zellen mit Daten entlang der angegebenen Dimension einschließlich der Tabellengrenzen. Wenn der ursprüngliche Bereich entlang der angegebenen Dimension von leeren Zellen umgeben ist, wird der Bereich selbst zurückgegeben. Diese Methode ähnelt der Auswahl des Bereichs und der Eingabe von Ctrl+Space für Spalten oder Shift+Space für Zeilen im 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());

Parameter

NameTypBeschreibung
dimensionDimensionDie Dimension, um die der Bereich erweitert werden soll.

Rückflug

Range: Der Datenbereich des Bereichs oder ein Bereich, der alle Spalten oder Zeilen umfasst, die vom ursprünglichen Bereich abgedeckt sind.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDataSourceFormula()

Gibt DataSourceFormula für die erste Zelle im Bereich oder null zurück, wenn die Zelle keine Datenquellenformel enthält.

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

Rückflug

DataSourceFormula: Der DataSourceFormula für die Zelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDataSourceFormulas()

Gibt die DataSourceFormulas für die Zellen im Bereich zurück.

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

Rückflug

DataSourceFormula[]: Ein Array von DataSourceFormula-Werten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDataSourcePivotTables()

Ruft alle Pivot-Tabellen der Datenquelle ab, die sich mit dem Bereich überschneiden.

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

Rückflug

DataSourcePivotTable[]: Eine Liste der Pivot-Tabellen der Datenquelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDataSourceTables()

Ruft alle Datenquellentabellen ab, die sich mit dem Bereich überschneiden.

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

Rückflug

DataSourceTable[]: Eine Liste mit Datenquellentabellen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDataSourceUrl()

Gibt eine URL für die Daten in diesem Bereich zurück, die zum Erstellen von Diagrammen und Abfragen verwendet werden kann.

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

Kreisdiagramm.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>

Rückflug

String: Eine URL für diesen Bereich als Datenquelle, die an andere APIs wie Diagramme übergeben werden kann.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDataTable()

Gibt die Daten in diesem Objekt als DataTable zurück.

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

Rückflug

DataTable: die Daten als Datentabelle.


getDataTable(firstRowIsHeader)

Gibt die Daten in diesem Bereich als DataTable zurück.

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

Parameter

NameTypBeschreibung
firstRowIsHeaderBooleanGibt an, ob die erste Zeile als Überschrift behandelt werden soll.

Rückflug

DataTable: Die Daten als Datentabelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDataValidation()

Gibt die Datenvalidierungsregel für die linke obere Zelle im Bereich zurück. Wenn für die Zelle keine Datenvalidierung festgelegt wurde, gibt diese Methode null zurück.

// 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.')
}

Rückflug

DataValidation: Die Datenvalidierungsregel für die linke obere Zelle im Bereich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDataValidations()

Gibt die Datenvalidierungsregeln für alle Zellen im Bereich zurück. Wenn für eine bestimmte Zelle keine Datenvalidierung festgelegt wurde, gibt diese Methode null für die Position dieser Zelle im Array zurück.

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

Rückflug

DataValidation[][]: ein zweidimensionales Array von Datenvalidierungsregeln, die den Zellen im Bereich zugeordnet sind.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDeveloperMetadata()

Ruft die mit diesem Bereich verknüpften Entwicklermetadaten ab

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

Rückflug

DeveloperMetadata[]: Die mit diesem Bereich verknüpften Entwicklermetadaten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDisplayValue()

Gibt den angezeigten Wert der linken oberen Zelle im Bereich zurück Der Wert ist ein String. Der angezeigte Wert berücksichtigt die Formatierung von Datum, Uhrzeit und Währung, einschließlich der Formate, die durch die Spracheinstellung der Tabelle automatisch angewendet werden. Bei leeren Zellen wird eine leere Zeichenfolge zurückgegeben.

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

Rückflug

String: Der in dieser Zelle angezeigte Wert.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getDisplayValues()

Gibt das rechteckige Werteraster für diesen Bereich zurück.

Gibt ein zweidimensionales Array aus angezeigten Werten zurück, indiziert nach Zeile und dann nach Spalte. Die Werte sind String-Objekte. Der angezeigte Wert berücksichtigt die Formatierung von Datum, Uhrzeit und Währung, einschließlich der Formate, die vom Gebietsschema der Tabelle automatisch angewendet werden. Leere Zellen werden im Array durch eine leere Zeichenfolge dargestellt. Während ein Bereichsindex bei 1, 1 beginnt, wird das JavaScript-Array ab [0][0] indexiert.

// 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]);

Rückflug

String[][]: Ein zweidimensionales Array von Werten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFilter()

Gibt den Filter für das Tabellenblatt zurück, zu dem dieser Bereich gehört, oder null, wenn im Tabellenblatt kein Filter vorhanden ist

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

Rückflug

Filter: Der Filter.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFontColorObject()

Gibt die Schriftfarbe der Zelle in der oberen linken Ecke des Bereichs zurück.

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

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

Rückflug

Color: Die Schriftfarbe der linken oberen Zelle im Bereich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFontColorObjects()

Gibt die Schriftfarben der Zellen im Bereich zurück.

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

Rückflug

Color[][]: ein zweidimensionales Array von Schriftfarben, die den Zellen im Bereich zugeordnet sind.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFontFamilies()

Gibt die Schriftfamilien der Zellen im Bereich zurück.

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]);
  }
}

Rückflug

String[][]: Ein zweidimensionales Array von Schriftfamilien, die mit Zellen im Bereich verknüpft sind.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFontFamily()

Gibt die Schriftfamilie der Zelle in der oberen linken Ecke des Bereichs zurück.

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

Logger.log(range.getFontFamily());

Rückflug

String: Die Schriftfamilie der Zelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFontLine()

Ruft den Linienstil der Zelle in der oberen linken Ecke des Bereichs ab ('underline', 'line-through' oder 'none').

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

Logger.log(range.getFontLine());

Rückflug

String: Die Schriftzeile.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFontLines()

Ruft den Linienstil der Zellen im Bereich ab ('underline', 'line-through' oder '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]);
  }
}

Rückflug

String[][]: ein zweidimensionales Array von Schriftzeilen, die mit Zellen im Bereich verknüpft sind.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFontSize()

Gibt die Schriftgröße der Zelle in der oberen linken Ecke des Bereichs als Punktgröße zurück.

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

Logger.log(range.getFontSize());

Rückflug

Integer: Die Schriftgröße in Punktgröße.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFontSizes()

Gibt die Schriftgrößen der Zellen im Bereich zurück.

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]);
  }
}

Rückflug

Integer[][]: ein zweidimensionales Array mit Schriftgrößen von Text, der mit Zellen im Bereich verknüpft ist.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFontStyle()

Gibt den Schriftstil ('italic' oder 'normal') der Zelle in der oberen linken Ecke des Bereichs zurück.

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

Logger.log(range.getFontStyle());

Rückflug

String: Der Schriftstil des Textes in der Zelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFontStyles()

Gibt die Schriftstile der Zellen im Bereich zurück

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]);
  }
}

Rückflug

String[][]: ein zweidimensionales Array von Textschriftarten, die mit Zellen im Bereich verknüpft sind.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFontWeight()

Gibt die Schriftstärke (normal/fett) der Zelle in der oberen linken Ecke des Bereichs zurück.

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

Logger.log(range.getFontWeight());

Rückflug

String: Die Schriftstärke des Textes in der Zelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFontWeights()

Gibt die Schriftstärken der Zellen im Bereich zurück.

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]);
  }
}

Rückflug

String[][]: ein zweidimensionales Array mit Schriftstärken von Text, der mit Zellen im Bereich verknüpft ist.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFormula()

Gibt die Formel (A1-Notation) für die linke obere Zelle des Bereichs oder einen leeren String zurück, wenn die Zelle leer ist oder keine Formel enthält.

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

Rückflug

String: Die Formel für die Zelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFormulaR1C1()

Gibt die Formel (R1C1-Notation) für eine bestimmte Zelle zurück oder null, wenn keine Zelle ausgegeben wird.

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

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

Rückflug

String: Die Formel in R1C1-Notation.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFormulas()

Gibt die Formeln (A1-Notation) für die Zellen im Bereich zurück. Einträge im 2D-Array sind leere Zeichenfolgen für Zellen ohne Formel.

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]);
  }
}

Rückflug

String[][]: Ein zweidimensionales Array von Formeln im Stringformat.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getFormulasR1C1()

Gibt die Formeln (R1C1-Notation) für die Zellen im Bereich zurück. Einträge im 2D-Array sind null für Zellen ohne Formel.

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]);
  }
}

Rückflug

String[][]: Ein zweidimensionales Array von Formeln in R1C1-Notation.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getGridId()

Gibt die Raster-ID des übergeordneten Tabellenblatts des Bereichs zurück IDs sind zufällige, nicht negative Ganzzahlwerte.

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

Rückflug

Integer: Die Raster-ID des übergeordneten Tabellenblatts.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getHeight()

Gibt die Höhe des Bereichs zurück

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

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

Rückflug

Integer: Die Höhe des Bereichs.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getHorizontalAlignment()

Gibt die horizontale Ausrichtung des Texts (links/zentriert/rechts) der Zelle in der oberen linken Ecke des Bereichs zurück.

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

Logger.log(range.getHorizontalAlignment());

Rückflug

String: Horizontale Ausrichtung des Texts in der Zelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getHorizontalAlignments()

Gibt die horizontalen Ausrichtungen der Zellen im Bereich zurück.

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]);
  }
}

Rückflug

String[][]: ein zweidimensionales Array horizontaler Textausrichtungen, die mit Zellen im Bereich verknüpft sind.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getLastColumn()

Gibt die Position der Endspalte zurück.

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

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

Rückflug

Integer: Position der letzten Spalte des Bereichs in der Tabelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getLastRow()

Gibt die Position der Endzeile zurück

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

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

Rückflug

Integer: Position der letzten Zeile des Bereichs in der Tabelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getMergedRanges()

Gibt ein Array von Range-Objekten zurück, die zusammengeführte Zellen darstellen, die entweder vollständig im aktuellen Bereich liegen oder mindestens eine Zelle im aktuellen Bereich enthalten.

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

Rückflug

Range[]: Ein Array von Range-Objekten, die zusammengeführte Zellen darstellen, die den Bereich überlappen.


getNextDataCell(direction)

Ausgehend von der Zelle in der ersten Spalte und Zeile des Bereichs wird die nächste Zelle in der angegebenen Richtung zurückgegeben, also der Rand eines zusammenhängenden Zellenbereichs mit Daten in ihnen oder der Zelle am Rand der Tabelle in dieser Richtung. Dies entspricht der Eingabe von Ctrl+[arrow key] im 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());

Parameter

NameTypBeschreibung
directionDirectionDie Richtung, in die die nächste Randzelle des Datenbereichs gesucht werden soll.

Rückflug

Range: Die Zelle am Rand der Tabelle oder des Datenbereichs.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getNote()

Gibt den Hinweis zurück, der dem angegebenen Bereich zugeordnet ist.

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

Logger.log(range.getNote());

Rückflug

String: Der Hinweis auf die angegebene Zelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getNotes()

Gibt die mit den Zellen im Bereich verknüpften Notizen zurück.

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]);
  }
}

Rückflug

String[][]: ein zweidimensionales Array von Notizen, die mit Zellen im Bereich verknüpft sind.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getNumColumns()

Gibt die Anzahl der Spalten in diesem Bereich zurück.

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

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

Rückflug

Integer: Anzahl der Spalten in diesem Bereich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getNumRows()

Gibt die Anzahl der Zeilen in diesem Bereich zurück.

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

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

Rückflug

Integer: Anzahl der Zeilen in diesem Bereich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getNumberFormat()

Ruft die Zahlen- oder Datumsformatierung der oberen linken Zelle des angegebenen Bereichs ab. Die zurückgegebenen Formatmuster werden in der Dokumentation zur Google Tabellen API beschrieben.

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

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

Rückflug

String: Zahlenformat der linken oberen Zelle des Bereichs.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getNumberFormats()

Gibt das Zahlen- oder Datumsformat für die Zellen im Bereich zurück. Die zurückgegebenen Formatmuster sind in der Dokumentation zur Google Sheets API beschrieben.

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]);
  }
}

Rückflug

String[][]: Ein zweidimensionales Array von Zahlenformaten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getRichTextValue()

Gibt den Rich-Text-Wert für die linke obere Zelle des Bereichs oder null zurück, wenn der Zellenwert kein Text ist.

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

Rückflug

RichTextValue: Der Rich-Text-Wert der oberen linken Zelle im Bereich oder null, wenn der Zellenwert kein Text ist.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getRichTextValues()

Gibt die Rich-Text-Werte für die Zellen im Bereich zurück.

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

Rückflug

RichTextValue[][]: ein zweidimensionales Array von Rich-Text-Werten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getRow()

Gibt die Zeilenposition für diesen Bereich zurück. Identisch mit getRowIndex().

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

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

Rückflug

Integer: Die Zeilenposition des Bereichs.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getRowIndex()

Gibt die Zeilenposition für diesen Bereich zurück. Identisch mit getRow().

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

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

Rückflug

Integer: Die Zeilenposition des Bereichs.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen


getSheet()

Gibt das Tabellenblatt zurück, zu dem dieser Bereich gehört

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

Rückflug

Sheet: Das Tabellenblatt, zu dem dieser Bereich gehört.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getTextDirection()

Gibt die Textrichtung für die obere linke Zelle des Bereichs zurück. Gibt null zurück, wenn die Textrichtung der Zelle automatisch erkannt wird.

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

Rückflug

TextDirection: Textrichtung der oberen linken Zelle im Bereich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getTextDirections()

Gibt die Textrichtungen für die Zellen im Bereich zurück. Einträge im 2D-Array sind null für Zellen, die automatisch erkannt werden.

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

Rückflug

TextDirection[][]: Ein zweidimensionales Array von Textrichtungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getTextRotation()

Gibt die Einstellungen für die Textdrehung für die linke obere Zelle des Bereichs zurück

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

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

Rückflug

TextRotation: Die Einstellungen für die Textrotation.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getTextRotations()

Gibt die Textrotationseinstellungen für die Zellen im Bereich zurück.

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

Rückflug

TextRotation[][]: ein zweidimensionales Array von Textrotationen, die mit Zellen im Bereich verknüpft sind.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getTextStyle()

Gibt den Textstil für die linke obere Zelle des Bereichs zurück

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

Rückflug

TextStyle: Textstil der oberen linken Zelle im Bereich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getTextStyles()

Gibt die Textstile für die Zellen im Bereich zurück.

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

Rückflug

TextStyle[][]: Ein zweidimensionales Array von Textstilen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getValue()

Gibt den Wert der oberen linken Zelle im Bereich zurück. Der Wert kann je nach Wert der Zelle vom Typ Number, Boolean, Date oder String sein. Bei leeren Zellen wird ein leerer String zurückgegeben.

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

Rückflug

Object: Der Wert in dieser Zelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getValues()

Gibt das rechteckige Werteraster für diesen Bereich zurück.

Gibt ein zweidimensionales Array von Werten zurück, die nach Zeile und dann nach Spalte indiziert sind. Die Werte können je nach Wert der Zelle vom Typ Number, Boolean, Date oder String sein. Leere Zellen werden im Array durch eine leere Zeichenfolge dargestellt. Während ein Bereichsindex bei 1, 1 beginnt, wird das JavaScript-Array ab [0][0] indexiert.

// 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]);
In Webanwendungen ist ein Date-Wert kein zulässiger Parameter. getValues() gibt keine Daten an eine Webanwendung zurück, wenn der Bereich eine Zelle mit einem Date-Wert enthält. Transformieren Sie stattdessen alle aus dem Tabellenblatt abgerufenen Werte in eine unterstützte JavaScript-Primitive wie Number, Boolean oder String.

Rückflug

Object[][]: Ein zweidimensionales Array von Werten.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getVerticalAlignment()

Gibt die vertikale Ausrichtung (oben/Mitte/unten) der Zelle in der oberen linken Ecke des Bereichs zurück.

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

Logger.log(range.getVerticalAlignment());

Rückflug

String: Vertikale Ausrichtung des Texts in der Zelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getVerticalAlignments()

Gibt die vertikalen Ausrichtung der Zellen im Bereich zurück.

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]);
  }
}

Rückflug

String[][]: ein zweidimensionales Array mit vertikalen Textausrichtungen, die mit Zellen im Bereich verknüpft sind.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getWidth()

Gibt die Breite des Bereichs in Spalten zurück.

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

Rückflug

Integer: Anzahl der Spalten im Bereich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getWrap()

Gibt zurück, ob der Text in der Zelle umgebrochen wird. Verwenden Sie getWrapStrategy(), um eine detailliertere Strategie für die Zusammenfassung zu erhalten.

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

Logger.log(range.getWrap());

Rückflug

Boolean: Gibt an, ob der Text in dieser Zelle umgebrochen wird oder nicht.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getWrapStrategies()

Gibt die Strategien für den Textumbruch für die Zellen im Bereich zurück.

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

Rückflug

WrapStrategy[][]: ein zweidimensionales Array von Textumbruchstrategien.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getWrapStrategy()

Gibt die Textumbruchstrategie für die obere linke Zelle des Bereichs zurück.

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

Rückflug

WrapStrategy: Die Textumbruchstrategie der oberen linken Zelle im Bereich.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getWraps()

Gibt zurück, ob der Text in den Zellen umgebrochen wird. Verwenden Sie getWrapStrategies(), um eine detailliertere Strategie für die Zusammenfassung zu erhalten.

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

Rückflug

Boolean[][]: ein zweidimensionales Array mit vertikalen Textausrichtungen, die mit Zellen im Bereich verknüpft sind.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

insertCells(shiftDimension)

Fügt leere Zellen in diesen Bereich ein. Die Formatierung der Zellen, die zuvor diesen Bereich eingenommen haben, wird in den neuen Zellen beibehalten. Vorhandene Daten im Tabellenblatt werden entlang der angegebenen Dimension aus dem eingefügten Bereich weg verschoben.

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

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

Parameter

NameTypBeschreibung
shiftDimensionDimensionDie Dimension, in die vorhandene Daten verschoben werden sollen.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

insertCheckboxes()

Fügt in jede Zelle des Bereichs ein Kästchen ein, das mit true (aktiviert) und false (deaktiviert) konfiguriert ist. Legt den Wert aller Zellen im Bereich auf false fest.

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

insertCheckboxes(checkedValue)

Fügt in jede Zelle des Bereichs Kästchen ein, die mit einem benutzerdefinierten Wert für aktiviert und dem leeren String für deaktivierte Zellen konfiguriert ist. Legt den Wert jeder Zelle im Bereich auf einen leeren String fest.

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');

Parameter

NameTypBeschreibung
checkedValueObjectDer aktivierte Wert für die Kästchendatenvalidierung.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

insertCheckboxes(checkedValue, uncheckedValue)

Fügt in jede Zelle des Bereichs Kästchen ein, die mit benutzerdefinierten Werten für den aktivierten und deaktivierten Status konfiguriert sind. Legt den Wert jeder Zelle im Bereich auf den benutzerdefinierten, ungeprüften Wert fest.

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');

Parameter

NameTypBeschreibung
checkedValueObjectDer aktivierte Wert für die Kästchendatenvalidierung.
uncheckedValueObjectDer deaktivierte Wert für die Kästchendatenvalidierung.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

isBlank()

Gibt true zurück, wenn der Bereich vollständig leer ist.

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

Logger.log(range.isBlank());

Rückflug

Boolean: true, wenn der Bereich leer ist; andernfalls false.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

isChecked()

Gibt zurück, ob das Kästchen für alle Zellen im Bereich „aktiviert“ ist. Gibt null zurück, wenn einige Zellen aktiviert und die übrigen Zellen nicht markiert sind oder wenn einige Zellen keine Kästchen-Datenvalidierung haben.

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

Rückflug

Boolean: true, wenn alle Zellen im Bereich aktiviert sind, false, wenn alle Zellen im Bereich deaktiviert sind, oder null, wenn eine Zelle deaktiviert ist oder keine Kästchendatenvalidierung hat.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

isEndColumnBounded()

Bestimmt, ob das Ende des Bereichs an eine bestimmte Spalte gebunden ist. Für die Bereiche A1:B10 oder B:B, die an Spalten am Ende des Bereichs gebunden sind, gibt diese Methode beispielsweise true zurück. Für die Bereiche 3:7 oder A1:5, die nur an bestimmte Zeilen am Ende des Bereichs gebunden sind, gibt diese Methode false zurück.

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

Rückflug

Boolean: true, wenn das Ende des Bereichs an eine bestimmte Spalte gebunden ist; andernfalls false.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

isEndRowBounded()

Bestimmt, ob das Ende des Bereichs an eine bestimmte Zeile gebunden ist. Für die Bereiche A1:B10 oder 3:7, die an Zeilen am Ende des Bereichs gebunden sind, gibt diese Methode beispielsweise true zurück. Für die Bereiche B:B oder A1:C, die nur an bestimmte Spalten am Ende des Bereichs gebunden sind, gibt diese Methode false zurück.

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

Rückflug

Boolean: true, wenn das Ende des Bereichs an eine bestimmte Zeile gebunden ist; andernfalls false.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

isPartOfMerge()

Gibt true zurück, wenn sich die Zellen im aktuellen Bereich mit verbundenen Zellen überschneiden.

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

Rückflug

Booleantrue, wenn sich der Bereich mit verbundenen Zellen überschneidet. Andernfalls wird false zurückgegeben.


isStartColumnBounded()

Bestimmt, ob der Anfang des Bereichs an eine bestimmte Spalte gebunden ist. Für die Bereiche A1:B10 oder B:B, die an Spalten am Anfang des Bereichs gebunden sind, gibt diese Methode beispielsweise true zurück. Für den Bereich 3:7, der nur an eine Zeile am Anfang des Bereichs gebunden ist, gibt diese Methode false zurück.

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

Rückflug

Boolean: true, wenn der Anfang des Bereichs an eine bestimmte Spalte gebunden ist; andernfalls false.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

isStartRowBounded()

Bestimmt, ob der Anfang des Bereichs an eine bestimmte Zeile gebunden ist. Für die Bereiche A1:B10 oder 3:7, die an Zeilen am Anfang des Bereichs gebunden sind, gibt diese Methode beispielsweise true zurück. Für den Bereich B:B, der nur an eine bestimmte Spalte am Anfang des Bereichs gebunden ist, gibt diese Methode false zurück.

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

Rückflug

Boolean: true, wenn der Anfang des Bereichs an eine bestimmte Zeile gebunden ist; andernfalls false.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

merge()

Führt die Zellen in dem Bereich zu einem einzelnen Block zusammen.

var sheet = SpreadsheetApp.getActiveSheet();

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

mergeAcross()

Führen Sie die Zellen in dem Bereich über die Spalten des Bereichs hinweg zusammen.

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

mergeVertically()

Führt die Zellen im Bereich zusammen.

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

moveTo(target)

Ausschneiden und Einfügen (sowohl Format als auch Werte) aus diesem Bereich in den Zielbereich.

// 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"));

Parameter

NameTypBeschreibung
targetRangeEin Zielbereich, in den dieser Bereich kopiert werden soll. Nur die Position der Zelle oben links ist relevant.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

offset(rowOffset, columnOffset)

Gibt einen neuen Bereich zurück, der um die angegebene Anzahl von Zeilen und Spalten (die negativ sein kann) von diesem Bereich entfernt sind. Der neue Bereich hat dieselbe Größe wie der ursprüngliche Bereich.

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

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

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

Parameter

NameTypBeschreibung
rowOffsetIntegerDie Anzahl der Zeilen ab der linken oberen Zelle des Bereichs. Negative Werte stehen für die Zeilen oberhalb der Zelle links oben im Bereich.
columnOffsetIntegerDie Anzahl der Spalten rechts von der linken oberen Zelle des Bereichs. Negative Werte stehen für Spalten links von der Zelle links oben im Bereich.

Rückflug

Range: Dieser Bereich für Verkettungen.


offset(rowOffset, columnOffset, numRows)

Gibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist, dessen oberer linker Punkt vom aktuellen Bereich um die angegebenen Zeilen und Spalten versetzt ist und mit der angegebenen Höhe in Zellen.

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);

Parameter

NameTypBeschreibung
rowOffsetIntegerDie Anzahl der Zeilen ab der linken oberen Zelle des Bereichs. Negative Werte stehen für die Zeilen oberhalb der Zelle links oben im Bereich.
columnOffsetIntegerDie Anzahl der Spalten rechts von der linken oberen Zelle des Bereichs. Negative Werte stehen für Spalten links von der Zelle links oben im Bereich.
numRowsIntegerDie Zeilenhöhe des neuen Bereichs.

Rückflug

Range: Dieser Bereich für Verkettungen.


offset(rowOffset, columnOffset, numRows, numColumns)

Gibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist, dessen oberer linker Punkt vom aktuellen Bereich um die angegebenen Zeilen und Spalten versetzt ist und mit der angegebenen Höhe und Breite in den Zellen.

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);

Parameter

NameTypBeschreibung
rowOffsetIntegerDie Anzahl der Zeilen ab der linken oberen Zelle des Bereichs. Negative Werte stehen für die Zeilen oberhalb der Zelle links oben im Bereich.
columnOffsetIntegerDie Anzahl der Spalten rechts von der linken oberen Zelle des Bereichs. Negative Werte stehen für Spalten links von der Zelle links oben im Bereich.
numRowsIntegerDie Zeilenhöhe des neuen Bereichs.
numColumnsIntegerSpaltenbreite des neuen Bereichs.

Rückflug

Range: Dieser Bereich für Verkettungen.


protect()

Erstellt ein Objekt, das verhindern kann, dass der Bereich bearbeitet wird, außer von Nutzern mit entsprechender Berechtigung. Bis das Skript die Liste der Bearbeiter für den Bereich ändert (durch Aufrufen von Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) oder Festlegen eines neuen Werts für Protection.setDomainEdit(editable)), entsprechen die Berechtigungen denen der Tabelle selbst. Das bedeutet, dass der Bereich ungeschützt bleibt. Wenn der Bereich bereits geschützt ist, erstellt diese Methode einen neuen geschützten Bereich, der sich mit dem vorhandenen überschneidet. Wenn eine Zelle durch mehrere geschützte Bereiche geschützt ist und einer davon verhindert, dass ein bestimmter Nutzer die Zelle bearbeitet, darf dieser Nutzer die Zelle nicht bearbeiten.

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

Rückflug

Protection: Ein Objekt, das die Schutzeinstellungen darstellt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

randomize()

Ordnet die Reihenfolge der Zeilen im angegebenen Bereich zufällig an.

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

// Randomizes the range
range.randomize();

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

removeCheckboxes()

Entfernt alle Kästchen aus dem Bereich. Löscht die Datenvalidierung jeder Zelle und löscht zusätzlich den Wert, wenn die Zelle den aktivierten oder deaktivierten Wert enthält.

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

removeDuplicates()

Entfernt Zeilen in diesem Bereich, die Werte enthalten, die Duplikate von Werten in einer vorherigen Zeile sind. Zeilen mit identischen Werten, aber unterschiedlichen Schreibweisen, Formatierungen oder Formeln gelten als Duplikate. Mit dieser Methode werden auch doppelte Zeilen entfernt, die nicht sichtbar sind (z. B. aufgrund eines Filters). Inhalte außerhalb dieses Bereichs werden nicht entfernt.

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

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

Rückflug

Range: Der Ergebnisbereich nach dem Entfernen von Duplikaten. Die Größe des Bereichs wird für jede entfernte Zeile um eine Zeile reduziert.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

removeDuplicates(columnsToCompare)

Entfernt Zeilen in diesem Bereich, die Werte in den angegebenen Spalten enthalten, die Duplikate von Werten aus einer vorherigen Zeile sind. Zeilen mit identischen Werten, aber unterschiedlichen Schreibweisen, Formatierungen oder Formeln werden als Duplikate betrachtet. Mit dieser Methode werden auch doppelte Zeilen entfernt, die aus der Ansicht ausgeblendet sind (z. B. aufgrund eines Filters). Inhalte außerhalb dieses Bereichs werden nicht entfernt.

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]);

Parameter

NameTypBeschreibung
columnsToCompareInteger[]Die Spalten, die auf doppelte Werte analysiert werden sollen. Wenn keine Spalten angegeben sind, werden alle Spalten auf Duplikate analysiert.

Rückflug

Range: Der Ergebnisbereich nach dem Entfernen von Duplikaten. Die Größe des Bereichs wird für jede entfernte Zeile um eine Zeile reduziert.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setBackground(color)

Legt die Hintergrundfarbe aller Zellen im Bereich in CSS-Notation fest (z. B. '#ffffff' oder 'white').

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

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

Parameter

NameTypBeschreibung
colorStringEin Farbcode in CSS-Notation (z. B. '#ffffff' oder 'white'); ein null-Wert setzt die Farbe zurück.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setBackgroundObject(color)

Legt die Hintergrundfarbe aller Zellen im Bereich fest.

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);

Parameter

NameTypBeschreibung
colorColorDie festzulegende Hintergrundfarbe. Mit dem Wert null wird die Hintergrundfarbe zurückgesetzt.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setBackgroundObjects(color)

Legt ein rechteckiges Raster mit Hintergrundfarben fest (muss den Abmessungen dieses Bereichs entsprechen).

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);

Parameter

NameTypBeschreibung
colorColor[][]Ein zweidimensionales Farbarray; null-Werte setzen die Farbe zurück.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setBackgroundRGB(red, green, blue)

Legt den Hintergrund mithilfe von RGB-Werten (Ganzzahlen zwischen 0 und 255 einschließlich) auf die angegebene Farbe fest.

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);

Parameter

NameTypBeschreibung
redIntegerRoter Wert in RGB-Notation.
greenIntegerDer grüne Wert in RGB-Notation.
blueIntegerDer blaue Wert in RGB-Notation.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setBackgrounds(color)

Legt ein rechteckiges Raster mit Hintergrundfarben fest (muss den Abmessungen dieses Bereichs entsprechen). Die Farben werden in CSS-Notation wie '#ffffff' oder 'white' angegeben.

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);

Parameter

NameTypBeschreibung
colorString[][]Ein zweidimensionales Farbarray in CSS-Notation (z. B. '#ffffff' oder 'white'); null-Werte setzen die Farbe zurück.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

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

Legt die Eigenschaft Rahmen fest. Gültige Werte sind true (aktiviert), false (aus) und null (keine Änderung).

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);

Parameter

NameTypBeschreibung
topBooleantrue für Rahmen, false für keine, null für keine Änderung.
leftBooleantrue für Rahmen, false für keine, null für keine Änderung.
bottomBooleantrue für Rahmen, false für keine, null für keine Änderung.
rightBooleantrue für Rahmen, false für keine, null für keine Änderung.
verticalBooleantrue für vertikale Rahmenlinien, false für keine, null für keine Änderung.
horizontalBooleantrue für horizontale Rahmenlinien, false für keine, null für keine Änderung.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

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

Legt die Rahmeneigenschaft mit Farbe und/oder Stil fest. Gültige Werte sind true (aktiviert), false (aus) und null (keine Änderung). Verwenden Sie für Farbe die Farbe in der CSS-Notation (z. B. '#ffffff' oder '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);

Parameter

NameTypBeschreibung
topBooleantrue für Rahmen, false für keine, null für keine Änderung.
leftBooleantrue für Rahmen, false für keine, null für keine Änderung.
bottomBooleantrue für Rahmen, false für keine, null für keine Änderung.
rightBooleantrue für Rahmen, false für keine, null für keine Änderung.
verticalBooleantrue für vertikale Rahmenlinien, false für keine, null für keine Änderung.
horizontalBooleantrue für horizontale Rahmenlinien, false für keine, null für keine Änderung.
colorStringEine Farbe in CSS-Notation (z. B. '#ffffff' oder 'white') oder null für die Standardfarbe (Schwarz).
styleBorderStyleEin Stil für die Rahmen, null für den Standardstil (durchgehend).

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setDataValidation(rule)

Legt eine Datenvalidierungsregel für alle Zellen im Bereich fest.

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

Parameter

NameTypBeschreibung
ruleDataValidationDie festzulegende Datenvalidierungsregel oder null zum Entfernen der Datenvalidierung.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setDataValidations(rules)

Legt die Datenvalidierungsregeln für alle Zellen im Bereich fest. Bei dieser Methode wird ein zweidimensionales Array von Datenvalidierungen verwendet, das nach Zeile und dann nach Spalte indexiert wird. Die Array-Abmessungen müssen den Bereichsdimensionen entsprechen.

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

Parameter

NameTypBeschreibung
rulesDataValidation[][]Ein zweidimensionales Array mit festzulegenden Datenvalidierungsregeln; null-Werte entfernen die Datenvalidierung.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontColor(color)

Legt die Schriftfarbe in CSS-Notation (z. B. '#ffffff' oder 'white') fest.

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

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

Parameter

NameTypBeschreibung
colorStringDie Schriftfarbe in CSS-Notation (z. B. '#ffffff' oder 'white'); ein null-Wert setzt die Farbe zurück.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontColorObject(color)

Legt die Schriftfarbe des angegebenen Bereichs fest.

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);

Parameter

NameTypBeschreibung
colorColorDie festzulegende Schriftfarbe. Mit dem Wert null wird die Farbe zurückgesetzt.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontColorObjects(colors)

Legt ein rechteckiges Raster mit Schriftfarben fest (muss den Abmessungen dieses Bereichs entsprechen).

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);

Parameter

NameTypBeschreibung
colorsColor[][]Ein zweidimensionales Farbarray; die Schriftfarbe wird durch null-Werte zurückgesetzt.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontColors(colors)

Legt ein rechteckiges Raster mit Schriftfarben fest (muss den Abmessungen dieses Bereichs entsprechen). Die Farben sind in CSS-Notation (z. B. '#ffffff' oder '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);

Parameter

NameTypBeschreibung
colorsObject[][]Ein zweidimensionales Farbarray in CSS-Notation (z. B. '#ffffff' oder 'white'); null-Werte setzen die Farbe zurück.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontFamilies(fontFamilies)

Legt ein rechteckiges Raster von Schriftfamilien fest (muss den Abmessungen dieses Bereichs entsprechen). Beispiele für Schriftfamilien sind "Arial" oder "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);

Parameter

NameTypBeschreibung
fontFamiliesObject[][]Ein zweidimensionales Array von Schriftfamilien; null-Werte setzen die Schriftfamilie zurück.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontFamily(fontFamily)

Legt die Schriftfamilie fest, z. B. "Arial" oder "Helvetica"

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

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

Parameter

NameTypBeschreibung
fontFamilyStringDie festzulegende Schriftfamilie. Mit dem Wert null wird die Schriftfamilie zurückgesetzt.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontLine(fontLine)

Legt den Schriftlinienstil des angegebenen Bereichs fest ('underline', 'line-through' oder 'none').

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

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

Parameter

NameTypBeschreibung
fontLineStringDer Linienstil für die Schrift, entweder 'underline', 'line-through' oder 'none'. Durch den Wert null wird der Zeilenstil der Schrift zurückgesetzt.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontLines(fontLines)

Legt ein rechteckiges Raster von Linienstilen fest (muss den Abmessungen dieses Bereichs entsprechen).

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);

Parameter

NameTypBeschreibung
fontLinesObject[][]Ein zweidimensionales Array von Schriftlinienstilen ('underline', 'line-through' oder 'none'); bei null-Werten wird der Linienstil zurückgesetzt.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontSize(size)

Legt die Schriftgröße fest, wobei die Größe die zu verwendende Punktgröße ist.

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

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

Parameter

NameTypBeschreibung
sizeIntegerEine Schriftgröße in Punktgröße.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontSizes(sizes)

Legt ein rechteckiges Raster mit Schriftgrößen fest (muss den Abmessungen dieses Bereichs entsprechen). Die Größen sind in Punkten.

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);

Parameter

NameTypBeschreibung
sizesObject[][]Ein zweidimensionales Array von Größen.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontStyle(fontStyle)

Legen Sie den Schriftstil für den angegebenen Bereich fest ('italic' oder 'normal').

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

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

Parameter

NameTypBeschreibung
fontStyleStringDer Schriftstil, entweder 'italic' oder 'normal'. Der Wert null setzt die Schriftart zurück.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontStyles(fontStyles)

Legt ein rechteckiges Raster mit Schriftstilen fest (muss den Abmessungen dieses Bereichs entsprechen).

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);

Parameter

NameTypBeschreibung
fontStylesObject[][]Ein zweidimensionales Array mit Schriftstilen, entweder 'italic' oder 'normal'. Der Schriftstil wird mit null-Werten zurückgesetzt.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontWeight(fontWeight)

Legt die Schriftstärke für den angegebenen Bereich fest (normal/fett).

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

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

Parameter

NameTypBeschreibung
fontWeightStringDie Schriftstärke, entweder 'bold' oder 'normal'. Der Wert null setzt die Schriftstärke zurück.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFontWeights(fontWeights)

Legt ein rechteckiges Raster mit Schriftstärken fest (muss den Abmessungen dieses Bereichs entsprechen). Ein Beispiel für eine Schriftstärke ist „fett“.

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);

Parameter

NameTypBeschreibung
fontWeightsObject[][]Ein zweidimensionales Array mit Schriftstärken, entweder 'bold' oder 'normal'. Bei null-Werten wird die Schriftstärke zurückgesetzt.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFormula(formula)

Aktualisiert die Formel für diesen Bereich. Die angegebene Formel muss in A1-Notation angegeben werden.

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

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

Parameter

NameTypBeschreibung
formulaStringString, der die für die Zelle festzulegende Formel darstellt

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFormulaR1C1(formula)

Aktualisiert die Formel für diesen Bereich. Die angegebene Formel muss in R1C1-Notation vorliegen.

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])");

Parameter

NameTypBeschreibung
formulaStringEine Zeichenfolgenformel.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFormulas(formulas)

Legt ein rechteckiges Raster aus Formeln fest (muss den Abmessungen dieses Bereichs entsprechen). Die angegebenen Formeln müssen in A1-Notation angegeben werden. Diese Methode verwendet ein zweidimensionales Array von Formeln, das nach Zeile und dann nach Spalte indexiert wird. Die Array-Abmessungen müssen den Bereichsdimensionen entsprechen.

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);

Parameter

NameTypBeschreibung
formulasString[][]Ein zweidimensionales String-Array mit Formeln.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setFormulasR1C1(formulas)

Legt ein rechteckiges Raster aus Formeln fest (muss den Abmessungen dieses Bereichs entsprechen). Die angegebenen Formeln müssen in R1C1-Notation vorliegen.

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);

Parameter

NameTypBeschreibung
formulasString[][]Ein zweidimensionales Array von Formeln im R1C1-Format.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setHorizontalAlignment(alignment)

Legen Sie die horizontale Ausrichtung (links nach rechts) für den angegebenen Bereich fest (links/zentriert/rechts).

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

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

Parameter

NameTypBeschreibung
alignmentStringDie Ausrichtung, entweder 'left', 'center' oder 'normal'. Ein null-Wert setzt die Ausrichtung zurück.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setHorizontalAlignments(alignments)

Legt ein rechteckiges Raster horizontaler Ausrichtungen fest. siehe 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);

Parameter

NameTypBeschreibung
alignmentsObject[][]Ein zweidimensionales Array von Ausrichtungen, entweder 'left', 'center' oder 'normal'. Ein null-Wert setzt die Ausrichtung zurück.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen


setNote(note)

Setzt die Notiz auf den angegebenen Wert.

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

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

Parameter

NameTypBeschreibung
noteStringDer Hinweiswert, der für den Bereich festgelegt werden soll. Bei einem null-Wert wird der Hinweis entfernt.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setNotes(notes)

Legt ein rechteckiges Raster aus Notizen fest (muss den Abmessungen dieses Bereichs entsprechen).

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)

Parameter

NameTypBeschreibung
notesObject[][]Ein zweidimensionales Array von Notizen. Die Notiz wird durch null-Werte entfernt.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen


setNumberFormat(numberFormat)

Legt das Zahlen- oder Datumsformat auf den angegebenen Formatierungsstring fest. Die zulässigen Formatmuster sind in der Dokumentation zur Google Tabellen API aufgeführt.

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

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

Parameter

NameTypBeschreibung
numberFormatStringEin Zahlenformatstring.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setNumberFormats(numberFormats)

Legt ein rechteckiges Raster mit Zahlen- oder Datumsformaten fest (muss den Abmessungen dieses Bereichs entsprechen). Die Werte sind Strings im Formatmuster, wie in der Dokumentation zur Google Tabellen API beschrieben.

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);

Parameter

NameTypBeschreibung
numberFormatsObject[][]Ein zweidimensionales Array von Zahlenformaten.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setRichTextValue(value)

Legt den Rich-Text-Wert für die Zellen im Bereich fest.

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

Parameter

NameTypBeschreibung
valueRichTextValueDer gewünschte Rich-Text-Wert.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setRichTextValues(values)

Legt ein rechteckiges Raster mit Rich-Text-Werten fest.

// 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]]);

Parameter

NameTypBeschreibung
valuesRichTextValue[][]Die gewünschten Rich-Text-Werte.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Legt fest, ob im Bereich Hyperlinks angezeigt werden sollen.

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

Parameter

NameTypBeschreibung
showHyperlinkBooleanGibt an, ob der Hyperlink angezeigt werden soll.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setTextDirection(direction)

Legt die Textrichtung für die Zellen im Bereich fest. Wenn eine angegebene Richtung null ist, wird die Richtung abgeleitet und dann festgelegt.

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

Parameter

NameTypBeschreibung
directionTextDirectionDie gewünschte Textrichtung. Bei null wird die Richtung vor dem Festlegen abgeleitet.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setTextDirections(directions)

Legt ein rechteckiges Raster mit Textrichtungen fest. Wenn eine angegebene Richtung null ist, wird die Richtung abgeleitet und dann festgelegt.

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

Parameter

NameTypBeschreibung
directionsTextDirection[][]Die gewünschte Textrichtung. Wenn die angegebene Richtung null ist, wird sie vor dem Festlegen abgeleitet.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setTextRotation(degrees)

Legt die Textrotationseinstellungen für die Zellen im Bereich fest. Die Eingabe entspricht dem Winkel zwischen der Standardtextausrichtung und der gewünschten Ausrichtung. Wenn Sie null eingeben, wird für den Text die Standardausrichtung festgelegt.

Bei Textrichtungen von links nach rechts liegen positive Winkel gegen den Uhrzeigersinn, bei Texten von rechts nach links hingegen im Uhrzeigersinn.

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

Parameter

NameTypBeschreibung
degreesIntegerDer gewünschte Winkel zwischen der Standardausrichtung und der gewünschten Ausrichtung. Bei Text von links nach rechts gilt ein positiver Winkel gegen den Uhrzeigersinn.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setTextRotation(rotation)

Legt die Textrotationseinstellungen für die Zellen im Bereich fest.

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

Parameter

NameTypBeschreibung
rotationTextRotationDie gewünschten Einstellungen für die Textrotation.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setTextRotations(rotations)

Legt ein rechteckiges Raster von Textrotationen fest.

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

Parameter

NameTypBeschreibung
rotationsTextRotation[][]Die gewünschten Einstellungen für die Textrotation.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setTextStyle(style)

Legt den Textstil für die Zellen im Bereich fest.

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

Parameter

NameTypBeschreibung
styleTextStyleDer gewünschte Textstil.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setTextStyles(styles)

Legt ein rechteckiges Raster mit Textstilen fest.

// 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]]);

Parameter

NameTypBeschreibung
stylesTextStyle[][]Die gewünschten Textstile.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setValue(value)

Legt den Wert des Bereichs fest. Der Wert kann numerisch, String, Boolesch oder Datum sein. Wenn sie mit '=' beginnt, wird sie als Formel interpretiert.

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

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

Parameter

NameTypBeschreibung
valueObjectDer Wert für den Bereich.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setValues(values)

Legt ein rechteckiges Werteraster fest (muss den Dimensionen dieses Bereichs entsprechen). Wenn ein Wert mit = beginnt, wird er als Formel interpretiert.

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);

Parameter

NameTypBeschreibung
valuesObject[][]Ein zweidimensionales Array von Werten.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setVerticalAlignment(alignment)

Legen Sie die vertikale Ausrichtung (von oben nach unten) für den angegebenen Bereich (oben/Mitte/unten) fest.

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

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

Parameter

NameTypBeschreibung
alignmentStringDie Ausrichtung, entweder 'top', 'middle' oder 'bottom'. Ein null-Wert setzt die Ausrichtung zurück.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setVerticalAlignments(alignments)

Legt ein rechteckiges Raster mit vertikalen Ausrichtungen fest (muss den Abmessungen dieses Bereichs entsprechen).

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);

Parameter

NameTypBeschreibung
alignmentsObject[][]Ein zweidimensionales Array von Ausrichtungen, entweder 'top', 'middle' oder 'bottom'. Ein null-Wert setzt die Ausrichtung zurück.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen


setVerticalText(isVertical)

Legt fest, ob der Text für die Zellen im Bereich gestapelt werden soll. Wenn der Text vertikal gestapelt ist, wird die Einstellung für die Textrotation ignoriert.

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

Parameter

NameTypBeschreibung
isVerticalBooleanGibt an, ob der Text gestapelt werden soll.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setWrap(isWrapEnabled)

Legt den Zellenumbruch des angegebenen Bereichs fest.

Bei Zellen mit aktiviertem Zeilenumbruch (Standardeinstellung) wird die Größe so angepasst, dass der gesamte Inhalt angezeigt wird. Zellen mit deaktiviertem Zeilenumbruch werden so weit wie möglich in der Zelle angezeigt, ohne dass ihre Größe geändert wird oder sie auf mehrere Zeilen laufen.

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

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

Parameter

NameTypBeschreibung
isWrapEnabledBooleanGibt an, ob der Text umgebrochen werden soll oder nicht.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setWrapStrategies(strategies)

Legt ein rechteckiges Raster mit Zusammenfassungsstrategien fest.

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

Parameter

NameTypBeschreibung
strategiesWrapStrategy[][]Die gewünschten Wrapping-Strategien.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setWrapStrategy(strategy)

Legt die Textumbruchstrategie für die Zellen im Bereich fest.

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

Parameter

NameTypBeschreibung
strategyWrapStrategyDie gewünschte Wrapping-Strategie.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

setWraps(isWrapEnabled)

Legt ein rechteckiges Raster von Richtlinien für den Zeilenumbruch fest (muss den Abmessungen dieses Bereichs entsprechen). Bei Zellen mit aktiviertem Zeilenumbruch (Standardeinstellung) wird die Größe so angepasst, dass der gesamte Inhalt angezeigt wird. Zellen mit deaktiviertem Zeilenumbruch werden so weit wie möglich in der Zelle angezeigt, ohne dass ihre Größe geändert wird oder sie auf mehrere Zeilen laufen.

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);

Parameter

NameTypBeschreibung
isWrapEnabledObject[][]Ein zweidimensionales Array von Umbruchvariablen, die bestimmen, ob Text in einer Zelle umgebrochen wird oder nicht.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Weitere Informationen


shiftColumnGroupDepth(delta)

Ändert die Spaltengruppierungstiefe des Bereichs um den angegebenen Wert.

Dadurch werden Gruppen, die sich mit dem Bereich überschneiden, erstellt, geändert oder gelöscht. Bei positiven Deltas werden Gruppen erstellt und/oder geändert. Bei negativen Deltas werden Gruppen gelöscht und/oder geändert.

Dies hat keine Auswirkungen, wenn die Gruppentiefe unter null oder über acht verringert wird.

Wenn column group control position den Wert BEFORE hat, wird ein Fehler ausgegeben, wenn versucht wird, die Tiefe der ersten Zeile zu verschieben.

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);

Parameter

NameTypBeschreibung
deltaIntegerDer Wert, um den die Spaltengruppentiefe dieses Bereichs geändert werden soll.

Rückflug

Range: Dieser Bereich für Verkettungen.

Löst aus

Error: beim Versuch, die Tiefe der ersten Spalte zu verschieben, wenn die Position des Steuerelements GroupControlTogglePosition.BEFORE ist

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

shiftRowGroupDepth(delta)

Ändert die Tiefe der Zeilengruppierung des Bereichs um den angegebenen Wert.

Dadurch werden Gruppen, die sich mit dem Bereich überschneiden, erstellt, geändert oder gelöscht. Bei positiven Deltas werden Gruppen erstellt und/oder geändert. Bei negativen Deltas werden Gruppen gelöscht und/oder geändert.

Dies hat keine Auswirkungen, wenn die Gruppentiefe unter null oder über acht verringert wird.

Wenn row group control position den Wert BEFORE hat, wird ein Fehler ausgegeben, wenn versucht wird, die Tiefe der ersten Zeile zu verschieben.

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);

Parameter

NameTypBeschreibung
deltaIntegerDer Wert, um den die Zeilengruppentiefe dieses Bereichs geändert werden soll.

Rückflug

Range: Dieser Bereich für Verkettungen.

Löst aus

Error: beim Versuch, die Tiefe der ersten Zeile zu verschieben, wenn die Position des Steuerelements GroupControlTogglePosition.BEFORE ist

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

sort(sortSpecObj)

Sortiert die Zellen im angegebenen Bereich nach der angegebenen Spalte und Reihenfolge.

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}]);

Parameter

NameTypBeschreibung
sortSpecObjObjectDie Spalten, nach denen sortiert werden soll.

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

splitTextToColumns()

Teilt eine Textspalte anhand eines automatisch erkannten Trennzeichens in mehrere Spalten auf.

// 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            |

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

splitTextToColumns(delimiter)

Teilt eine Textspalte mithilfe des angegebenen Strings als benutzerdefiniertes Trennzeichen in mehrere Spalten auf.

// 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            |

Parameter

NameTypBeschreibung
delimiterStringDas benutzerdefinierte Trennzeichen, nach dem die Aufteilung erfolgen soll.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

splitTextToColumns(delimiter)

Teilt eine Textspalte basierend auf dem angegebenen Trennzeichen in mehrere Spalten auf.

// 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            |

Parameter

NameTypBeschreibung
delimiterTextToColumnsDelimiterVoreingestelltes Trennzeichen für die Aufteilung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

trimWhitespace()

Hierbei werden Leerräume (z. B. Leerzeichen, Tabulatoren oder neue Zeilen) in allen Zellen in diesem Bereich entfernt. Entfernt sämtliche Leerzeichen am Anfang und Ende des Zellentexts und reduziert alle Teilfolgen verbleibenden Leerzeichen auf ein einzelnes Leerzeichen.

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)']

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

uncheck()

Ändert den Status der Kästchen im Bereich in „Nicht angeklickt“. Die Zellen im Bereich, die derzeit weder den konfigurierten als auch den deaktivierten Wert enthalten, werden ignoriert.

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

Rückflug

Range: Dieser Bereich für Verkettungen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

Verworfene Methoden