Diese Seite wurde von der Cloud Translation API übersetzt.

Class Range

Auf Tabellenbereiche zugreifen und sie ändern. Ein Bereich kann eine einzelne Zelle oder eine Gruppe angrenzender Zellen in einem Tabellenblatt sein.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`activate()`	`Range`	Legt den angegebenen Bereich als `active range` fest, wobei die Zelle oben links im Bereich die `current cell` ist.
`activateAsCurrentCell()`	`Range`	Legt die angegebene Zelle als `current cell` fest.
`addDeveloperMetadata(key)`	`Range`	Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel hinzu.
`addDeveloperMetadata(key, visibility)`	`Range`	Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel und der angegebenen Sichtbarkeit hinzu.
`addDeveloperMetadata(key, value)`	`Range`	Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel und Wert hinzu.
`addDeveloperMetadata(key, value, visibility)`	`Range`	Fügt dem Bereich Entwicklermetadaten mit dem angegebenen Schlüssel, Wert und der angegebenen Sichtbarkeit hinzu.
`applyColumnBanding()`	`Banding`	Wendet ein Standarddesign für die Spaltenformatierung auf den Bereich an.
`applyColumnBanding(bandingTheme)`	`Banding`	Wendet ein angegebenes Design für Spaltenstreifen auf den Bereich an.
`applyColumnBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Wendet ein angegebenes Spaltenbandendesign auf den Bereich mit den angegebenen Kopf- und Fußzeileneinstellungen an.
`applyRowBanding()`	`Banding`	Wendet ein Standarddesign für die Zeilenformatierung auf den Bereich an.
`applyRowBanding(bandingTheme)`	`Banding`	Wendet ein angegebenes Design für Zeilenstreifen auf den Bereich an.
`applyRowBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Wendet ein angegebenes Zeilenbandendesign auf den Bereich mit den angegebenen Header- und Fußzeileneinstellungen an.
`autoFill(destination, series)`	`void`	Füllt `destinationRange` mit Daten basierend auf den Daten in diesem Bereich.
`autoFillToNeighbor(series)`	`void`	Berechnet einen Bereich, der mit neuen Daten gefüllt werden soll, basierend auf benachbarten Zellen und füllt diesen Bereich automatisch mit neuen Werten basierend auf den darin enthaltenen Daten.
`breakApart()`	`Range`	Mehrspaltige Zellen im Bereich werden wieder in einzelne Zellen aufgeteilt.
`canEdit()`	`Boolean`	Gibt an, ob der Nutzer die Berechtigung hat, jede Zelle im Bereich zu bearbeiten.
`check()`	`Range`	Ändert den Status der Kästchen im Bereich in „checked“.
`clear()`	`Range`	Löscht den Bereich mit Inhalten und Formaten.
`clear(options)`	`Range`	Löscht den Bereich mit Inhalten, Format, Datenvalidierungsregeln und/oder Kommentaren, wie mit den angegebenen erweiterten Optionen festgelegt.
`clearContent()`	`Range`	Löscht den Inhalt des Bereichs, wobei die Formatierung beibehalten wird.
`clearDataValidations()`	`Range`	Löscht die Datenvalidierungsregeln für den Bereich.
`clearFormat()`	`Range`	Entfernt die Formatierung für diesen Bereich.
`clearNote()`	`Range`	Löscht die Notiz in der angegebenen Zelle oder den angegebenen Zellen.
`collapseGroups()`	`Range`	Minimiert alle Gruppen, die vollständig im Bereich enthalten sind.
`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Kopiert die Formatierung des Bereichs an den angegebenen Speicherort.
`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Kopiert die Formatierung des Bereichs an den angegebenen Speicherort.
`copyTo(destination)`	`void`	Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich.
`copyTo(destination, copyPasteType, transposed)`	`void`	Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich.
`copyTo(destination, options)`	`void`	Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich.
`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Kopieren Sie den Inhalt des Bereichs an den angegebenen Ort.
`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Kopieren Sie den Inhalt des Bereichs an den angegebenen Ort.
`createDataSourcePivotTable(dataSource)`	`DataSourcePivotTable`	Erstellt eine leere Pivot-Tabelle für die Datenquelle, die in der ersten Zelle dieses Bereichs verankert ist.
`createDataSourceTable(dataSource)`	`DataSourceTable`	Erstellt eine leere Datenquellentabelle aus der Datenquelle, die in der ersten Zelle dieses Bereichs verankert ist.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Gibt eine DeveloperMetadataFinderApi zurück, mit der Entwicklermetadaten im Bereich dieses Bereichs gesucht werden können.
`createFilter()`	`Filter`	Erstellt einen Filter und wendet ihn auf den angegebenen Bereich im Tabellenblatt an.
`createPivotTable(sourceData)`	`PivotTable`	Erstellt eine leere Pivot-Tabelle aus dem angegebenen `sourceData`, die in der ersten Zelle dieses Bereichs verankert ist.
`createTextFinder(findText)`	`TextFinder`	Erstellt einen Textfinder für den Bereich, mit dem Text in diesem Bereich gesucht und ersetzt werden kann.
`deleteCells(shiftDimension)`	`void`	Damit wird dieser Zellenbereich gelöscht.
`expandGroups()`	`Range`	Maximiert die minimierten Gruppen, deren Bereich oder Steuerelement mit diesem Bereich überschneidet.
`getA1Notation()`	`String`	Gibt eine Stringbeschreibung des Bereichs in A1-Notation zurück.
`getBackground()`	`String`	Gibt die Hintergrundfarbe der Zelle oben links im Bereich zurück, z. B. `'#ffffff'`.
`getBackgroundObject()`	`Color`	Gibt die Hintergrundfarbe der Zelle oben links 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 Bandierungen zurück, die auf Zellen in diesem Bereich angewendet werden.
`getCell(row, column)`	`Range`	Gibt eine bestimmte Zelle in einem Bereich zurück.
`getColumn()`	`Integer`	Gibt die Startspaltenposition für diesen Bereich zurück.
`getDataRegion()`	`Range`	Gibt eine Kopie des Bereichs zurück, der in den vier Kardinalrichtungen `Direction` erweitert wurde, um alle angrenzenden Zellen mit Daten abzudecken.
`getDataRegion(dimension)`	`Range`	Gibt eine Kopie des Bereichs zurück, der um `Direction.UP` und `Direction.DOWN` erweitert wurde, wenn die angegebene Dimension `Dimension.ROWS` ist, oder um `Direction.NEXT` und `Direction.PREVIOUS`, wenn die Dimension `Dimension.COLUMNS` ist.
`getDataSourceFormula()`	`DataSourceFormula`	Gibt die `DataSourceFormula` für die erste Zelle im Bereich oder `null` zurück, wenn die Zelle keine Datenquellenformel enthält.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Gibt die `DataSourceFormula`s 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()`	`String`	Gibt eine URL für die Daten in diesem Bereich zurück, die zum Erstellen von Diagrammen und Abfragen verwendet werden kann.
`getDataTable()`	`DataTable`	Gibt die Daten in diesem Objekt als DataTable zurück.
`getDataTable(firstRowIsHeader)`	`DataTable`	Gibt die Daten in diesem Bereich als DataTable zurück.
`getDataValidation()`	`DataValidation`	Gibt die Regel zur Datenvalidierung für die Zelle oben links 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()`	`String`	Gibt den angezeigten Wert der Zelle oben links im Bereich zurück.
`getDisplayValues()`	`String[][]`	Gibt das rechteckige Raster von Werten für diesen Bereich zurück.
`getFilter()`	`Filter`	Gibt den Filter für das Tabellenblatt zurück, zu dem dieser Bereich gehört, oder `null`, wenn kein Filter für das Tabellenblatt vorhanden ist.
`getFontColorObject()`	`Color`	Gibt 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()`	`String`	Gibt die Schriftfamilie der Zelle in der oberen linken Ecke des Bereichs zurück.
`getFontLine()`	`String`	Ruft die Linienart der Zelle in der oberen linken Ecke des Bereichs ab (`'underline'`, `'line-through'` oder `'none'`).
`getFontLines()`	`String[][]`	Ruft die Linienart der Zellen im Bereich ab (`'underline'`, `'line-through'` oder `'none'`).
`getFontSize()`	`Integer`	Gibt die Schriftgröße der Zelle in der oberen linken Ecke des Bereichs in Punktgröße zurück.
`getFontSizes()`	`Integer[][]`	Gibt die Schriftgrößen der Zellen im Bereich zurück.
`getFontStyle()`	`String`	Gibt die Schriftformatierung (`'italic'` oder `'normal'`) der Zelle in der oberen linken Ecke des Bereichs zurück.
`getFontStyles()`	`String[][]`	Gibt die Schriftformatierungen der Zellen im Bereich zurück.
`getFontWeight()`	`String`	Gibt 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()`	`String`	Gibt die Formel (A1-Notation) für die Zelle oben links im Bereich zurück oder einen leeren String, wenn die Zelle leer ist oder keine Formel enthält.
`getFormulaR1C1()`	`String`	Gibt die Formel (R1C1-Notation) für eine bestimmte Zelle zurück oder `null`, wenn keine vorhanden ist.
`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()`	`Integer`	Gibt die Raster-ID des übergeordneten Tabellenblatts des Bereichs zurück.
`getHeight()`	`Integer`	Gibt die Höhe des Bereichs zurück.
`getHorizontalAlignment()`	`String`	Gibt die horizontale Ausrichtung des Texts (links/zentriert/rechts) der Zelle in der oberen linken Ecke des Bereichs zurück.
`getHorizontalAlignments()`	`String[][]`	Gibt die horizontale Ausrichtung der Zellen im Bereich zurück.
`getLastColumn()`	`Integer`	Gibt die Position der Endspalte zurück.
`getLastRow()`	`Integer`	Gibt 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)`	`Range`	Gibt, beginnend mit der Zelle in der ersten Spalte und Zeile des Bereichs, die nächste Zelle in der angegebenen Richtung zurück, die den Rand eines zusammenhängenden Bereichs von Zellen mit Daten oder die Zelle am Rand der Tabelle in dieser Richtung darstellt.
`getNote()`	`String`	Gibt die dem angegebenen Bereich zugeordnete Anmerkung zurück.
`getNotes()`	`String[][]`	Gibt die Notizen zurück, die den Zellen im Bereich zugeordnet sind.
`getNumColumns()`	`Integer`	Gibt die Anzahl der Spalten in diesem Bereich zurück.
`getNumRows()`	`Integer`	Gibt die Anzahl der Zeilen in diesem Bereich zurück.
`getNumberFormat()`	`String`	Gibt die Zahlen- oder Datumsformatierung der Zelle oben links im angegebenen Bereich zurück.
`getNumberFormats()`	`String[][]`	Gibt die Zahlen- oder Datumsformate für die Zellen im Bereich zurück.
`getRichTextValue()`	`RichTextValue`	Gibt den Rich-Text-Wert für die obere linke Zelle des Bereichs zurück oder `null`, wenn der Zellenwert kein Text ist.
`getRichTextValues()`	`RichTextValue[][]`	Gibt die Rich-Text-Werte für die Zellen im Bereich zurück.
`getRow()`	`Integer`	Gibt die Zeilenposition für diesen Bereich zurück.
`getRowIndex()`	`Integer`	Gibt die Zeilenposition für diesen Bereich zurück.
`getSheet()`	`Sheet`	Gibt das Tabellenblatt zurück, zu dem dieser Bereich gehört.
`getTextDirection()`	`TextDirection`	Gibt die Textrichtung für die obere linke Zelle des Bereichs zurück.
`getTextDirections()`	`TextDirection[][]`	Gibt die Textrichtung für die Zellen im Bereich zurück.
`getTextRotation()`	`TextRotation`	Gibt die Einstellungen für die Textrotation für die Zelle oben links im Bereich zurück.
`getTextRotations()`	`TextRotation[][]`	Gibt die Einstellungen für die Textrotation für die Zellen im Bereich zurück.
`getTextStyle()`	`TextStyle`	Gibt den Textstil für die obere linke Zelle des Bereichs zurück.
`getTextStyles()`	`TextStyle[][]`	Gibt die Textformatierungen für die Zellen im Bereich zurück.
`getValue()`	`Object`	Gibt den Wert der Zelle oben links im Bereich zurück.
`getValues()`	`Object[][]`	Gibt das rechteckige Raster von Werten für diesen Bereich zurück.
`getVerticalAlignment()`	`String`	Gibt die vertikale Ausrichtung (oben/Mitte/unten) der Zelle in der oberen linken Ecke des Bereichs zurück.
`getVerticalAlignments()`	`String[][]`	Gibt die vertikalen Ausrichtungen der Zellen im Bereich zurück.
`getWidth()`	`Integer`	Gibt die Breite des Bereichs in Spalten zurück.
`getWrap()`	`Boolean`	Gibt zurück, ob der Text in der Zelle umgebrochen wird.
`getWrapStrategies()`	`WrapStrategy[][]`	Gibt die Strategien für den Zeilenumbruch für die Zellen im Bereich zurück.
`getWrapStrategy()`	`WrapStrategy`	Gibt die Strategie für den Zeilenumbruch für die Zelle oben links im Bereich zurück.
`getWraps()`	`Boolean[][]`	Gibt zurück, ob der Text in den Zellen umgebrochen wird.
`insertCells(shiftDimension)`	`Range`	Fügt leere Zellen in diesen Bereich ein.
`insertCheckboxes()`	`Range`	Fügt in jede Zelle im Bereich Kontrollkästchen ein, die mit `true` für ausgewählt und `false` für nicht ausgewählt konfiguriert sind.
`insertCheckboxes(checkedValue)`	`Range`	Fügt in jede Zelle im Bereich Kontrollkästchen ein, die mit einem benutzerdefinierten Wert für „Ausgewählt“ und dem leeren String für „Nicht ausgewählt“ konfiguriert sind.
`insertCheckboxes(checkedValue, uncheckedValue)`	`Range`	Fügt in jede Zelle im Bereich Kästchen ein, die mit benutzerdefinierten Werten für die ausgewählten und nicht ausgewählten Zustände konfiguriert sind.
`isBlank()`	`Boolean`	Gibt `true` zurück, wenn der Bereich vollständig leer ist.
`isChecked()`	`Boolean`	Gibt zurück, ob alle Zellen im Bereich das Kontrollkästchen „Aktiviert“ haben.
`isEndColumnBounded()`	`Boolean`	Gibt an, ob das Ende des Bereichs an eine bestimmte Spalte gebunden ist.
`isEndRowBounded()`	`Boolean`	Gibt an, ob das Ende des Bereichs an eine bestimmte Zeile gebunden ist.
`isPartOfMerge()`	`Boolean`	Gibt `true` zurück, wenn sich die Zellen im aktuellen Bereich mit zusammengeführten Zellen überschneiden.
`isStartColumnBounded()`	`Boolean`	Gibt an, ob der Beginn des Bereichs an eine bestimmte Spalte gebunden ist.
`isStartRowBounded()`	`Boolean`	Gibt an, ob der Beginn des Bereichs an eine bestimmte Zeile gebunden ist.
`merge()`	`Range`	Führt die Zellen im Bereich zu einem einzelnen Block zusammen.
`mergeAcross()`	`Range`	Verbinden Sie die Zellen im Bereich über die Spalten des Bereichs hinweg.
`mergeVertically()`	`Range`	Führt die Zellen im Bereich zusammen.
`moveTo(target)`	`void`	Schneiden Sie den Bereich aus und fügen Sie ihn in den Zielbereich ein (sowohl Format als auch Werte).
`offset(rowOffset, columnOffset)`	`Range`	Gibt einen neuen Bereich zurück, der um die angegebene Anzahl von Zeilen und Spalten (die negativ sein kann) von diesem Bereich versetzt ist.
`offset(rowOffset, columnOffset, numRows)`	`Range`	Gibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist. Deren obere linke Ecke ist um die angegebenen Zeilen und Spalten vom aktuellen Bereich versetzt und hat die angegebene Höhe in Zellen.
`offset(rowOffset, columnOffset, numRows, numColumns)`	`Range`	Gibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist. Deren obere linke Ecke ist um die angegebene Anzahl von Zeilen und Spalten vom aktuellen Bereich versetzt. Der neue Bereich hat die angegebene Höhe und Breite in Zellen.
`protect()`	`Protection`	Erstellt ein Objekt, mit dem der Bereich vor Änderungen geschützt werden kann, die nicht von Nutzern mit Berechtigung vorgenommen werden.
`randomize()`	`Range`	Ordnet die Zeilen im angegebenen Bereich zufällig an.
`removeCheckboxes()`	`Range`	Entfernt alle Kästchen aus dem Bereich.
`removeDuplicates()`	`Range`	Entfernt Zeilen in diesem Bereich, die Werte enthalten, die Duplikate von Werten in einer vorherigen Zeile sind.
`removeDuplicates(columnsToCompare)`	`Range`	Entfernt Zeilen in diesem Bereich, die in den angegebenen Spalten Werte enthalten, die Duplikate von Werten in einer vorherigen Zeile sind.
`setBackground(color)`	`Range`	Legt die Hintergrundfarbe aller Zellen im Bereich in CSS-Notation fest, z. B. `'#ffffff'` oder `'white'`.
`setBackgroundObject(color)`	`Range`	Legt die Hintergrundfarbe aller Zellen im Bereich fest.
`setBackgroundObjects(color)`	`Range`	Legt ein rechteckiges Raster mit Hintergrundfarben fest, das den Dimensionen dieses Bereichs entsprechen muss.
`setBackgroundRGB(red, green, blue)`	`Range`	Legt den Hintergrund auf die angegebene Farbe fest. Dazu werden RGB-Werte (Ganzzahlen zwischen 0 und 255) verwendet.
`setBackgrounds(color)`	`Range`	Legt ein rechteckiges Raster mit Hintergrundfarben fest, das den Dimensionen dieses Bereichs entsprechen muss.
`setBorder(top, left, bottom, right, vertical, horizontal)`	`Range`	Legt die Border-Property fest.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`Range`	Legt die Rahmeneigenschaft mit Farbe und/oder Stil fest.
`setDataValidation(rule)`	`Range`	Legt eine Datenvalidierungsregel für alle Zellen im Bereich fest.
`setDataValidations(rules)`	`Range`	Legt die Datenvalidierungsregeln für alle Zellen im Bereich fest.
`setFontColor(color)`	`Range`	Legt die Schriftfarbe in CSS-Notation fest, z. B. `'#ffffff'` oder `'white'`.
`setFontColorObject(color)`	`Range`	Legt die Schriftfarbe des angegebenen Bereichs fest.
`setFontColorObjects(colors)`	`Range`	Legt ein rechteckiges Raster mit Schriftfarben fest, das den Dimensionen dieses Bereichs entsprechen muss.
`setFontColors(colors)`	`Range`	Legt ein rechteckiges Raster mit Schriftfarben fest, das den Dimensionen dieses Bereichs entsprechen muss.
`setFontFamilies(fontFamilies)`	`Range`	Legt ein rechteckiges Raster von Schriftfamilien fest (muss mit den Dimensionen dieses Bereichs übereinstimmen).
`setFontFamily(fontFamily)`	`Range`	Legt die Schriftfamilie fest, z. B. „Arial“ oder „Helvetica“.
`setFontLine(fontLine)`	`Range`	Legt den Schriftlinienstil des angegebenen Bereichs (`'underline'`, `'line-through'` oder `'none'`) fest.
`setFontLines(fontLines)`	`Range`	Legt ein rechteckiges Raster mit Linienstilen fest (muss mit den Dimensionen dieses Bereichs übereinstimmen).
`setFontSize(size)`	`Range`	Legt die Schriftgröße fest. Die Größe ist die zu verwendende Punktgröße.
`setFontSizes(sizes)`	`Range`	Legt ein rechteckiges Raster von Schriftgrößen fest (muss mit den Dimensionen dieses Bereichs übereinstimmen).
`setFontStyle(fontStyle)`	`Range`	Legt den Schriftstil für den angegebenen Bereich (`'italic'` oder `'normal'`) fest.
`setFontStyles(fontStyles)`	`Range`	Legt ein rechteckiges Raster von Schriftarten fest (muss mit den Dimensionen dieses Bereichs übereinstimmen).
`setFontWeight(fontWeight)`	`Range`	Legen Sie die Schriftstärke für den angegebenen Bereich fest (normal/fett).
`setFontWeights(fontWeights)`	`Range`	Legt ein rechteckiges Raster von Schriftstärken fest (muss mit den Dimensionen dieses Bereichs übereinstimmen).
`setFormula(formula)`	`Range`	Aktualisiert die Formel für diesen Bereich.
`setFormulaR1C1(formula)`	`Range`	Aktualisiert die Formel für diesen Bereich.
`setFormulas(formulas)`	`Range`	Legt ein rechteckiges Raster mit Formeln fest, das den Dimensionen dieses Bereichs entsprechen muss.
`setFormulasR1C1(formulas)`	`Range`	Legt ein rechteckiges Raster mit Formeln fest, das den Dimensionen dieses Bereichs entsprechen muss.
`setHorizontalAlignment(alignment)`	`Range`	Legt die horizontale (von links nach rechts) Ausrichtung für den angegebenen Bereich fest (links/Mitte/rechts).
`setHorizontalAlignments(alignments)`	`Range`	Legt ein rechteckiges Raster mit horizontalen Ausrichtungen fest.
`setNote(note)`	`Range`	Legt die Notiz auf den angegebenen Wert fest.
`setNotes(notes)`	`Range`	Legt ein rechteckiges Notengitter fest (muss mit den Dimensionen dieses Bereichs übereinstimmen).
`setNumberFormat(numberFormat)`	`Range`	Legt das Zahlen- oder Datumsformat auf den angegebenen Formatierungsstring fest.
`setNumberFormats(numberFormats)`	`Range`	Legt ein rechteckiges Raster mit Zahlen- oder Datumsformaten fest, die mit den Dimensionen dieses Bereichs übereinstimmen müssen.
`setRichTextValue(value)`	`Range`	Legt den Rich-Text-Wert für die Zellen im Bereich fest.
`setRichTextValues(values)`	`Range`	Legt ein rechteckiges Raster mit Rich-Text-Werten fest.
`setShowHyperlink(showHyperlink)`	`Range`	Legt fest, ob im Bereich Hyperlinks angezeigt werden sollen.
`setTextDirection(direction)`	`Range`	Legt die Textrichtung für die Zellen im Bereich fest.
`setTextDirections(directions)`	`Range`	Legt ein rechteckiges Raster mit Textrichtungen fest.
`setTextRotation(degrees)`	`Range`	Legt die Einstellungen für die Textrotation für die Zellen im Bereich fest.
`setTextRotation(rotation)`	`Range`	Legt die Einstellungen für die Textrotation für die Zellen im Bereich fest.
`setTextRotations(rotations)`	`Range`	Legt ein rechteckiges Raster von Textrotationen fest.
`setTextStyle(style)`	`Range`	Legt den Textstil für die Zellen im Bereich fest.
`setTextStyles(styles)`	`Range`	Legt ein rechteckiges Raster mit Textformatierungen fest.
`setValue(value)`	`Range`	Legt den Wert des Bereichs fest.
`setValues(values)`	`Range`	Legt ein rechteckiges Raster mit Werten fest, das mit den Dimensionen dieses Bereichs übereinstimmen muss.
`setVerticalAlignment(alignment)`	`Range`	Legt die vertikale Ausrichtung (von oben nach unten) für den angegebenen Bereich fest (oben/Mitte/unten).
`setVerticalAlignments(alignments)`	`Range`	Legt ein rechteckiges Raster mit vertikalen Ausrichtungen fest, das den Abmessungen dieses Bereichs entsprechen muss.
`setVerticalText(isVertical)`	`Range`	Legt fest, ob der Text für die Zellen im Bereich gestapelt werden soll.
`setWrap(isWrapEnabled)`	`Range`	Legen Sie den Zeilenumbruch für den angegebenen Bereich fest.
`setWrapStrategies(strategies)`	`Range`	Legt ein rechteckiges Raster von Umbruchstrategien fest.
`setWrapStrategy(strategy)`	`Range`	Legt die Strategie für den Zeilenumbruch für die Zellen im Bereich fest.
`setWraps(isWrapEnabled)`	`Range`	Legt ein rechteckiges Raster von Zeilenumbruchrichtlinien fest, das mit den Dimensionen dieses Bereichs übereinstimmen muss.
`shiftColumnGroupDepth(delta)`	`Range`	Ändert die Tiefe der Spaltengruppierung des Bereichs um den angegebenen Betrag.
`shiftRowGroupDepth(delta)`	`Range`	Ändert die Tiefe der Zeilengruppierung des Bereichs um den angegebenen Wert.
`sort(sortSpecObj)`	`Range`	Sortiert die Zellen im angegebenen Bereich nach der angegebenen Spalte und Reihenfolge.
`splitTextToColumns()`	`void`	Teilt eine Textspalte anhand eines automatisch erkannten Trennzeichens in mehrere Spalten auf.
`splitTextToColumns(delimiter)`	`void`	Teilt eine Textspalte anhand des angegebenen Strings als benutzerdefiniertes Trennzeichen in mehrere Spalten auf.
`splitTextToColumns(delimiter)`	`void`	Teilt eine Textspalte anhand des angegebenen Trennzeichens in mehrere Spalten auf.
`trimWhitespace()`	`Range`	Entfernt die Leerräume (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) in jeder Zelle in diesem Bereich.
`uncheck()`	`Range`	Ändert den Status der Kästchen im Bereich in „nicht angekreuzt“.

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getFontColor()`	`String`	Gibt die Schriftfarbe der Zelle in der oberen linken Ecke des Bereichs in CSS-Notation zurück (z. B. `'#ffffff'` oder `'white'`).
`getFontColors()`	`String[][]`	Gibt die Schriftfarben der Zellen im Bereich in CSS-Notation zurück (z. B. `'#ffffff'` oder `'white'`).

Detaillierte Dokumentation

`activate()`

Legt den angegebenen Bereich als active range fest, wobei die Zelle oben links im Bereich die current cell ist.

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

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

Rückflug

Range – Dieser Bereich zur Verkettung.

`activateAsCurrentCell()`

Legt die angegebene Zelle als current cell fest.

Wenn die angegebene Zelle in einem vorhandenen Bereich enthalten ist, wird dieser Bereich zum aktiven Bereich und die Zelle zur aktuellen Zelle.

Wenn die angegebene Zelle in keinem vorhandenen Bereich enthalten 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.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];

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

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

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Name	Typ	Beschreibung
`key`	`String`	Der Schlüssel für die neuen Entwicklermetadaten.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 der angegebenen 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

Name	Typ	Beschreibung
`key`	`String`	Der Schlüssel für die neuen Entwicklermetadaten.
`visibility`	`DeveloperMetadataVisibility`	Die Sichtbarkeit der neuen Entwicklermetadaten.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Name	Typ	Beschreibung
`key`	`String`	Der Schlüssel für die neuen Entwicklermetadaten.
`value`	`String`	Der Wert für die neuen Entwicklermetadaten.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 angegebenen 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

Name	Typ	Beschreibung
`key`	`String`	Der Schlüssel für die neuen Entwicklermetadaten.
`value`	`String`	Der Wert für die neuen Entwicklermetadaten.
`visibility`	`DeveloperMetadataVisibility`	Die Sichtbarkeit der neuen Entwicklermetadaten.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`applyColumnBanding()`

Wendet ein Standarddesign für die Spaltenformatierung auf den Bereich an. Standardmäßig hat die Streifenbildung eine Kopfzeile, aber keine Fußzeilenfarbe.

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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`applyColumnBanding(bandingTheme)`

Wendet ein angegebenes Design für Spaltenstreifen auf den Bereich an. Standardmäßig hat die Streifenbildung eine Kopfzeilenfarbe, aber keine Fußzeilenfarbe.

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

Name	Typ	Beschreibung
`bandingTheme`	`BandingTheme`	Ein Farbschema, das auf die Spalten im Bereich angewendet werden soll.

Rückflug

Banding – Das neue Banding.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

Wendet ein angegebenes Spaltenbandendesign 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

Name	Typ	Beschreibung
`bandingTheme`	`BandingTheme`	Ein Farbschema, das auf die Spalten im Bereich angewendet werden soll.
`showHeader`	`Boolean`	Bei `true` wird die Kopfzeilenfarbe des Banding-Designs auf die erste Spalte angewendet.
`showFooter`	`Boolean`	Falls `true`, wird die Fußzeilenfarbe des Banding-Designs auf die letzte Spalte angewendet.

Rückflug

Banding – Das neue Banding.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`applyRowBanding()`

Wendet ein Standarddesign für die Zeilenformatierung auf den Bereich an. Standardmäßig hat die Streifenbildung eine Kopfzeile, aber keine Fußzeilenfarbe.

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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`applyRowBanding(bandingTheme)`

Wendet ein angegebenes Design für Zeilenstreifen auf den Bereich an. Standardmäßig hat die Streifenbildung eine Kopfzeile, aber keine Fußzeilenfarbe.

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

Name	Typ	Beschreibung
`bandingTheme`	`BandingTheme`	Ein Farbschema, das auf die Zeilen im Bereich angewendet werden soll.

Rückflug

Banding – Das neue Banding.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`applyRowBanding(bandingTheme, showHeader, showFooter)`

Wendet ein angegebenes Zeilenbandendesign auf den Bereich mit den angegebenen Header- 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

Name	Typ	Beschreibung
`bandingTheme`	`BandingTheme`	Ein Farbschema, das auf die Zeilen im Bereich angewendet werden soll.
`showHeader`	`Boolean`	Bei `true` wird die Kopfzeilenfarbe des Streifendesigns auf die erste Zeile angewendet.
`showFooter`	`Boolean`	Falls `true`, wird die Fußzeilenfarbe des Banding-Designs auf die letzte Zeile angewendet.

Rückflug

Banding – Das neue Banding.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`autoFill(destination, series)`

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

const sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
const sourceRange = sheet.getRange('A1:A4');
// The range to fill with values.
const 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

Name	Typ	Beschreibung
`destination`	`Range`	Der Bereich, der automatisch mit Werten ausgefüllt werden soll. Der Zielbereich sollte diesen Bereich enthalten und ihn nur in einer Richtung (nach oben, unten, links oder rechts) erweitern.
`series`	`AutoFillSeries`	Der Typ der AutoFill-Reihe, die zum Berechnen neuer Werte verwendet werden soll. Die Auswirkungen dieser Reihe hängen vom Typ und der Menge der Quelldaten ab.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`autoFillToNeighbor(series)`

Berechnet einen Bereich, der mit neuen Daten gefüllt werden soll, basierend auf benachbarten Zellen und füllt diesen Bereich automatisch mit neuen Werten basierend auf den darin enthaltenen Daten. Diese neuen Werte werden auch durch den angegebenen series-Typ bestimmt.

Beim Berechnen des Zielbereichs werden die umgebenden Daten berücksichtigt, um zu ermitteln, wo die neuen Werte eingefügt werden sollen. Wenn sich unmittelbar links oder rechts von einer Spalte, die automatisch ausgefüllt wird, Daten befinden, werden neue Werte nur bis zu diesen angrenzenden Daten eingefügt.

Wenn A1:A20 beispielsweise mit einer Reihe von aufsteigenden Zahlen gefüllt ist und diese Methode für den Bereich B1:B4 aufgerufen wird, der eine Reihe von Datumsangaben enthält, werden nur neue Werte in B5:B20 eingefügt. So bleiben diese neuen Werte an den Zellen mit Werten in Spalte A „haften“.

const sheet = SpreadsheetApp.getActiveSheet();

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

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

Parameter

Name	Typ	Beschreibung
`series`	`AutoFillSeries`	Der Typ der AutoFill-Reihe, die zum Berechnen neuer Werte verwendet werden soll. Die Auswirkungen dieser Reihe hängen vom Typ und der Menge der Quelldaten ab.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`breakApart()`

Mehrspaltige Zellen im Bereich werden wieder in einzelne Zellen aufgeteilt.

Wenn Sie diese Funktion auf einen Bereich anwenden, entspricht das dem Auswählen eines Bereichs und dem 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 zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`canEdit()`

Gibt an, ob der Nutzer die Berechtigung hat, jede Zelle im Bereich zu bearbeiten. Der Eigentümer der Tabelle kann geschützte Bereiche und Tabellenblätter immer 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 die Berechtigung hat, jede Zelle im Bereich zu bearbeiten; andernfalls false.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`check()`

Ändert den Status der Kästchen im Bereich in „checked“. Zellen im Bereich, die derzeit weder den konfigurierten Wert für „checked“ noch den für „unchecked“ 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'.
const range = SpreadsheetApp.getActive().getRange('A1:B10');
range.check();

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`clear()`

Löscht den Bereich mit Inhalten und Formaten.

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

const range = sheet.getRange('A1:D10');
range.clear();

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`clear(options)`

Löscht den Bereich mit Inhalten, Format, Datenvalidierungsregeln und/oder Kommentaren, wie mit den angegebenen erweiterten Optionen festgelegt. 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

Name	Typ	Beschreibung
`options`	`Object`	Ein JavaScript-Objekt, das erweiterte Parameter enthält, wie unten aufgeführt.

Erweiterte Parameter

Name	Typ	Beschreibung
`commentsOnly`	`Boolean`	Gibt an, ob nur die Kommentare gelöscht werden sollen.
`contentsOnly`	`Boolean`	Ob nur der Inhalt gelöscht werden soll.
`formatOnly`	`Boolean`	Gibt an, ob nur das Format gelöscht werden soll. Wenn Sie das Format löschen, werden auch Datenvalidierungsregeln gelöscht.
`validationsOnly`	`Boolean`	Gibt an, ob nur Datenvalidierungsregeln gelöscht werden sollen.
`skipFilteredRows`	`Boolean`	Gibt an, ob gefilterte Zeilen nicht gelöscht werden sollen.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`clearContent()`

Löscht den Inhalt des Bereichs, wobei die Formatierung beibehalten wird.

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

const range = sheet.getRange('A1:D10');
range.clearContent();

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.
const range = SpreadsheetApp.getActive().getRange('A1:B5');
range.clearDataValidations();

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`clearFormat()`

Entfernt die Formatierung für diesen Bereich.

Dadurch wird die Textformatierung für die Zelle oder die Zellen im Bereich entfernt, aber es werden keine Regeln für die Zahlenformatierung zurückgesetzt.

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

const range = sheet.getRange('A1:D10');
range.clearFormat();

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`clearNote()`

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

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

const range = sheet.getRange('A1:D10');
range.clearNote();

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 keine Gruppe vollständig im Bereich liegt, wird die am tiefsten verschachtelte Gruppe, die teilweise im Bereich liegt, minimiert.

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

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

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 Speicherort. Wenn der Zielbereich größer oder kleiner als der Quellbereich ist, wird die Quelle entsprechend wiederholt oder gekürzt. Mit dieser Methode wird nur die Formatierung kopiert.

Eine ausführliche Beschreibung des Parameters „gridId“ finden Sie unter getGridId().

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

const 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

Name	Typ	Beschreibung
`gridId`	`Integer`	Die eindeutige ID des Blatts in der Tabelle, unabhängig von der Position.
`column`	`Integer`	Die erste Spalte des Zielbereichs.
`columnEnd`	`Integer`	Die Endspalte des Zielbereichs.
`row`	`Integer`	Die Startzeile des Zielbereichs.
`rowEnd`	`Integer`	Die letzte Zeile des Zielbereichs.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Weitere Informationen

getGridId()

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

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

const 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

Name	Typ	Beschreibung
`sheet`	`Sheet`	Das Zieltabellenblatt.
`column`	`Integer`	Die erste Spalte des Zielbereichs.
`columnEnd`	`Integer`	Die Endspalte des Zielbereichs.
`row`	`Integer`	Die Startzeile des Zielbereichs.
`rowEnd`	`Integer`	Die letzte Zeile des Zielbereichs.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5);
rangeToCopy.copyTo(sheet.getRange(1, 6));

Parameter

Name	Typ	Beschreibung
`destination`	`Range`	Ein Zielbereich, in den kopiert werden soll. Nur die Position der Zelle links oben ist relevant.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.
const sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange('A:E').copyTo(
    sheet.getRange('F1'),
    SpreadsheetApp.CopyPasteType.PASTE_VALUES,
    false,
);

Parameter

Name	Typ	Beschreibung
`destination`	`Range`	Ein Zielbereich, in den kopiert werden soll. Nur die Position der Zelle links oben ist relevant.
`copyPasteType`	`CopyPasteType`	Ein Typ, der angibt, wie der Bereichsinhalt in das Ziel eingefügt wird.
`transposed`	`Boolean`	Gibt an, ob der Bereich in seiner transponierten Ausrichtung eingefügt werden soll.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.
const sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange('A:E').copyTo(sheet.getRange('F1'), {contentsOnly: true});

Parameter

Name	Typ	Beschreibung
`destination`	`Range`	Ein Zielbereich, in den kopiert werden soll. Nur die Position der Zelle links oben ist relevant.
`options`	`Object`	Ein JavaScript-Objekt, das erweiterte Parameter enthält, wie unten aufgeführt.

Erweiterte Parameter

Name	Typ	Beschreibung
`formatOnly`	`Boolean`	gibt an, dass nur das Format kopiert werden soll.
`contentsOnly`	`Boolean`	gibt an, dass nur der Inhalt kopiert werden soll.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

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

Kopieren Sie den Inhalt des Bereichs an den angegebenen Ort. Wenn der Zielbereich größer oder kleiner als der Quellbereich ist, wird die Quelle entsprechend wiederholt oder gekürzt.

Eine ausführliche Beschreibung des Parameters „gridId“ finden Sie unter getGridId().

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

const 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

Name	Typ	Beschreibung
`gridId`	`Integer`	Die eindeutige ID des Blatts in der Tabelle, unabhängig von der Position.
`column`	`Integer`	Die erste Spalte des Zielbereichs.
`columnEnd`	`Integer`	Die Endspalte des Zielbereichs.
`row`	`Integer`	Die Startzeile des Zielbereichs.
`rowEnd`	`Integer`	Die letzte Zeile des Zielbereichs.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Weitere Informationen

getGridId()

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

Kopieren Sie den Inhalt des Bereichs an den angegebenen Ort. Wenn der Zielbereich größer oder kleiner als der Quellbereich ist, wird die Quelle entsprechend wiederholt oder gekürzt.

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

const 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

Name	Typ	Beschreibung
`sheet`	`Sheet`	Das Zieltabellenblatt.
`column`	`Integer`	Die erste Spalte des Zielbereichs.
`columnEnd`	`Integer`	Die Endspalte des Zielbereichs.
`row`	`Integer`	Die Startzeile des Zielbereichs.
`rowEnd`	`Integer`	Die letzte Zeile des Zielbereichs.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`createDataSourcePivotTable(dataSource)`

Erstellt eine leere Pivot-Tabelle für die Datenquelle, die in der ersten Zelle dieses Bereichs verankert ist.

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

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

const 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

Name	Typ	Beschreibung
`dataSource`	`DataSource`	Die Datenquelle, aus der die Pivot-Tabelle erstellt werden soll.

Rückflug

DataSourcePivotTable: Die neu erstellte Pivot-Tabelle für die Datenquelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`createDataSourceTable(dataSource)`

Erstellt eine leere Datenquellentabelle aus der Datenquelle, die in der ersten Zelle dieses Bereichs verankert ist.

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

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

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

Parameter

Name	Typ	Beschreibung
`dataSource`	`DataSource`	Die Datenquelle, aus der die Pivot-Tabelle erstellt werden soll.

Rückflug

DataSourceTable: Die neu erstellte Datenquellentabelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`createDeveloperMetadataFinder()`

Gibt eine DeveloperMetadataFinderApi zurück, mit der Entwicklermetadaten im Bereich dieses Bereichs gesucht werden können. Metadaten fallen nur dann in den Bereich, wenn sie vollständig in diesem Bereich enthalten sind. Metadaten, die der Zeile „3:3“ zugeordnet sind, fallen beispielsweise nicht in den Bereich „A1:D5“, aber in den 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: Ein Tool zum Suchen nach Entwicklermetadaten im Bereich dieses Bereichs.

`createFilter()`

Erstellt einen Filter und wendet ihn auf den angegebenen Bereich im Tabellenblatt an. Sie können in einem Tabellenblatt nur einen Filter erstellen. Wenn Sie nach dem Erstellen auf Ihren Filter zugreifen und ihn ändern möchten, verwenden Sie getFilter() oder Sheet.getFilter().

const ss = SpreadsheetApp.getActiveSheet();
const 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() {
  const filter = range.getFilter();
  const criteria =
      SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();
  filter.setColumnFilterCriteria(2, criteria);
}

Mit dieser Methode können Sie Filter für Grid-Tabellen erstellen, den Standardtyp von Tabellen. Tabellenblätter mit Raster sind Tabellenblätter, die nicht mit einer Datenbank verbunden sind. Informationen zum Erstellen anderer Filtertypen finden Sie in den folgenden Artikeln:

Pivot-Tabellenfilter mit PivotTable.addFilter(sourceDataColumn, filterCriteria) erstellen
Filter für ein Tabellenblatt erstellen, das mit einer Datenbank mit DataSourceSheet.addFilter(columnName, filterCriteria) verbunden ist
Filter für eine Pivot-Tabelle erstellen, die mit einer Datenbank mit DataSourcePivotTable.addFilter(columnName, filterCriteria) verbunden ist

Rückflug

Filter: Der neue Filter.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`createPivotTable(sourceData)`

Erstellt eine leere Pivot-Tabelle aus dem angegebenen sourceData, die in der ersten Zelle dieses Bereichs verankert ist.

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

Name	Typ	Beschreibung
`sourceData`	`Range`	Die Daten, aus denen die Pivot-Tabelle erstellt werden soll.

Rückflug

PivotTable: Die neu erstellte PivotTable.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`createTextFinder(findText)`

Erstellt einen Textfinder für den Bereich, mit dem Text in diesem Bereich gesucht und ersetzt werden kann.

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

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

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

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

Parameter

Name	Typ	Beschreibung
`findText`	`String`	Der Text, nach dem gesucht werden soll.

Rückflug

TextFinder: Die TextFinder für den Bereich

`deleteCells(shiftDimension)`

Damit wird dieser Zellenbereich gelöscht. Vorhandene Daten im Tabellenblatt entlang der angegebenen Dimension werden in Richtung des gelöschten Bereichs verschoben.

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

const range = sheet.getRange('A1:D10');
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

Parameter

Name	Typ	Beschreibung
`shiftDimension`	`Dimension`	Die Dimension, entlang der vorhandene Daten verschoben werden sollen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`expandGroups()`

Maximiert die minimierten Gruppen, deren Bereich oder Steuerelement mit diesem Bereich überschneidet. Die Position des Steuerelement-Schalters ist der Index, an dem der Steuerelement-Schalter angezeigt wird, je nach Einstellungen direkt vor oder nach der Gruppe. Wenn sich mehrere Gruppen am selben Ort befinden, wird die Gruppe mit der geringsten Tiefe maximiert.

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

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

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getA1Notation()`

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getBackground()`

Gibt die Hintergrundfarbe der Zelle oben links im Bereich zurück, z. B. '#ffffff'.

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

const cell = sheet.getRange('B5');
Logger.log(cell.getBackground());

Rückflug

String: Der Farbcode des Hintergrunds.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getBackgroundObject()`

Gibt die Hintergrundfarbe der Zelle oben links im Bereich zurück.

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

const cell = sheet.getRange('B5');
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

Rückflug

Color: Die Hintergrundfarbe der Zelle oben links im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getBackgroundObjects()`

Gibt die Hintergrundfarben der Zellen im Bereich zurück.

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

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

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

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

Rückflug

String[][]: Ein zweidimensionales Array mit Farbcodes für die Hintergründe.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getBandings()`

Gibt alle Bandierungen zurück, die auf 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 (const banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Rückflug

Banding[]: Alle Bandings, die auf Zellen in diesem Bereich angewendet werden.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.

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

const 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
const cell = range.getCell(1, 1);
Logger.log(cell.getValue());

Parameter

Name	Typ	Beschreibung
`row`	`Integer`	Die Zeile der Zelle relativ zum Bereich.
`column`	`Integer`	Die Spalte der Zelle relativ zum Bereich.

Rückflug

Range: Ein Bereich mit einer einzelnen Zelle an den angegebenen Koordinaten.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getColumn()`

Gibt die Startspaltenposition für diesen Bereich zurück.

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

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

Rückflug

Integer: Die Startspaltenposition des Bereichs in der Tabelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 Kardinalrichtungen Direction erweitert wurde, um alle angrenzenden Zellen mit Daten abzudecken. Wenn der Bereich von leeren Zellen umgeben ist, die nicht die Diagonalen umfassen, wird der Bereich selbst zurückgegeben. Das ist so, als würden Sie den Bereich auswählen und Ctrl+A in den Editor eingeben.

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getDataRegion(dimension)`

Gibt eine Kopie des Bereichs zurück, der um Direction.UP und Direction.DOWN erweitert wurde, wenn die angegebene Dimension Dimension.ROWS ist, oder um Direction.NEXT und Direction.PREVIOUS, wenn die Dimension Dimension.COLUMNS ist. Die Erweiterung des Bereichs basiert auf der Erkennung von Daten neben dem Bereich, die wie eine Tabelle organisiert sind. Der erweiterte Bereich umfasst alle angrenzenden Zellen mit Daten in 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.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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

Name	Typ	Beschreibung
`dimension`	`Dimension`	Die Dimension, entlang der der Bereich erweitert werden soll.

Rückflug

Range: Der Datenbereich des Bereichs oder ein Bereich, der jede Spalte oder jede Zeile des ursprünglichen Bereichs abdeckt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getDataSourceFormula()`

Gibt die 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: Die DataSourceFormula für die Zelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 mit Pivot-Tabellen für Datenquellen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 der Datenquellentabellen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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() {
  const ss = SpreadsheetApp.openById(
      '1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c',
  );
  const sheet = ss.getSheetByName('ContinentData');
  const range = sheet.getRange('A1:B8');

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

piechart.html

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

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

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

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

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

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.

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

// Calling this method with "true" sets the first line to be the title of the
// axes
const 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.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Title Here')
                  .build();

Parameter

Name	Typ	Beschreibung
`firstRowIsHeader`	`Boolean`	Gibt an, ob die erste Zeile als Header behandelt werden soll.

Rückflug

DataTable: Die Daten als Datentabelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getDataValidation()`

Gibt die Regel zur Datenvalidierung für die Zelle oben links 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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 Regel zur Datenvalidierung für die Zelle oben links im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 für die Position dieser Zelle im Array null zurück.

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

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

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getDisplayValue()`

Gibt den angezeigten Wert der Zelle oben links 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 automatisch durch die Spracheinstellung der Tabelle angewendet werden. Leere Zellen geben einen leeren String 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 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 angezeigte Wert in dieser Zelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getDisplayValues()`

Gibt das rechteckige Raster von Werten für diesen Bereich zurück.

Gibt ein zweidimensionales Array mit angezeigten Werten zurück, das zuerst nach Zeile und dann nach Spalte indexiert wird. Die Werte sind String-Objekte. Der angezeigte Wert berücksichtigt die Formatierung von Datum, Uhrzeit und Währung, einschließlich der Formate, die automatisch durch die Ländereinstellung der Tabelle angewendet werden. Leere Zellen werden im Array durch einen leeren String dargestellt. Ein Bereichsindex beginnt bei 1, 1, das JavaScript-Array wird jedoch 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.
const values =
    SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 kein Filter für das Tabellenblatt vorhanden ist.

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

Rückflug

Filter: Der Filter.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.

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

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

Rückflug

Color: Die Schriftfarbe der Zelle oben links im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getFontColorObjects()`

Gibt die Schriftfarben der Zellen im Bereich zurück.

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

const results = range.getFontColorObjects();

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getFontFamilies()`

Gibt die Schriftfamilien der Zellen im Bereich zurück.

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

const results = range.getFontFamilies();

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

Rückflug

String[][]: Ein zweidimensionales Array von Schriftfamilien, die den Zellen im Bereich zugeordnet sind.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.

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

Logger.log(range.getFontFamily());

Rückflug

String: Die Schriftfamilie der Zelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getFontLine()`

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

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

Logger.log(range.getFontLine());

Rückflug

String: Die Schriftartzeile.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getFontLines()`

Ruft die Linienart der Zellen im Bereich ab ('underline', 'line-through' oder 'none').

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

const results = range.getFontLines();

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

Rückflug

String[][]: Ein zweidimensionales Array mit Schriftartzeilen, die den Zellen im Bereich zugeordnet sind.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 in Punktgröße zurück.

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

Logger.log(range.getFontSize());

Rückflug

Integer: Die Schriftgröße in Punkt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getFontSizes()`

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

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

const results = range.getFontSizes();

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

Rückflug

Integer[][]: Ein zweidimensionales Array mit den Schriftgrößen des Texts, der den Zellen im Bereich zugeordnet ist.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getFontStyle()`

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

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

Logger.log(range.getFontStyle());

Rückflug

String: Der Schriftstil des Texts in der Zelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getFontStyles()`

Gibt die Schriftformatierungen der Zellen im Bereich zurück.

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

const results = range.getFontStyles();

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

Rückflug

String[][]: Ein zweidimensionales Array mit Schriftarten des Texts, der den Zellen im Bereich zugeordnet ist.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.

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

Logger.log(range.getFontWeight());

Rückflug

String – Die Schriftstärke des Texts in der Zelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getFontWeights()`

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

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

const results = range.getFontWeights();

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

Rückflug

String[][]: Ein zweidimensionales Array mit den Schriftstärken des Texts, der den Zellen im Bereich zugeordnet ist.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getFormula()`

Gibt die Formel (A1-Notation) für die Zelle oben links im Bereich zurück oder einen leeren String, wenn die Zelle leer ist oder keine Formel enthält.

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

// This assumes you have a function in B5 that sums up
// B2:B4
const 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 vorhanden ist.

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

const range = sheet.getRange('B5');
const formula = range.getFormulaR1C1();
Logger.log(formula);

Rückflug

String: Die Formel in R1C1-Notation.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 Strings für Zellen ohne Formel.

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

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.

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

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getGridId());

Rückflug

Integer: Die Tabellenblatt-ID des übergeordneten Blatts.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getHeight()`

Gibt die Höhe des Bereichs zurück.

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

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

Rückflug

Integer – Die Höhe des Bereichs.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.

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

Logger.log(range.getHorizontalAlignment());

Rückflug

String: Die horizontale Ausrichtung des Texts in der Zelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getHorizontalAlignments()`

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

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

const results = range.getHorizontalAlignments();

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

Rückflug

String[][]: Ein zweidimensionales Array mit horizontalen Ausrichtungen von Text, der den Zellen im Bereich zugeordnet ist.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getLastColumn()`

Gibt die Position der Endspalte zurück.

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

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

Rückflug

Integer: Die Spaltenposition des Endes des Bereichs in der Tabelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getLastRow()`

Gibt die Position der Endzeile zurück.

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

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

Rückflug

Integer: Die Endzeilenposition des Bereichs in der Tabelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.

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

const range = sheet.getRange('A1:B3');

const mergedRanges = range.getMergedRanges();
for (let 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 sich mit dem Bereich überschneiden.

`getNextDataCell(direction)`

Gibt, beginnend mit der Zelle in der ersten Spalte und Zeile des Bereichs, die nächste Zelle in der angegebenen Richtung zurück, die den Rand eines zusammenhängenden Bereichs von Zellen mit Daten oder die Zelle am Rand der Tabelle in dieser Richtung darstellt. Das entspricht der Eingabe von Ctrl+[arrow key] im Editor.

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

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

Parameter

Name	Typ	Beschreibung
`direction`	`Direction`	Die Richtung, in der die nächste Zelle am Rand des Datenbereichs gesucht werden soll.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getNote()`

Gibt die dem angegebenen Bereich zugeordnete Anmerkung zurück.

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

Logger.log(range.getNote());

Rückflug

String: Die der angegebenen Zelle zugeordnete Anmerkung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getNotes()`

Gibt die Notizen zurück, die den Zellen im Bereich zugeordnet sind.

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

const results = range.getNotes();

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

Rückflug

String[][]: Ein zweidimensionales Array mit Notizen, die Zellen im Bereich zugeordnet sind.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getNumColumns()`

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

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

const range = sheet.getRange('B2:D5');
Logger.log(range.getNumColumns());

Rückflug

Integer – Die Anzahl der Spalten in diesem Bereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getNumRows()`

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

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

const range = sheet.getRange('B2:D5');
Logger.log(range.getNumRows());

Rückflug

Integer – Die Anzahl der Zeilen in diesem Bereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getNumberFormat()`

Gibt die Zahlen- oder Datumsformatierung der Zelle oben links im angegebenen Bereich zurück. Die zurückgegebenen Formatmuster werden in der Sheets API-Dokumentation beschrieben.

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

const cell = sheet.getRange('C4');
Logger.log(cell.getNumberFormat());

Rückflug

String: Das Zahlenformat der Zelle oben links im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getNumberFormats()`

Gibt die Zahlen- oder Datumsformate für die Zellen im Bereich zurück. Die zurückgegebenen Formatmuster werden in der Sheets API-Dokumentation beschrieben.

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

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

Rückflug

String[][] – Ein zweidimensionales Array mit Zahlenformaten.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getRichTextValue()`

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

// Gets the Rich Text value of cell D4.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('D4:F6');
const 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
const values = range.getRichTextValues();

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

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

const range = sheet.getRange('B2');
Logger.log(range.getRow());

Rückflug

Integer – Die Zeilenposition des Bereichs.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

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

const range = sheet.getRange('B2');
Logger.log(range.getRowIndex());

Rückflug

Integer – Die Zeilenposition des Bereichs.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Weitere Informationen

getRow()

`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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 durch automatische Erkennung bestimmt wird.

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

Rückflug

TextDirection: Die Textrichtung der oberen linken Zelle im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getTextDirections()`

Gibt die Textrichtung für die Zellen im Bereich zurück. Einträge im 2D-Array sind null für Zellen, die die automatische Erkennung verwenden.

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

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getTextRotation()`

Gibt die Einstellungen für die Textrotation für die Zelle oben links im Bereich zurück.

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

const cell = sheet.getRange('A1');
Logger.log(cell.getTextRotation());

Rückflug

TextRotation: Die Einstellungen für die Textrotation.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getTextRotations()`

Gibt die Einstellungen für die Textrotation für die Zellen im Bereich zurück.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

const results = range.getTextRotations();

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

Rückflug

TextRotation[][]: Ein zweidimensionales Array mit Textrotationen, die den Zellen im Bereich zugeordnet sind.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getTextStyle()`

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

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

Rückflug

TextStyle: Der Textstil der Zelle oben links im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getTextStyles()`

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

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

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getValue()`

Gibt den Wert der Zelle oben links im Bereich zurück. Der Wert kann je nach Zellwert vom Typ Number, Boolean, Date oder String sein. Leere Zellen geben einen leeren String 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 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getValues()`

Gibt das rechteckige Raster von Werten für diesen Bereich zurück.

Gibt ein zweidimensionales Array von Werten zurück, das zuerst nach Zeile und dann nach Spalte indexiert wird. Die Werte können je nach Zellwert vom Typ Number, Boolean, Date oder String sein. Leere Zellen werden im Array durch einen leeren String dargestellt. Ein Bereichsindex beginnt bei 1, 1, das JavaScript-Array wird jedoch 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.
const values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);

In Web-Apps ist ein Date-Wert kein zulässiger Parameter. getValues() gibt keine Daten an eine Web-App zurück, wenn der Bereich eine Zelle mit dem Wert Date enthält. Stattdessen müssen Sie alle aus dem Tabellenblatt abgerufenen Werte in einen unterstützten einfachen JavaScript-Wert wie Number, Boolean oder String umwandeln.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.

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

Logger.log(range.getVerticalAlignment());

Rückflug

String: Die vertikale Ausrichtung des Texts in der Zelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getVerticalAlignments()`

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

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

const results = range.getVerticalAlignments();

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

Rückflug

String[][]: Ein zweidimensionales Array mit vertikalen Ausrichtungen von Text, der mit Zellen im Bereich verknüpft ist.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 – Die Anzahl der Spalten im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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. Wenn Sie eine detailliertere Umbruchstrategie benötigen, verwenden Sie getWrapStrategy().

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getWrapStrategies()`

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

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

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

Rückflug

WrapStrategy[][]: Ein zweidimensionales Array mit Textumbruchstrategien.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getWrapStrategy()`

Gibt die Strategie für den Zeilenumbruch für die Zelle oben links im Bereich zurück.

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

Rückflug

WrapStrategy: Die Strategie für den Zeilenumbruch der oberen linken Zelle im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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. Wenn Sie eine detailliertere Umbruchstrategie benötigen, verwenden Sie getWrapStrategies().

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

const results = range.getVerticalAlignments();

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

Rückflug

Boolean[][]: Ein zweidimensionales Array mit vertikalen Ausrichtungen von Text, der mit Zellen im Bereich verknüpft ist.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`insertCells(shiftDimension)`

Fügt leere Zellen in diesen Bereich ein. Die neuen Zellen behalten die Formatierung bei, die in den Zellen vorhanden war, die diesen Bereich zuvor belegt haben. Vorhandene Daten im Tabellenblatt werden entlang der angegebenen Dimension vom eingefügten Bereich weg verschoben.

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

const range = sheet.getRange('A1:D10');
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

Parameter

Name	Typ	Beschreibung
`shiftDimension`	`Dimension`	Die Dimension, entlang der vorhandene Daten verschoben werden sollen.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`insertCheckboxes()`

Fügt in jede Zelle im Bereich Kontrollkästchen ein, die mit true für ausgewählt und false für nicht ausgewählt konfiguriert sind. Legt den Wert aller Zellen im Bereich auf false fest.

const 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 zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`insertCheckboxes(checkedValue)`

Fügt in jede Zelle im Bereich Kontrollkästchen ein, die mit einem benutzerdefinierten Wert für „Ausgewählt“ und dem leeren String für „Nicht ausgewählt“ konfiguriert sind. Legt den Wert jeder Zelle im Bereich auf den leeren String fest.

const 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

Name	Typ	Beschreibung
`checkedValue`	`Object`	Der Wert, der für die Datenvalidierung des Kästchens ausgewählt ist.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`insertCheckboxes(checkedValue, uncheckedValue)`

Fügt in jede Zelle im Bereich Kästchen ein, die mit benutzerdefinierten Werten für die ausgewählten und nicht ausgewählten Zustände konfiguriert sind. Legt den Wert jeder Zelle im Bereich auf den benutzerdefinierten Wert für nicht angekreuzte Kästchen fest.

const 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

Name	Typ	Beschreibung
`checkedValue`	`Object`	Der Wert, der für die Datenvalidierung des Kästchens ausgewählt ist.
`uncheckedValue`	`Object`	Der Wert für das Kästchen ohne Häkchen für die Datenvalidierung.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.

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

Logger.log(range.isBlank());

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`isChecked()`

Gibt zurück, ob alle Zellen im Bereich das Kontrollkästchen „Aktiviert“ haben. Gibt null zurück, wenn einige Zellen markiert und die restlichen nicht markiert sind oder wenn für einige Zellen keine Datenvalidierung für das Kontrollkästchen festgelegt ist.

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

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

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

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

const range3 = SpreadsheetApp.getActive().getRange('A3');
range3.setValue('random');
// Sets the value of isRange3Checked as null, as it contains an invalid checkbox
// value.
const 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 der Zellen deaktiviert ist oder keine Datenvalidierung für das Kontrollkästchen vorhanden ist.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`isEndColumnBounded()`

Gibt an, 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`isEndRowBounded()`

Gibt an, 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 zusammengeführten Zellen überschneiden.

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

const range = sheet.getRange('A1:B3');

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

Rückflug

Boolean – true, wenn sich der Bereich mit zusammengeführten Zellen überschneidet. Andernfalls wird false zurückgegeben.

`isStartColumnBounded()`

Gibt an, ob der Beginn 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 Beginn des Bereichs an eine bestimmte Spalte gebunden ist, andernfalls false.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`isStartRowBounded()`

Gibt an, ob der Beginn 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 Beginn des Bereichs an eine bestimmte Zeile gebunden ist, andernfalls false.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`merge()`

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

const 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 zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`mergeAcross()`

Verbinden Sie die Zellen im Bereich über die Spalten des Bereichs hinweg.

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

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

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

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`mergeVertically()`

Führt die Zellen im Bereich zusammen.

const 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 zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`moveTo(target)`

Schneiden Sie den Bereich aus und fügen Sie ihn in den Zielbereich ein (sowohl Format als auch Werte).

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

Parameter

Name	Typ	Beschreibung
`target`	`Range`	Ein Zielbereich, in den dieser Bereich kopiert werden soll. Nur die Position der Zelle links oben ist relevant.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 versetzt ist. Der neue Bereich hat dieselbe Größe wie der ursprüngliche Bereich.

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

const cell = sheet.getRange('A1');

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

Parameter

Name	Typ	Beschreibung
`rowOffset`	`Integer`	Die Anzahl der Zeilen unterhalb der Zelle oben links im Bereich. Negative Werte stellen Zeilen oberhalb der Zelle oben links im Bereich dar.
`columnOffset`	`Integer`	Die Anzahl der Spalten rechts von der Zelle oben links im Bereich. Negative Werte stellen Spalten links von der Zelle oben links im Bereich dar.

Rückflug

Range – Dieser Bereich zur Verkettung.

`offset(rowOffset, columnOffset, numRows)`

Gibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist. Deren obere linke Ecke ist um die angegebenen Zeilen und Spalten vom aktuellen Bereich versetzt und hat die angegebene Höhe in Zellen.

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

const cell = sheet.getRange('A1');

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

Parameter

Name	Typ	Beschreibung
`rowOffset`	`Integer`	Die Anzahl der Zeilen unterhalb der Zelle oben links im Bereich. Negative Werte stellen Zeilen oberhalb der Zelle oben links im Bereich dar.
`columnOffset`	`Integer`	Die Anzahl der Spalten rechts von der Zelle oben links im Bereich. Negative Werte stellen Spalten links von der Zelle oben links im Bereich dar.
`numRows`	`Integer`	Die Höhe des neuen Bereichs in Zeilen.

Rückflug

Range – Dieser Bereich zur Verkettung.

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

Gibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist. Deren obere linke Ecke ist um die angegebene Anzahl von Zeilen und Spalten vom aktuellen Bereich versetzt. Der neue Bereich hat die angegebene Höhe und Breite in Zellen.

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

const cell = sheet.getRange('A1');

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

Parameter

Name	Typ	Beschreibung
`rowOffset`	`Integer`	Die Anzahl der Zeilen unterhalb der Zelle oben links im Bereich. Negative Werte stellen Zeilen oberhalb der Zelle oben links im Bereich dar.
`columnOffset`	`Integer`	Die Anzahl der Spalten rechts von der Zelle oben links im Bereich. Negative Werte stellen Spalten links von der Zelle oben links im Bereich dar.
`numRows`	`Integer`	Die Höhe des neuen Bereichs in Zeilen.
`numColumns`	`Integer`	Die Breite des neuen Bereichs in Spalten.

Rückflug

Range – Dieser Bereich zur Verkettung.

`protect()`

Erstellt ein Objekt, mit dem der Bereich vor Änderungen geschützt werden kann, die nicht von Nutzern mit Berechtigung vorgenommen werden. Bis das Skript die Liste der Bearbeiter für den Bereich tatsächlich ändert (durch Aufrufen von Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) oder durch Festlegen eines neuen Werts für Protection.setDomainEdit(editable)), entsprechen die Berechtigungen denen der Tabelle selbst. Das bedeutet, dass der Bereich effektiv ungeschützt bleibt. Wenn der Bereich bereits geschützt ist, wird mit dieser Methode ein neuer geschützter Bereich erstellt, der sich mit dem vorhandenen überschneidet. Wenn eine Zelle durch mehrere geschützte Bereiche geschützt ist und einer davon einen bestimmten Nutzer daran hindert, die Zelle zu bearbeiten, darf dieser Nutzer die Zelle nicht bearbeiten.

// Protect range A1:B10, then remove all other users from the list of editors.
const ss = SpreadsheetApp.getActive();
const range = ss.getRange('A1:B10');
const 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.
const 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`randomize()`

Ordnet die Zeilen im angegebenen Bereich zufällig an.

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

// Randomizes the range
range.randomize();

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`removeCheckboxes()`

Entfernt alle Kästchen aus dem Bereich. Entfernt die Datenvalidierung jeder Zelle und löscht zusätzlich ihren Wert, wenn die Zelle entweder den angekreuzten oder den nicht angekreuzten Wert enthält.

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

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

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

const 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 zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 und unterschiedlicher Groß- und Kleinschreibung, Formatierung oder unterschiedlichen Formeln gelten ebenfalls 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.

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

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`removeDuplicates(columnsToCompare)`

Entfernt Zeilen in diesem Bereich, die in den angegebenen Spalten Werte enthalten, die Duplikate von Werten in einer vorherigen Zeile sind. Zeilen mit identischen Werten und unterschiedlicher Groß- und Kleinschreibung, Formatierung oder unterschiedlichen Formeln gelten ebenfalls als Duplikate. Mit dieser Methode werden auch doppelte Zeilen entfernt, die ausgeblendet sind (z. B. aufgrund eines Filters). Inhalte außerhalb dieses Bereichs werden nicht entfernt.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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

Name	Typ	Beschreibung
`columnsToCompare`	`Integer[]`	Die Spalten, die auf doppelte Werte analysiert werden sollen. Wenn keine Spalten angegeben sind, werden alle Spalten auf Duplikate analysiert.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

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

const range = sheet.getRange('B2:D5');
range.setBackground('red');

Parameter

Name	Typ	Beschreibung
`color`	`String`	Ein Farbcode in CSS-Notation (z. B. `'#ffffff'` oder `'white'`). Mit dem Wert `null` wird die Farbe zurückgesetzt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setBackgroundObject(color)`

Legt die Hintergrundfarbe aller Zellen im Bereich fest.

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

const range = sheet.getRange('B2:D5');
range.setBackgroundObject(bgColor);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Die festzulegende Hintergrundfarbe. Mit dem Wert `null` wird die Hintergrundfarbe zurückgesetzt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setBackgroundObjects(color)`

Legt ein rechteckiges Raster mit Hintergrundfarben fest, das den Dimensionen dieses Bereichs entsprechen muss.

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

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

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

const cell = sheet.getRange('B5:C6');
cell.setBackgroundObjects(colors);

Parameter

Name	Typ	Beschreibung
`color`	`Color[][]`	Ein zweidimensionales Array von Farben. Mit `null`-Werten wird die Farbe zurückgesetzt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setBackgroundRGB(red, green, blue)`

Legt den Hintergrund auf die angegebene Farbe fest. Dazu werden RGB-Werte (Ganzzahlen zwischen 0 und 255) verwendet.

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

const 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

Name	Typ	Beschreibung
`red`	`Integer`	Der Rotwert in RGB-Schreibweise.
`green`	`Integer`	Der grüne Wert in RGB-Schreibweise.
`blue`	`Integer`	Der blaue Wert in der RGB-Notation.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setBackgrounds(color)`

Legt ein rechteckiges Raster mit Hintergrundfarben fest, das den Dimensionen dieses Bereichs entsprechen muss. Die Farben werden in CSS-Notation angegeben, z. B. '#ffffff' oder 'white'.

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

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

const cell = sheet.getRange('B5:D6');
cell.setBackgrounds(colors);

Parameter

Name	Typ	Beschreibung
`color`	`String[][]`	Ein zweidimensionales Array von Farben in CSS-Notation (z. B. `'#ffffff'` oder `'white'`). Mit `null`-Werten wird die Farbe zurückgesetzt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

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

Legt die Border-Property fest. Gültige Werte sind true (an), false (aus) und null (keine Änderung).

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

const 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

Name	Typ	Beschreibung
`top`	`Boolean`	`true` für Rahmen, `false` für „Kein“ und `null` für „Keine Änderung“.
`left`	`Boolean`	`true` für Rahmen, `false` für „Kein“ und `null` für „Keine Änderung“.
`bottom`	`Boolean`	`true` für Rahmen, `false` für „Kein“ und `null` für „Keine Änderung“.
`right`	`Boolean`	`true` für Rahmen, `false` für „Kein“ und `null` für „Keine Änderung“.
`vertical`	`Boolean`	`true` für interne vertikale Rahmen, `false` für keinen und `null` für keine Änderung.
`horizontal`	`Boolean`	`true` für interne horizontale Rahmen, `false` für keine und `null` für keine Änderung.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 (an), false (aus) und null (keine Änderung). Verwenden Sie für die Farbe die CSS-Notation (z. B. '#ffffff' oder 'white').

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

const 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

Name	Typ	Beschreibung
`top`	`Boolean`	`true` für Rahmen, `false` für „Kein“ und `null` für „Keine Änderung“.
`left`	`Boolean`	`true` für Rahmen, `false` für „Kein“ und `null` für „Keine Änderung“.
`bottom`	`Boolean`	`true` für Rahmen, `false` für „Kein“ und `null` für „Keine Änderung“.
`right`	`Boolean`	`true` für Rahmen, `false` für „Kein“ und `null` für „Keine Änderung“.
`vertical`	`Boolean`	`true` für interne vertikale Rahmen, `false` für keinen und `null` für keine Änderung.
`horizontal`	`Boolean`	`true` für interne horizontale Rahmen, `false` für keine und `null` für keine Änderung.
`color`	`String`	Eine Farbe in CSS-Notation (z. B. `'#ffffff'` oder `'white'`), `null` für die Standardfarbe (Schwarz).
`style`	`BorderStyle`	Ein Stil für die Rahmen. `null` für den Standardstil (durchgezogen).

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`rule`	`DataValidation`	Die festzulegende Regel für die Datenvalidierung oder `null` zum Entfernen der Datenvalidierung.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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. Diese Methode verwendet ein zweidimensionales Array von Datenvalidierungen, das zuerst nach Zeile und dann nach Spalte indexiert wird. Die Array-Dimensionen müssen den Bereichsdimensionen entsprechen.

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

Parameter

Name	Typ	Beschreibung
`rules`	`DataValidation[][]`	Ein zweidimensionales Array von Datenvalidierungsregeln, die festgelegt werden sollen. `null`-Werte entfernen die Datenvalidierung.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontColor(color)`

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

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

const cell = sheet.getRange('B2');
cell.setFontColor('red');

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die Schriftfarbe in CSS-Notation (z. B. `'#ffffff'` oder `'white'`). Mit dem Wert `null` wird die Farbe zurückgesetzt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontColorObject(color)`

Legt die Schriftfarbe des angegebenen Bereichs fest.

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

const cell = sheet.getRange('B2');
cell.setFontColor(color);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Die festzulegende Schriftfarbe. Mit dem Wert `null` wird die Farbe zurückgesetzt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontColorObjects(colors)`

Legt ein rechteckiges Raster mit Schriftfarben fest, das den Dimensionen dieses Bereichs entsprechen muss.

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

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

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

const cell = sheet.getRange('B5:C6');
cell.setFontColorObjects(colors);

Parameter

Name	Typ	Beschreibung
`colors`	`Color[][]`	Ein zweidimensionales Array von Farben. Mit `null`-Werten wird die Schriftfarbe zurückgesetzt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontColors(colors)`

Legt ein rechteckiges Raster mit Schriftfarben fest, das den Dimensionen dieses Bereichs entsprechen muss. Die Farben werden in CSS-Notation angegeben, z. B. '#ffffff' oder 'white'.

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

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

const cell = sheet.getRange('B5:D6');
cell.setFontColors(colors);

Parameter

Name	Typ	Beschreibung
`colors`	`Object[][]`	Ein zweidimensionales Array von Farben in CSS-Notation (z. B. `'#ffffff'` oder `'white'`). Mit `null`-Werten wird die Farbe zurückgesetzt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontFamilies(fontFamilies)`

Legt ein rechteckiges Raster von Schriftfamilien fest (muss mit den Dimensionen dieses Bereichs übereinstimmen). Beispiele für Schriftfamilien sind „Arial“ oder „Helvetica“.

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

const fonts = [
  ['Arial', 'Helvetica', 'Verdana'],
  ['Courier New', 'Arial', 'Helvetica'],
];

const cell = sheet.getRange('B2:D3');
cell.setFontFamilies(fonts);

Parameter

Name	Typ	Beschreibung
`fontFamilies`	`Object[][]`	Ein zweidimensionales Array von Schriftfamilien. `null`-Werte setzen die Schriftfamilie zurück.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontFamily(fontFamily)`

Legt die Schriftfamilie fest, z. B. „Arial“ oder „Helvetica“.

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

const cell = sheet.getRange('B2');
cell.setFontFamily('Helvetica');

Parameter

Name	Typ	Beschreibung
`fontFamily`	`String`	Die festzulegende Schriftfamilie. Mit dem Wert `null` wird die Schriftfamilie zurückgesetzt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontLine(fontLine)`

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

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

const cell = sheet.getRange('B2');
cell.setFontLine('line-through');

Parameter

Name	Typ	Beschreibung
`fontLine`	`String`	Der Linienstil der Schriftart, entweder `'underline'`, `'line-through'` oder `'none'`. Mit dem Wert `null` wird der Linienstil der Schriftart zurückgesetzt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontLines(fontLines)`

Legt ein rechteckiges Raster mit Linienstilen fest (muss mit den Dimensionen dieses Bereichs übereinstimmen).

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

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

const range = sheet.getRange('B2:D2');
range.setFontLines(fontLines);

Parameter

Name	Typ	Beschreibung
`fontLines`	`Object[][]`	Ein zweidimensionales Array mit Schriftart-Linienstilen (`'underline'`, `'line-through'` oder `'none'`); `null`-Werte setzen den Schriftart-Linienstil zurück.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontSize(size)`

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

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

const cell = sheet.getRange('B2');
cell.setFontSize(20);

Parameter

Name	Typ	Beschreibung
`size`	`Integer`	Eine Schriftgröße in Punktgröße.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontSizes(sizes)`

Legt ein rechteckiges Raster von Schriftgrößen fest (muss mit den Dimensionen dieses Bereichs übereinstimmen). Die Größen werden in Punkten angegeben.

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

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

const range = sheet.getRange('B2:D2');
range.setFontSizes(fontSizes);

Parameter

Name	Typ	Beschreibung
`sizes`	`Object[][]`	Ein zweidimensionales Array mit Größen.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontStyle(fontStyle)`

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

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

const cell = sheet.getRange('B2');
cell.setFontStyle('italic');

Parameter

Name	Typ	Beschreibung
`fontStyle`	`String`	Der Schriftstil, entweder `'italic'` oder `'normal'`. Mit dem Wert `null` wird der Schriftstil zurückgesetzt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontStyles(fontStyles)`

Legt ein rechteckiges Raster von Schriftarten fest (muss mit den Dimensionen dieses Bereichs übereinstimmen).

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

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

const range = sheet.getRange('B2:C2');
range.setFontStyles(fontStyles);

Parameter

Name	Typ	Beschreibung
`fontStyles`	`Object[][]`	Ein zweidimensionales Array von Schriftformatierungen, entweder `'italic'` oder `'normal'`. `null`-Werte setzen die Schriftformatierung zurück.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontWeight(fontWeight)`

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

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

const cell = sheet.getRange('B2');
cell.setFontWeight('bold');

Parameter

Name	Typ	Beschreibung
`fontWeight`	`String`	Die Schriftstärke, entweder `'bold'` oder `'normal'`. Mit dem Wert `null` wird die Schriftstärke zurückgesetzt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFontWeights(fontWeights)`

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

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

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

const range = sheet.getRange('B2:D2');
range.setFontWeights(fontStyles);

Parameter

Name	Typ	Beschreibung
`fontWeights`	`Object[][]`	Ein zweidimensionales Array von Schriftstärken, entweder `'bold'` oder `'normal'`. `null`-Werte setzen die Schriftstärke zurück.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 der A1-Notation vorliegen.

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

const cell = sheet.getRange('B5');
cell.setFormula('=SUM(B3:B4)');

Parameter

Name	Typ	Beschreibung
`formula`	`String`	Ein String, der die für die Zelle festzulegende Formel darstellt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 der R1C1-Notation angegeben werden.

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

const 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

Name	Typ	Beschreibung
`formula`	`String`	Eine Stringformel.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFormulas(formulas)`

Legt ein rechteckiges Raster mit Formeln fest, das den Dimensionen dieses Bereichs entsprechen muss. Die angegebenen Formeln müssen in der A1-Notation sein. Diese Methode verwendet ein zweidimensionales Array von Formeln, das zuerst nach Zeile und dann nach Spalte indexiert wird. Die Array-Dimensionen müssen den Bereichsdimensionen entsprechen.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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.
const formulas = [
  ['=SUM(B2:B4)', '=SUM(C2:C4)', '=SUM(D2:D4)'],
  ['=AVERAGE(B2:B4)', '=AVERAGE(C2:C4)', '=AVERAGE(D2:D4)'],
];

const cell = sheet.getRange('B5:D6');
cell.setFormulas(formulas);

Parameter

Name	Typ	Beschreibung
`formulas`	`String[][]`	Ein zweidimensionales String-Array mit Formeln.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setFormulasR1C1(formulas)`

Legt ein rechteckiges Raster mit Formeln fest, das den Dimensionen dieses Bereichs entsprechen muss. Die angegebenen Formeln müssen in R1C1-Notation vorliegen.

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

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

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

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

Parameter

Name	Typ	Beschreibung
`formulas`	`String[][]`	Ein zweidimensionales Array von Formeln im R1C1-Format.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setHorizontalAlignment(alignment)`

Legt die horizontale (von links nach rechts) Ausrichtung für den angegebenen Bereich fest (links/Mitte/rechts).

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

const cell = sheet.getRange('B2');
cell.setHorizontalAlignment('center');

Parameter

Name	Typ	Beschreibung
`alignment`	`String`	Die Ausrichtung, entweder `'left'`, `'center'` oder `'normal'`. Ein `null`-Wert setzt die Ausrichtung zurück.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setHorizontalAlignments(alignments)`

Legt ein rechteckiges Raster mit horizontalen Ausrichtungen fest. Siehe setHorizontalAlignment(alignment).

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

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

const range = sheet.getRange('B2:D2');
range.setHorizontalAlignments(horizontalAlignments);

Parameter

Name	Typ	Beschreibung
`alignments`	`Object[][]`	Ein zweidimensionales Array von Ausrichtungen, entweder `'left'`, `'center'` oder `'normal'`. Ein `null`-Wert setzt die Ausrichtung zurück.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Weitere Informationen

setHorizontalAlignment(alignment)

`setNote(note)`

Legt die Notiz auf den angegebenen Wert fest.

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

const cell = sheet.getRange('B2');
cell.setNote('This is a note');

Parameter

Name	Typ	Beschreibung
`note`	`String`	Der Notenwert, der für den Bereich festgelegt werden soll. Mit dem Wert `null` wird die Notiz entfernt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setNotes(notes)`

Legt ein rechteckiges Notengitter fest (muss mit den Dimensionen dieses Bereichs übereinstimmen).

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

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

const cell = sheet.getRange('B2:D3');
cell.setNotes(notes);

Parameter

Name	Typ	Beschreibung
`notes`	`Object[][]`	Ein zweidimensionales Array von Notizen. Mit `null`-Werten wird die Notiz entfernt.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Weitere Informationen

setNote(note)

`setNumberFormat(numberFormat)`

Legt das Zahlen- oder Datumsformat auf den angegebenen Formatierungsstring fest. Die akzeptierten Formatmuster sind in der Sheets API-Dokumentation beschrieben.

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

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

Parameter

Name	Typ	Beschreibung
`numberFormat`	`String`	Ein Zahlenformatstring.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setNumberFormats(numberFormats)`

Legt ein rechteckiges Raster mit Zahlen- oder Datumsformaten fest, die mit den Dimensionen dieses Bereichs übereinstimmen müssen. Die Werte sind Formatmuster-Strings, wie in der Sheets API-Dokumentation beschrieben.

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

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

const range = sheet.getRange('B2:D2');
range.setNumberFormats(formats);

Parameter

Name	Typ	Beschreibung
`numberFormats`	`Object[][]`	Ein zweidimensionales Array mit Zahlenformaten.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const richText = SpreadsheetApp.newRichTextValue()
                     .setText('Hello world')
                     .setTextStyle(0, 5, bold)
                     .build();
range.setRichTextValue(richText);

Parameter

Name	Typ	Beschreibung
`value`	`RichTextValue`	Der gewünschte Rich-Text-Wert.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:A2');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const italic = SpreadsheetApp.newTextStyle().setItalic(true).build();
const richTextA1 = SpreadsheetApp.newRichTextValue()
                       .setText('This cell is bold')
                       .setTextStyle(bold)
                       .build();
const richTextA2 = SpreadsheetApp.newRichTextValue()
                       .setText('bold words, italic words')
                       .setTextStyle(0, 11, bold)
                       .setTextStyle(12, 24, italic)
                       .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

Parameter

Name	Typ	Beschreibung
`values`	`RichTextValue[][]`	Die gewünschten Rich-Text-Werte.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setShowHyperlink(showHyperlink)`

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

Name	Typ	Beschreibung
`showHyperlink`	`Boolean`	Gibt an, ob der Hyperlink angezeigt werden soll.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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 die angegebene Richtung null ist, wird die Richtung abgeleitet und dann festgelegt.

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

Parameter

Name	Typ	Beschreibung
`direction`	`TextDirection`	Die gewünschte Textrichtung. Wenn `null`, wird die Richtung vor dem Festlegen abgeleitet.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setTextDirections(directions)`

Legt ein rechteckiges Raster mit Textrichtungen fest. Wenn die 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.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setTextRotations(range1.getTextDirections());

Parameter

Name	Typ	Beschreibung
`directions`	`TextDirection[][]`	Die gewünschten Textrichtungen. Wenn eine angegebene Richtung `null` ist, wird sie vor dem Festlegen abgeleitet.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setTextRotation(degrees)`

Legt die Einstellungen für die Textrotation für die Zellen im Bereich fest. Die Eingabe entspricht dem Winkel zwischen der Standardtextausrichtung und der gewünschten Ausrichtung. Bei einer Eingabe von null wird der Text in der Standardausrichtung angezeigt.

Bei einer Textrichtung von links nach rechts sind positive Winkel gegen den Uhrzeigersinn, bei einer Textrichtung von rechts nach links im Uhrzeigersinn.

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

range.setTextRotation(45);

Parameter

Name	Typ	Beschreibung
`degrees`	`Integer`	Der gewünschte Winkel zwischen der Standardausrichtung und der gewünschten Ausrichtung. Bei rechtsläufigem Text werden positive Winkel gegen den Uhrzeigersinn gemessen.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setTextRotation(rotation)`

Legt die Einstellungen für die Textrotation 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.
const sheet = SpreadsheetApp.getActiveSheet();

const rotation = sheet.getRange('A1').getTextRotation();

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

Parameter

Name	Typ	Beschreibung
`rotation`	`TextRotation`	Die gewünschten Einstellungen für die Textrotation.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setTextRotations(range1.getTextRotations());

Parameter

Name	Typ	Beschreibung
`rotations`	`TextRotation[][]`	Die gewünschten Einstellungen für die Textrotation.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('C5:D6');
const style =
    SpreadsheetApp.newTextStyle().setFontSize(15).setUnderline(true).build();
range.setTextStyle(style);

Parameter

Name	Typ	Beschreibung
`style`	`TextStyle`	Der gewünschte Textstil.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setTextStyles(styles)`

Legt ein rechteckiges Raster mit Textformatierungen fest.

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

Parameter

Name	Typ	Beschreibung
`styles`	`TextStyle[][]`	Die gewünschten Textstile.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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, ein String, ein boolescher Wert oder ein Datum sein. Wenn es mit '=' beginnt, wird es als Formel interpretiert.

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

const cell = sheet.getRange('B2');
cell.setValue(100);

Parameter

Name	Typ	Beschreibung
`value`	`Object`	Der Wert für den Bereich.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setValues(values)`

Legt ein rechteckiges Raster mit Werten fest, das mit den Dimensionen dieses Bereichs übereinstimmen muss. Wenn ein Wert mit = beginnt, wird er als Formel interpretiert.

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

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

const range = sheet.getRange('B2:D2');
range.setValues(values);

Parameter

Name	Typ	Beschreibung
`values`	`Object[][]`	Ein zweidimensionales Array von Werten.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setVerticalAlignment(alignment)`

Legt die vertikale Ausrichtung (von oben nach unten) für den angegebenen Bereich fest (oben/Mitte/unten).

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

const cell = sheet.getRange('B2');
cell.setVerticalAlignment('middle');

Parameter

Name	Typ	Beschreibung
`alignment`	`String`	Die Ausrichtung, entweder `'top'`, `'middle'` oder `'bottom'`. Ein `null`-Wert setzt die Ausrichtung zurück.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setVerticalAlignments(alignments)`

Legt ein rechteckiges Raster mit vertikalen Ausrichtungen fest, das den Abmessungen dieses Bereichs entsprechen muss.

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

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

const range = sheet.getRange('B2:D2');
range.setVerticalAlignments(alignments);

Parameter

Name	Typ	Beschreibung
`alignments`	`Object[][]`	Ein zweidimensionales Array von Ausrichtungen, entweder `'top'`, `'middle'` oder `'bottom'`. Ein `null`-Wert setzt die Ausrichtung zurück.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Weitere Informationen

setVerticalAlignment(alignment)

`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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setVerticalText(true);

Parameter

Name	Typ	Beschreibung
`isVertical`	`Boolean`	Gibt an, ob der Text gestapelt werden soll.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setWrap(isWrapEnabled)`

Legen Sie den Zeilenumbruch für den angegebenen Bereich fest.

Zellen, für die der Umbruch aktiviert ist (Standardeinstellung), werden so angepasst, dass ihr gesamter Inhalt angezeigt wird. In Zellen, in denen der Zeilenumbruch deaktiviert ist, wird so viel wie möglich in der Zelle angezeigt, ohne dass die Größe angepasst oder der Text in mehrere Zeilen aufgeteilt wird.

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

const cell = sheet.getRange('B2');
cell.setWrap(true);

Parameter

Name	Typ	Beschreibung
`isWrapEnabled`	`Boolean`	Gibt an, ob ein Zeilenumbruch erfolgen soll.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setWrapStrategies(strategies)`

Legt ein rechteckiges Raster von Umbruchstrategien fest.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setWrapStrategies(range1.getWrapStrategies());

Parameter

Name	Typ	Beschreibung
`strategies`	`WrapStrategy[][]`	Die gewünschten Umbruchstrategien.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setWrapStrategy(strategy)`

Legt die Strategie für den Zeilenumbruch für die Zellen im Bereich fest.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parameter

Name	Typ	Beschreibung
`strategy`	`WrapStrategy`	Die gewünschte Umbruchstrategie.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`setWraps(isWrapEnabled)`

Legt ein rechteckiges Raster von Zeilenumbruchrichtlinien fest, das mit den Dimensionen dieses Bereichs übereinstimmen muss. Zellen mit aktiviertem Umbruch (Standardeinstellung) werden so angepasst, dass ihr gesamter Inhalt angezeigt wird. In Zellen, in denen der Zeilenumbruch deaktiviert ist, wird so viel wie möglich angezeigt, ohne dass die Größe angepasst oder der Text in mehrere Zeilen umgebrochen wird.

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

// The size of the two-dimensional array must match the size of the range.
const wraps = [[true, true, false]];

const range = sheet.getRange('B2:D2');
range.setWraps(wraps);

Parameter

Name	Typ	Beschreibung
`isWrapEnabled`	`Object[][]`	Ein zweidimensionales Array von Umbruchvariablen, mit denen festgelegt wird, ob Text in einer Zelle umgebrochen werden soll oder nicht.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Weitere Informationen

setWrap(isWrapEnabled)

`shiftColumnGroupDepth(delta)`

Ändert die Tiefe der Spaltengruppierung des Bereichs um den angegebenen Betrag.

Dadurch werden Gruppen erstellt, geändert oder gelöscht, die sich mit dem Bereich überschneiden. Bei positiven Deltas werden Gruppen erstellt und/oder geändert. Bei negativen Deltas werden Gruppen gelöscht und/oder geändert.

Das hat keine Auswirkungen, wenn die Gruppierungstiefe unter null oder über acht verringert wird.

Wenn column group control position gleich BEFORE ist, wird ein Fehler ausgegeben, wenn Sie versuchen, die Tiefe der ersten Zeile zu ändern.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const 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

Name	Typ	Beschreibung
`delta`	`Integer`	Der Betrag, um den die Tiefe der Spaltengruppe dieses Bereichs geändert werden soll.

Rückflug

Range – Dieser Bereich zur Verkettung.

Löst

Error: beim Versuch, die Tiefe der ersten Spalte zu ändern, wenn die Kontrollposition GroupControlTogglePosition.BEFORE ist

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.

Das hat keine Auswirkungen, wenn die Gruppierungstiefe unter null oder über acht verringert wird.

Wenn row group control position gleich BEFORE ist, wird ein Fehler ausgegeben, wenn versucht wird, die Tiefe der ersten Zeile zu verschieben.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const 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

Name	Typ	Beschreibung
`delta`	`Integer`	Der Betrag, um den die Tiefe der Zeilengruppe dieses Bereichs geändert werden soll.

Rückflug

Range – Dieser Bereich zur Verkettung.

Löst

Error: beim Versuch, die Tiefe der ersten Zeile zu verschieben, wenn die Steuerposition GroupControlTogglePosition.BEFORE ist

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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

Name	Typ	Beschreibung
`sortSpecObj`	`Object`	Die Spalten, nach denen sortiert werden soll.

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns();

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`splitTextToColumns(delimiter)`

Teilt eine Textspalte anhand 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|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns('#');

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parameter

Name	Typ	Beschreibung
`delimiter`	`String`	Das benutzerdefinierte Trennzeichen, das zum Aufteilen verwendet werden soll.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`splitTextToColumns(delimiter)`

Teilt eine Textspalte anhand des angegebenen 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|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after splitting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parameter

Name	Typ	Beschreibung
`delimiter`	`TextToColumnsDelimiter`	Das voreingestellte Trennzeichen, das zum Aufteilen verwendet werden soll.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`trimWhitespace()`

Entfernt die Leerräume (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) in jeder Zelle in diesem Bereich. Entfernt alle Leerzeichen am Anfang und Ende des Texts jeder Zelle und reduziert jede Folge von verbleibenden Leerzeichen auf ein einzelnes Leerzeichen.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:A4');
range.activate();
range.setValues([
  ' preceding space',
  'following space ',
  'two  middle  spaces',
  '   =SUM(1,2)',
]);

range.trimWhitespace();

const values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces',
// '=SUM(1,2)']

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`uncheck()`

Ändert den Status der Kästchen im Bereich in „nicht ausgewählt“. Zellen im Bereich, die derzeit weder den konfigurierten Wert für „ausgewählt“ noch den für „nicht ausgewählt“ 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'.
const range = SpreadsheetApp.getActive().getRange('A1:B10');
range.uncheck();

Rückflug

Range – Dieser Bereich zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Eingestellte Methoden

`getFontColor()`

Veraltet. Ersetzt durch getFontColorObject()

Gibt die Schriftfarbe der Zelle in der oberen linken Ecke des Bereichs in CSS-Notation zurück (z. B. '#ffffff' oder 'white').

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

Logger.log(range.getFontColor());

Rückflug

String: Die Schriftfarbe in CSS-Notation (z. B. '#ffffff' oder 'white').

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

`getFontColors()`

Veraltet. Ersetzt durch getFontColorObjects()

Gibt die Schriftfarben der Zellen im Bereich in CSS-Notation zurück (z. B. '#ffffff' oder 'white').

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

const results = range.getFontColors();

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

Rückflug

String[][]: Ein zweidimensionales Array mit Schriftfarben, die den Zellen im Bereich zugeordnet sind.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Class Range Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Methoden

Eingestellte Methoden

Detaillierte Dokumentation

activate()

Rückflug

activateAsCurrentCell()

Rückflug

Autorisierung

addDeveloperMetadata(key)

Parameter

Rückflug

Autorisierung

addDeveloperMetadata(key, visibility)

Parameter

Rückflug

Autorisierung

addDeveloperMetadata(key, value)

Parameter

Rückflug

Autorisierung

addDeveloperMetadata(key, value, visibility)

Parameter

Rückflug

Autorisierung

applyColumnBanding()

Rückflug

Autorisierung

applyColumnBanding(bandingTheme)

Parameter

Rückflug

Autorisierung

applyColumnBanding(bandingTheme, showHeader, showFooter)

Parameter

Rückflug

Autorisierung

applyRowBanding()

Rückflug

Autorisierung

applyRowBanding(bandingTheme)

Parameter

Rückflug

Autorisierung

applyRowBanding(bandingTheme, showHeader, showFooter)

Parameter

Rückflug

Autorisierung

autoFill(destination, series)

Parameter

Autorisierung

autoFillToNeighbor(series)

Parameter

Autorisierung

breakApart()

Rückflug

Autorisierung

canEdit()

Rückflug

Autorisierung

check()

Rückflug

Autorisierung

clear()

Rückflug

Autorisierung

clear(options)

Parameter

Erweiterte Parameter

Rückflug

Autorisierung

clearContent()

Rückflug

Autorisierung

clearDataValidations()

Rückflug

Autorisierung

clearFormat()

Rückflug

Autorisierung

clearNote()

Class Range

`activate()`

`activateAsCurrentCell()`

`addDeveloperMetadata(key)`

`addDeveloperMetadata(key, visibility)`

`addDeveloperMetadata(key, value)`

`addDeveloperMetadata(key, value, visibility)`

`applyColumnBanding()`

`applyColumnBanding(bandingTheme)`

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

`applyRowBanding()`

`applyRowBanding(bandingTheme)`

`applyRowBanding(bandingTheme, showHeader, showFooter)`

`autoFill(destination, series)`

`autoFillToNeighbor(series)`

`breakApart()`

`canEdit()`

`check()`

`clear()`

`clear(options)`

`clearContent()`

`clearDataValidations()`

`clearFormat()`

`clearNote()`

`collapseGroups()`

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

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

`copyTo(destination)`

`copyTo(destination, copyPasteType, transposed)`

`copyTo(destination, options)`

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

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

`createDataSourcePivotTable(dataSource)`

`createDataSourceTable(dataSource)`

`createDeveloperMetadataFinder()`

`createFilter()`

`createPivotTable(sourceData)`

`createTextFinder(findText)`

`deleteCells(shiftDimension)`

`expandGroups()`

`getA1Notation()`

`getBackground()`

`getBackgroundObject()`

`getBackgroundObjects()`

`getBackgrounds()`