Diese Seite wurde von der Cloud Translation API übersetzt.

Class Range

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

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`activate()`	`Range`	Legt den angegebenen Bereich als `active range` fest, wobei die linke obere Zelle im Bereich als `current cell` festgelegt wird.
`activateAsCurrentCell()`	`Range`	Die angegebene Zelle wird als `current cell` festgelegt.
`addDeveloperMetadata(key)`	`Range`	Dem Bereich werden Entwicklermetadaten mit dem angegebenen Schlüssel hinzugefügt.
`addDeveloperMetadata(key, visibility)`	`Range`	Dem Bereich werden Entwicklermetadaten mit dem angegebenen Schlüssel und der angegebenen Sichtbarkeit hinzugefügt.
`addDeveloperMetadata(key, value)`	`Range`	Dem Bereich werden Entwicklermetadaten mit dem angegebenen Schlüssel und Wert hinzugefügt.
`addDeveloperMetadata(key, value, visibility)`	`Range`	Dem Bereich werden Entwicklermetadaten mit dem angegebenen Schlüssel, Wert und der Sichtbarkeit hinzugefügt.
`applyColumnBanding()`	`Banding`	Wählt ein Standarddesign für die Spaltenbänder für den Bereich aus.
`applyColumnBanding(bandingTheme)`	`Banding`	Wendet ein angegebenes Spaltenbänderungs-Design auf den Bereich an.
`applyColumnBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Wendet ein angegebenes Spaltenbänder-Design mit den angegebenen Kopf- und Fußzeileneinstellungen auf den Bereich an.
`applyRowBanding()`	`Banding`	Wendet ein Standard-Zeilenstreifen-Design auf den Bereich an.
`applyRowBanding(bandingTheme)`	`Banding`	Wendet ein angegebenes Thema für Zeilenstreifen auf den Bereich an.
`applyRowBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Wendet ein bestimmtes Zeilenraster-Design mit den angegebenen Kopf- und Fußzeileneinstellungen auf den Bereich an.
`autoFill(destination, series)`	`void`	Fügt `destinationRange` Daten hinzu, die auf den Daten in diesem Bereich basieren.
`autoFillToNeighbor(series)`	`void`	Berechnet einen Bereich, der anhand benachbarter Zellen mit neuen Daten gefüllt werden soll, und füllt diesen Bereich automatisch mit neuen Werten anhand der Daten in diesem Bereich.
`breakApart()`	`Range`	Zellen mit mehreren Spalten im Bereich werden wieder in einzelne Zellen aufgeteilt.
`canEdit()`	`Boolean`	Bestimmt, ob der Nutzer berechtigt ist, jede Zelle im Bereich zu bearbeiten.
`check()`	`Range`	Der Status der Kästchen im Bereich wird in „angeklickt“ geändert.
`clear()`	`Range`	Der Bereich für Inhalte und Formate wird gelöscht.
`clear(options)`	`Range`	Löscht den Inhaltsbereich, das Format, die Datenvalidierungsregeln und/oder Kommentare, die mit den erweiterten Optionen angegeben wurden.
`clearContent()`	`Range`	Der Inhalt des Bereichs wird gelöscht, die Formatierung bleibt erhalten.
`clearDataValidations()`	`Range`	Die Regeln für die Datenvalidierung für den Bereich werden gelöscht.
`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`	Alle Gruppen, die vollständig im Bereich enthalten sind, werden minimiert.
`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Die Formatierung des Bereichs an den angegebenen Speicherort kopieren
`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Die Formatierung des Bereichs an den angegebenen Speicherort kopieren
`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`	Der Inhalt des Bereichs wird an den angegebenen Speicherort kopiert.
`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Der Inhalt des Bereichs wird an den angegebenen Speicherort kopiert.
`createDataSourcePivotTable(dataSource)`	`DataSourcePivotTable`	Hiermit wird eine leere Pivot-Tabelle der Datenquelle erstellt, die an der ersten Zelle dieses Bereichs verankert ist.
`createDataSourceTable(dataSource)`	`DataSourceTable`	Erstellt eine leere Datenquellentabelle aus der Datenquelle, die an der ersten Zelle dieses Bereichs verankert ist.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Gibt eine DeveloperMetadataFinderApi zurück, um Entwicklermetadaten innerhalb dieses Bereichs zu finden.
`createFilter()`	`Filter`	Erstellt einen Filter und wendet ihn auf den angegebenen Bereich auf dem Tabellenblatt an.
`createPivotTable(sourceData)`	`PivotTable`	Erstellt eine leere Pivot-Tabelle aus dem an der ersten Zelle dieses Bereichs verankerten `sourceData`.
`createTextFinder(findText)`	`TextFinder`	Erstellt einen Textsuchmechanismus für den Bereich, mit dem Text in diesem Bereich gefunden 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 übereinstimmt.
`getA1Notation()`	`String`	Gibt eine Stringbeschreibung des Bereichs in A1-Notation zurück.
`getBackground()`	`String`	Gibt die Hintergrundfarbe der oberen linken Zelle im Bereich zurück (z. B. `'#ffffff'`).
`getBackgroundObject()`	`Color`	Gibt die Hintergrundfarbe der oberen linken Zelle im Bereich zurück.
`getBackgroundObjects()`	`Color[][]`	Gibt die Hintergrundfarben der Zellen im Bereich zurück.
`getBackgrounds()`	`String[][]`	Gibt die Hintergrundfarben der Zellen im Bereich zurück (z. B. `'#ffffff'`).
`getBandings()`	`Banding[]`	Gibt alle Farbbänder zurück, die auf Zellen in diesem Bereich angewendet werden.
`getCell(row, column)`	`Range`	Gibt eine bestimmte Zelle innerhalb eines Bereichs zurück.
`getColumn()`	`Integer`	Gibt die Startposition der Spalte 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 benachbarten Zellen mit Daten zu umfassen.
`getDataRegion(dimension)`	`Range`	Gibt eine Kopie des Bereichs zurück, der mit `Direction.UP` und `Direction.DOWN` erweitert wurde, wenn die angegebene Dimension `Dimension.ROWS` ist, oder mit `Direction.NEXT` und `Direction.PREVIOUS`, wenn die Dimension `Dimension.COLUMNS` ist.
`getDataSourceFormula()`	`DataSourceFormula`	Gibt den Wert `DataSourceFormula` für die erste Zelle im Bereich zurück oder `null`, wenn die Zelle keine Datenquellenformel enthält.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Gibt die `DataSourceFormula` für die Zellen im Bereich zurück.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Hiermit werden alle Pivot-Tabellen der Datenquelle abgerufen, die sich mit dem Bereich überschneiden.
`getDataSourceTables()`	`DataSourceTable[]`	Hiermit werden alle Tabellen als Datenquellen zurückgegeben, 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 Datenvalidierungsregel für die Zelle links oben 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 linken oberen Zelle im Bereich zurück.
`getDisplayValues()`	`String[][]`	Gibt das rechteckige Raster mit Werten für diesen Bereich zurück.
`getFilter()`	`Filter`	Gibt den Filter auf dem Tabellenblatt zurück, zu dem dieser Bereich gehört, oder `null`, wenn auf dem Tabellenblatt kein Filter vorhanden ist.
`getFontColorObject()`	`Color`	Gibt die Schriftfarbe der Zelle oben links im Bereich 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 oben links im Bereich zurück.
`getFontLine()`	`String`	Gibt die Linienart der Zelle in der oberen linken Ecke des Bereichs zurück (`'underline'`, `'line-through'` oder `'none'`).
`getFontLines()`	`String[][]`	Gibt die Linienart der Zellen im Bereich zurück (`'underline'`, `'line-through'` oder `'none'`).
`getFontSize()`	`Integer`	Gibt die Schriftgröße in Punktgröße der Zelle oben links im Bereich zurück.
`getFontSizes()`	`Integer[][]`	Gibt die Schriftgrößen der Zellen im Bereich zurück.
`getFontStyle()`	`String`	Gibt den Schriftstil (`'italic'` oder `'normal'`) der Zelle links oben im Bereich zurück.
`getFontStyles()`	`String[][]`	Gibt die Schriftstile der Zellen im Bereich zurück.
`getFontWeight()`	`String`	Gibt das Schriftgewicht (normal/fett) der Zelle oben links im Bereich zurück.
`getFontWeights()`	`String[][]`	Gibt die Schriftschnitte der Zellen im Bereich zurück.
`getFormula()`	`String`	Gibt die Formel (A1-Notation) für die linke obere Zelle des Bereichs 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 Textausrichtung (links/Mitte/rechts) der Zelle oben links im Bereich zurück.
`getHorizontalAlignments()`	`String[][]`	Gibt die horizontale Ausrichtung der Zellen im Bereich zurück.
`getLastColumn()`	`Integer`	Gibt die Endposition der Spalte zurück.
`getLastRow()`	`Integer`	Gibt die Endzeilenposition 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`	Beginnend bei der Zelle in der ersten Spalte und Zeile des Bereichs wird die nächste Zelle in der angegebenen Richtung zurückgegeben, die sich am Rand eines zusammenhängenden Zellenbereichs mit Daten oder am Rand der Tabelle in dieser Richtung befindet.
`getNote()`	`String`	Gibt den mit dem angegebenen Bereich verknüpften Hinweis zurück.
`getNotes()`	`String[][]`	Gibt die Notizen zurück, die mit den Zellen im Bereich verknüpft 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`	Die Zahlen- oder Datumsformatierung der Zelle links oben im angegebenen Bereich abrufen.
`getNumberFormats()`	`String[][]`	Gibt die Zahlen- oder Datumsformate für die Zellen im Bereich zurück.
`getRichTextValue()`	`RichTextValue`	Gibt den Wert im Rich-Text-Format für die linke obere Zelle des Bereichs zurück oder `null`, wenn der Zellenwert kein Text ist.
`getRichTextValues()`	`RichTextValue[][]`	Gibt die Werte im Rich-Text-Format 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 linke obere Zelle des Bereichs zurück.
`getTextDirections()`	`TextDirection[][]`	Gibt die Textrichtungen für die Zellen im Bereich zurück.
`getTextRotation()`	`TextRotation`	Gibt die Einstellungen für die Textdrehung für die linke obere Zelle des Bereichs zurück.
`getTextRotations()`	`TextRotation[][]`	Gibt die Einstellungen für die Textdrehung für die Zellen im Bereich zurück.
`getTextStyle()`	`TextStyle`	Gibt den Textstil der oberen linken Zelle des Bereichs zurück.
`getTextStyles()`	`TextStyle[][]`	Gibt die Textstile für die Zellen im Bereich zurück.
`getValue()`	`Object`	Gibt den Wert der linken oberen Zelle im Bereich zurück.
`getValues()`	`Object[][]`	Gibt das rechteckige Raster mit Werten für diesen Bereich zurück.
`getVerticalAlignment()`	`String`	Gibt die vertikale Ausrichtung (oben/Mitte/unten) der Zelle oben links im Bereich zurück.
`getVerticalAlignments()`	`String[][]`	Gibt die vertikale Ausrichtung 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 Textumbruchstrategien für die Zellen im Bereich zurück.
`getWrapStrategy()`	`WrapStrategy`	Gibt die Textumbruchstrategie für die linke obere Zelle des Bereichs zurück.
`getWraps()`	`Boolean[][]`	Gibt zurück, ob der Text in den Zellen umgebrochen wird.
`insertCells(shiftDimension)`	`Range`	Fügt in diesen Bereich leere Zellen ein.
`insertCheckboxes()`	`Range`	Es werden Kästchen in jede Zelle im Bereich eingefügt, die mit `true` für angeklickt und `false` für nicht angeklickt konfiguriert sind.
`insertCheckboxes(checkedValue)`	`Range`	Setzt in jede Zelle im Bereich Kä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`	In jede Zelle im Bereich werden Kästchen eingefügt, die mit benutzerdefinierten Werten für den angeklickten und den nicht angeklickten Status konfiguriert sind.
`isBlank()`	`Boolean`	Gibt `true` zurück, wenn der Bereich vollständig leer ist.
`isChecked()`	`Boolean`	Gibt zurück, ob für alle Zellen im Bereich der Kästchenstatus „angeklickt“ ist.
`isEndColumnBounded()`	`Boolean`	Bestimmt, ob das Ende des Bereichs an eine bestimmte Spalte gebunden ist.
`isEndRowBounded()`	`Boolean`	Bestimmt, ob das Ende des Bereichs an eine bestimmte Zeile gebunden ist.
`isPartOfMerge()`	`Boolean`	Gibt `true` zurück, wenn die Zellen im aktuellen Bereich mit zusammengeführten Zellen überlappen.
`isStartColumnBounded()`	`Boolean`	Bestimmt, ob der Beginn des Bereichs an eine bestimmte Spalte gebunden ist.
`isStartRowBounded()`	`Boolean`	Bestimmt, ob der Beginn des Bereichs an eine bestimmte Zeile gebunden ist.
`merge()`	`Range`	Die Zellen im Bereich werden zu einem einzigen Block zusammengeführt.
`mergeAcross()`	`Range`	Die Zellen im Bereich werden über die Spalten des Bereichs zusammengeführt.
`mergeVertically()`	`Range`	Die Zellen im Bereich werden zusammengeführt.
`moveTo(target)`	`void`	Schneiden Sie den Bereich aus und fügen Sie ihn (sowohl Format als auch Werte) in den Zielbereich ein.
`offset(rowOffset, columnOffset)`	`Range`	Gibt einen neuen Bereich zurück, der um die angegebene Anzahl von Zeilen und Spalten (kann negativ sein) von diesem Bereich versetzt ist.
`offset(rowOffset, columnOffset, numRows)`	`Range`	Gibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist, dessen linker oberer Punkt um die angegebenen Zeilen und Spalten vom aktuellen Bereich versetzt ist und die angegebene Zellenhöhe hat.
`offset(rowOffset, columnOffset, numRows, numColumns)`	`Range`	Gibt einen neuen Bereich zurück, der relativ zum aktuellen Bereich ist, dessen linker oberer Punkt um die angegebenen Zeilen und Spalten vom aktuellen Bereich versetzt ist und die angegebene Höhe und Breite in Zellen hat.
`protect()`	`Protection`	Erstellt ein Objekt, mit dem der Bereich vor Bearbeitung geschützt werden kann, mit Ausnahme von Nutzern mit Berechtigung.
`randomize()`	`Range`	Die Reihenfolge der Zeilen im angegebenen Bereich wird zufällig.
`removeCheckboxes()`	`Range`	Entfernt alle Kästchen aus dem Bereich.
`removeDuplicates()`	`Range`	Entfernt Zeilen in diesem Bereich, die Werte enthalten, die mit Werten in einer vorherigen Zeile identisch sind.
`removeDuplicates(columnsToCompare)`	`Range`	Entfernt Zeilen in diesem Bereich, die Werte in den angegebenen Spalten enthalten, die mit den Werten einer vorherigen Zeile identisch sind.
`setBackground(color)`	`Range`	Legt die Hintergrundfarbe aller Zellen im Bereich in CSS-Notation fest (z. B. `'#ffffff'` oder `'white'`).
`setBackgroundObject(color)`	`Range`	Hiermit wird die Hintergrundfarbe aller Zellen im Bereich festgelegt.
`setBackgroundObjects(color)`	`Range`	Hiermit wird ein rechteckiges Raster mit Hintergrundfarben festgelegt. Die Abmessungen müssen mit denen des Bereichs übereinstimmen.
`setBackgroundRGB(red, green, blue)`	`Range`	Hiermit wird der Hintergrund mithilfe von RGB-Werten (Ganzzahlen zwischen 0 und 255) auf die angegebene Farbe festgelegt.
`setBackgrounds(color)`	`Range`	Hiermit wird ein rechteckiges Raster mit Hintergrundfarben festgelegt. Die Abmessungen müssen mit denen des Bereichs übereinstimmen.
`setBorder(top, left, bottom, right, vertical, horizontal)`	`Range`	Legt die Rahmeneigenschaft fest.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`Range`	Legt die Rahmeneigenschaft mit Farbe und/oder Stil fest.
`setDataValidation(rule)`	`Range`	Hiermit wird eine Datenvalidierungsregel für alle Zellen im Bereich festgelegt.
`setDataValidations(rules)`	`Range`	Legt die Regeln für die Datenvalidierung für alle Zellen im Bereich fest.
`setFontColor(color)`	`Range`	Hiermit wird die Schriftfarbe in CSS-Notation (z. B. `'#ffffff'` oder `'white'`) festgelegt.
`setFontColorObject(color)`	`Range`	Legt die Schriftfarbe des angegebenen Bereichs fest.
`setFontColorObjects(colors)`	`Range`	Legt ein rechteckiges Raster mit Schriftfarben fest (muss den Abmessungen dieses Bereichs entsprechen).
`setFontColors(colors)`	`Range`	Legt ein rechteckiges Raster mit Schriftfarben fest (muss den Abmessungen dieses Bereichs entsprechen).
`setFontFamilies(fontFamilies)`	`Range`	Hiermit wird ein rechteckiges Raster mit Schriftfamilien festgelegt. Die Abmessungen müssen mit den Abmessungen dieses Bereichs übereinstimmen.
`setFontFamily(fontFamily)`	`Range`	Hiermit wird die Schriftfamilie festgelegt, z. B. „Arial“ oder „Helvetica“.
`setFontLine(fontLine)`	`Range`	Legt den Schriftschnitt des Bereichs fest (`'underline'`, `'line-through'` oder `'none'`).
`setFontLines(fontLines)`	`Range`	Legt ein rechteckiges Raster mit Linienstilen fest (muss mit den Abmessungen dieses Bereichs übereinstimmen).
`setFontSize(size)`	`Range`	Hiermit wird die Schriftgröße festgelegt. Die Größe ist die zu verwendende Punktgröße.
`setFontSizes(sizes)`	`Range`	Hiermit wird ein rechteckiges Raster mit Schriftgrößen festgelegt. Die Schriftgrößen müssen mit den Abmessungen dieses Bereichs übereinstimmen.
`setFontStyle(fontStyle)`	`Range`	Legen Sie den Schriftstil für den angegebenen Bereich fest (`'italic'` oder `'normal'`).
`setFontStyles(fontStyles)`	`Range`	Hiermit wird ein rechteckiges Raster mit Schriftstilen festgelegt. Es muss den Abmessungen dieses Bereichs entsprechen.
`setFontWeight(fontWeight)`	`Range`	Legen Sie die Schriftstärke für den angegebenen Bereich fest (normal/fett).
`setFontWeights(fontWeights)`	`Range`	Hiermit wird ein rechteckiges Raster mit Schriftschnitten festgelegt. Es muss den Abmessungen dieses Bereichs entsprechen.
`setFormula(formula)`	`Range`	Aktualisiert die Formel für diesen Bereich.
`setFormulaR1C1(formula)`	`Range`	Aktualisiert die Formel für diesen Bereich.
`setFormulas(formulas)`	`Range`	Hiermit wird ein rechteckiges Raster mit Formeln festgelegt. Die Abmessungen müssen mit den Abmessungen dieses Bereichs übereinstimmen.
`setFormulasR1C1(formulas)`	`Range`	Hiermit wird ein rechteckiges Raster mit Formeln festgelegt. Die Abmessungen müssen mit den Abmessungen dieses Bereichs übereinstimmen.
`setHorizontalAlignment(alignment)`	`Range`	Legen Sie die horizontale Ausrichtung (von links nach rechts) für den angegebenen Bereich fest (links/Mitte/rechts).
`setHorizontalAlignments(alignments)`	`Range`	Legt ein rechteckiges Raster mit horizontalen Ausrichtungen fest.
`setNote(note)`	`Range`	Legt den Notizentext auf den angegebenen Wert fest.
`setNotes(notes)`	`Range`	Hiermit wird ein rechteckiges Notizen-Raster festgelegt, das den Abmessungen dieses Bereichs entsprechen muss.
`setNumberFormat(numberFormat)`	`Range`	Legt das Zahlen- oder Datumsformat auf den angegebenen Formatierungsstring fest.
`setNumberFormats(numberFormats)`	`Range`	Hiermit wird ein rechteckiges Raster mit Zahlen- oder Datumsformaten festgelegt. Es muss mit den Dimensionen dieses Bereichs übereinstimmen.
`setRichTextValue(value)`	`Range`	Legt den Rich-Text-Wert für die Zellen im Bereich fest.
`setRichTextValues(values)`	`Range`	Hiermit wird ein rechteckiges Raster mit Rich-Text-Werten festgelegt.
`setShowHyperlink(showHyperlink)`	`Range`	Hiermit wird festgelegt, ob im Bereich Hyperlinks angezeigt werden sollen.
`setTextDirection(direction)`	`Range`	Hiermit wird die Textrichtung für die Zellen im Bereich festgelegt.
`setTextDirections(directions)`	`Range`	Hiermit wird ein rechteckiges Raster mit Textrichtungen festgelegt.
`setTextRotation(degrees)`	`Range`	Hiermit werden die Einstellungen für die Textdrehung für die Zellen im Bereich festgelegt.
`setTextRotation(rotation)`	`Range`	Hiermit werden die Einstellungen für die Textdrehung für die Zellen im Bereich festgelegt.
`setTextRotations(rotations)`	`Range`	Hiermit wird ein rechteckiges Raster mit Textdrehungen festgelegt.
`setTextStyle(style)`	`Range`	Hiermit wird der Textstil für die Zellen im Bereich festgelegt.
`setTextStyles(styles)`	`Range`	Hiermit wird ein rechteckiges Raster mit Textstilen festgelegt.
`setValue(value)`	`Range`	Legt den Wert des Bereichs fest.
`setValues(values)`	`Range`	Hiermit wird ein rechteckiges Raster mit Werten festgelegt, das den Abmessungen dieses Bereichs entsprechen muss.
`setVerticalAlignment(alignment)`	`Range`	Legen Sie die vertikale Ausrichtung (von oben nach unten) für den angegebenen Bereich fest (oben/Mitte/unten).
`setVerticalAlignments(alignments)`	`Range`	Hiermit wird ein rechteckiges Raster mit vertikalen Ausrichtungen festgelegt. Es muss mit den Abmessungen dieses Bereichs übereinstimmen.
`setVerticalText(isVertical)`	`Range`	Legt fest, ob der Text für die Zellen im Bereich gestapelt werden soll.
`setWrap(isWrapEnabled)`	`Range`	Legen Sie die Zellumbruchfunktion für den angegebenen Bereich fest.
`setWrapStrategies(strategies)`	`Range`	Legt ein rechteckiges Raster mit Umbruchstrategien fest.
`setWrapStrategy(strategy)`	`Range`	Hiermit wird die Textumbruchstrategie für die Zellen im Bereich festgelegt.
`setWraps(isWrapEnabled)`	`Range`	Hiermit wird ein rechteckiges Raster mit Richtlinien für den Wortumbruch festgelegt. Es muss den Abmessungen dieses Bereichs entsprechen.
`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`	Hiermit werden die Leerzeichen (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) in jeder Zelle dieses Bereichs entfernt.
`uncheck()`	`Range`	Der Status der Kästchen im Bereich wird zu „Deaktiviert“ geändert.

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getFontColor()`	`String`	Gibt die Schriftfarbe der Zelle links oben im Bereich 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 linke obere Zelle im Bereich als current cell festgelegt wird.

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

Die angegebene Zelle wird als current cell festgelegt.

Wenn sich die angegebene Zelle in einem vorhandenen Bereich befindet, 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:Die 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, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`addDeveloperMetadata(key)`

Dem Bereich werden Entwicklermetadaten mit dem angegebenen Schlüssel hinzugefügt.

// 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, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`addDeveloperMetadata(key, visibility)`

Dem Bereich werden Entwicklermetadaten mit dem angegebenen Schlüssel und der angegebenen Sichtbarkeit hinzugefügt.

// 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`addDeveloperMetadata(key, value)`

Dem Bereich werden Entwicklermetadaten mit dem angegebenen Schlüssel und Wert hinzugefügt.

// 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, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`addDeveloperMetadata(key, value, visibility)`

Dem Bereich werden Entwicklermetadaten mit dem angegebenen Schlüssel, Wert und der Sichtbarkeit hinzugefügt.

// 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, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`applyColumnBanding()`

Wählt ein Standarddesign für die Spaltenbänder für den Bereich aus. Standardmäßig hat die Streifengrafik 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 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 – die neue Begrenzung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`applyColumnBanding(bandingTheme)`

Wendet ein angegebenes Spaltenbänderungs-Design auf den Bereich an. Standardmäßig hat das Streifenmuster 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 – die neue Begrenzung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

Wendet ein angegebenes Spaltenbänder-Design mit den angegebenen Kopf- und Fußzeileneinstellungen auf den Bereich 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 Farbband-Designs auf die erste Spalte angewendet.
`showFooter`	`Boolean`	Wenn `true`, wird die Fußzeilenfarbe des Farbbands auf die letzte Spalte angewendet.

Rückflug

Banding – die neue Begrenzung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`applyRowBanding()`

Wendet ein Standard-Zeilenstreifen-Design auf den Bereich an. Standardmäßig hat die Streifengrafik eine Kopfzeilenfarbe, 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 – Die Streifen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`applyRowBanding(bandingTheme)`

Wendet ein angegebenes Thema für Zeilenstreifen auf den Bereich an. Standardmäßig hat die Streifengrafik eine Kopfzeilenfarbe, 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 – die neue Begrenzung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`applyRowBanding(bandingTheme, showHeader, showFooter)`

Wendet ein bestimmtes Zeilenraster-Design mit den angegebenen Kopf- und Fußzeileneinstellungen auf den Bereich 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 Farbband-Designs auf die erste Zeile angewendet.
`showFooter`	`Boolean`	Wenn `true`, wird die Fußzeilenfarbe des Streifendesigns auf die letzte Zeile angewendet.

Rückflug

Banding – die neue Begrenzung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`autoFill(destination, series)`

Fügt destinationRange Daten hinzu, die auf den Daten in diesem Bereich basieren. Die neuen Werte werden ebenfalls vom angegebenen series-Typ bestimmt. Der Zielbereich muss diesen Bereich enthalten und ihn nur in eine Richtung erweitern. Mit dem folgenden Ausdruck wird A1:A20 beispielsweise mit einer Reihe von steigenden Zahlen auf Grundlage der aktuellen Werte 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 eine Richtung (nach oben, unten, links oder rechts) erweitern.
`series`	`AutoFillSeries`	Der Typ der automatischen Autofill-Reihe, der zum Berechnen neuer Werte verwendet werden soll. Die Auswirkungen dieser Reihe variieren je nach Art und Umfang der Quelldaten.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`autoFillToNeighbor(series)`

Berechnet einen Bereich, der anhand benachbarter Zellen mit neuen Daten gefüllt werden soll, und füllt diesen Bereich automatisch mit neuen Werten anhand der Daten in diesem Bereich. Diese neuen Werte werden auch vom angegebenen series-Typ bestimmt.

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

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

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 automatischen Autofill-Reihe, der zum Berechnen neuer Werte verwendet werden soll. Die Auswirkungen dieser Reihe variieren je nach Art und Umfang der Quelldaten.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`breakApart()`

Zellen mit mehreren Spalten im Bereich werden wieder in einzelne Zellen aufgeteilt.

Wenn Sie diese Funktion auf einen Bereich anwenden, ist das dasselbe, als würden Sie den Bereich auswählen und auf Format > Zellen verbinden > Verbindung aufheben klicken.

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

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

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

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

Rückflug

Range – Dieser Bereich, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`canEdit()`

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

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

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

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

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`check()`

Der Status der Kästchen im Bereich wird in „angeklickt“ geändert. Zellen im Bereich, die derzeit weder den konfigurierten angeklickten noch den konfigurierten nicht angeklickten Wert enthalten, werden ignoriert.

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

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`clear()`

Der Bereich für Inhalte und Formate wird gelöscht.

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`clear(options)`

Löscht den Inhaltsbereich, das Format, die Datenvalidierungsregeln und/oder Kommentare, die mit den erweiterten Optionen angegeben wurden. 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 die unten aufgeführten erweiterten Parameter angibt.

Erweiterte Parameter

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

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`clearContent()`

Der Inhalt des Bereichs wird gelöscht, die Formatierung bleibt erhalten.

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`clearDataValidations()`

Die Regeln für die Datenvalidierung für den Bereich werden gelöscht.

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

Rückflug

Range – Dieser Bereich, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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 gelöscht, aber 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`clearNote()`

Löscht die Notiz in der angegebenen Zelle oder 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`collapseGroups()`

Alle Gruppen, die vollständig im Bereich enthalten sind, werden minimiert. Wenn keine Gruppe vollständig im Bereich liegt, wird die am weitesten maximierte 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

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

Die Formatierung des Bereichs an den angegebenen Speicherort kopieren Wenn das Ziel größer oder kleiner als der Quellbereich ist, wird die Quelle entsprechend wiederholt oder gekürzt. Hinweis: 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 Tabellenblatts 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 Endzeile des Zielbereichs.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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`	Die Zieltabelle.
`column`	`Integer`	Die erste Spalte des Zielbereichs.
`columnEnd`	`Integer`	Die Endspalte des Zielbereichs.
`row`	`Integer`	Die Startzeile des Zielbereichs.
`rowEnd`	`Integer`	Die Endzeile des Zielbereichs.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`copyTo(destination)`

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

// The code below copies the first 5 columns over to the 6th column.
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`	Zielbereich, in den kopiert werden soll. Nur die Position der Zelle links oben ist relevant.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`copyTo(destination, copyPasteType, transposed)`

Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich.

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

Parameter

Name	Typ	Beschreibung
`destination`	`Range`	Zielbereich, in den kopiert werden soll; nur die Position der Zelle links oben ist relevant.
`copyPasteType`	`CopyPasteType`	Ein Typ, der angibt, wie der Inhalt des Bereichs 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`copyTo(destination, options)`

Kopiert die Daten aus einem Zellenbereich in einen anderen Zellenbereich. Standardmäßig werden sowohl die Werte als auch die Formatierung kopiert. Dies kann jedoch mithilfe erweiterter Argumente ü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`	Zielbereich, in den kopiert werden soll. Nur die Position der Zelle links oben ist relevant.
`options`	`Object`	Ein JavaScript-Objekt, das die unten aufgeführten erweiterten Parameter angibt.

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

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

Der Inhalt des Bereichs wird an den angegebenen Speicherort kopiert. Wenn das Ziel 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 Tabellenblatts 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 Endzeile des Zielbereichs.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

getGridId()

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

Der Inhalt des Bereichs wird an den angegebenen Speicherort kopiert. Wenn das Ziel 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`	Die Zieltabelle.
`column`	`Integer`	Die erste Spalte des Zielbereichs.
`columnEnd`	`Integer`	Die Endspalte des Zielbereichs.
`row`	`Integer`	Die Startzeile des Zielbereichs.
`rowEnd`	`Integer`	Die Endzeile des Zielbereichs.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`createDataSourcePivotTable(dataSource)`

Hiermit wird eine leere Pivot-Tabelle der Datenquelle erstellt, die an 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 Datenquellen-Pivot-Tabelle.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`createDataSourceTable(dataSource)`

Erstellt eine leere Datenquellentabelle aus der Datenquelle, die an der ersten Zelle 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`createDeveloperMetadataFinder()`

Gibt eine DeveloperMetadataFinderApi zurück, um Entwicklermetadaten innerhalb dieses Bereichs zu finden. Metadaten fallen nur dann in den Geltungsbereich des Bereichs, wenn sie vollständig darin enthalten sind. Metadaten, die mit der Zeile „3:3“ verknüpft 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 in diesem Bereich.

`createFilter()`

Erstellt einen Filter und wendet ihn auf den angegebenen Bereich auf dem Tabellenblatt an. Sie können in einem Tabellenblatt nur einen Filter erstellen. Wenn Sie nach dem Erstellen auf den 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-Listen erstellen, den Standardlistentyp. Tabellenblätter ohne Verbindung zu einer Datenbank. Informationen zum Erstellen anderer Filtertypen finden Sie unter den folgenden Links:

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

Rückflug

Filter – der neue Filter.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`createPivotTable(sourceData)`

Erstellt eine leere Pivot-Tabelle aus dem an der ersten Zelle dieses Bereichs verankerten sourceData.

// 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`createTextFinder(findText)`

Erstellt einen Textsuchmechanismus für den Bereich, mit dem Text in diesem Bereich gefunden 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: 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 derer vorhandene Daten verschoben werden sollen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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 übereinstimmt. Die Position der Ein/Aus-Schaltfläche ist der Index, an dem die Ein/Aus-Schaltfläche angezeigt wird, je nach Einstellungen direkt vor oder nach der Gruppe. Wenn sich an einem Ort mehrere Gruppen befinden, wird die am wenigsten verschachtelte Gruppe 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getBackground()`

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

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getBackgroundObject()`

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

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getBackgroundObjects()`

Gibt die Hintergrundfarben der Zellen im Bereich zurück.

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getBackgrounds()`

Gibt die Hintergrundfarben der Zellen im Bereich zurück (z. B. '#ffffff').

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 der Hintergründe.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getBandings()`

Gibt alle Farbbänder 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 Farbbänder, die auf Zellen in diesem Bereich angewendet werden.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getCell(row, column)`

Gibt eine bestimmte Zelle innerhalb eines Bereichs 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getColumn()`

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

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 Spaltenposition des Bereichs in der Tabelle.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getDataRegion()`

Gibt eine Kopie des Bereichs zurück, der in den vier Kardinalrichtungen Direction erweitert wurde, um alle benachbarten Zellen mit Daten zu umfassen. Wenn der Bereich von leeren Zellen umgeben ist, die nicht entlang der Diagonalen liegen, wird der Bereich selbst zurückgegeben. Das entspricht dem Auswählen des Bereichs und dem Tippen von Ctrl+A 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 "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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getDataRegion(dimension)`

Gibt eine Kopie des Bereichs zurück, der mit Direction.UP und Direction.DOWN erweitert wurde, wenn die angegebene Dimension Dimension.ROWS ist, oder mit 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 benachbarten Zellen mit Daten entlang der angegebenen Dimension, einschließlich der Tabellengrenzen. Wenn der ursprüngliche Bereich entlang der angegebenen Dimension von leeren Zellen umgeben ist, wird der Bereich selbst zurückgegeben. Diese Methode ähnelt der Auswahl des Bereichs und dem Tippen 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 derer der Bereich erweitert werden soll.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getDataSourceFormula()`

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

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

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

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

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

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

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

Rückflug

DataSourceFormula: Der DataSourceFormula für die Zelle.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getDataSourceFormulas()`

Gibt die DataSourceFormula 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getDataSourcePivotTables()`

Hiermit werden alle Pivot-Tabellen der Datenquelle abgerufen, 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[]: Liste der Pivot-Tabellen der Datenquelle.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getDataSourceTables()`

Hiermit werden alle Tabellen als Datenquellen zurückgegeben, 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[]: Liste der Tabellen der Datenquelle.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getDataSourceUrl()`

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

Code.gs

function doGet() {
  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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getDataTable()`

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

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

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

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

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

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

Rückflug

DataTable – die Daten als Tabelle.

`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`	Ob die erste Zeile als Überschrift behandelt werden soll.

Rückflug

DataTable – Die Daten als Tabelle.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getDataValidation()`

Gibt die Datenvalidierungsregel für die Zelle links oben 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 Datenvalidierungsregel für die Zelle links oben im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getDataValidations()`

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

// Change existing data validation rules that require a date in 2013 to require
// a date in 2014.
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 Regeln zur Datenvalidierung, die mit den Zellen im Bereich verknüpft sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getDeveloperMetadata()`

Ruft die mit diesem Bereich verknüpften Entwicklermetadaten ab.

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

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

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

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

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getDisplayValue()`

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

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

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

// Gets 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getDisplayValues()`

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

Gibt ein zweidimensionales Array der angezeigten Werte zurück, das nach Zeile und dann nach Spalte indexiert ist. 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 Gebietsschemaeinstellung der Tabelle angewendet werden. Leere Zellen werden im Array durch einen leeren String dargestellt. Denken Sie daran, dass ein Bereichsindex bei 1, 1 beginnt, das JavaScript-Array jedoch bei [0][0].

// The code below gets the displayed values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFilter()`

Gibt den Filter auf dem Tabellenblatt zurück, zu dem dieser Bereich gehört, oder null, wenn auf dem Tabellenblatt kein Filter 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFontColorObject()`

Gibt die Schriftfarbe der Zelle oben links im Bereich 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 linken oberen Zelle im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFontColorObjects()`

Gibt die Schriftfarben der Zellen im Bereich zurück.

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 von Schriftfarben, die den Zellen im Bereich zugeordnet sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFontFamilies()`

Gibt die Schriftfamilien der Zellen im Bereich zurück.

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 mit Zellen im Bereich verknüpft sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFontFamily()`

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

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

Logger.log(range.getFontFamily());

Rückflug

String: Schriftfamilie der Zelle.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFontLine()`

Gibt die Linienart der Zelle in der oberen linken Ecke des Bereichs zurück ('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: Schriftzeile.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFontLines()`

Gibt die Linienart der Zellen im Bereich zurück ('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 von Schriftlinien, die mit Zellen im Bereich verknüpft sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFontSize()`

Gibt die Schriftgröße in Punktgröße der Zelle oben links im Bereich zurück.

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

Logger.log(range.getFontSize());

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFontSizes()`

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

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 Schriftgrößen von Text, die mit Zellen im Bereich verknüpft sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFontStyle()`

Gibt den Schriftstil ('italic' oder 'normal') der Zelle links oben im Bereich 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFontStyles()`

Gibt die Schriftstile der Zellen im Bereich zurück.

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 von Schriftstilen für Text, die den Zellen im Bereich zugeordnet sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFontWeight()`

Gibt das Schriftgewicht (normal/fett) der Zelle oben links im Bereich 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFontWeights()`

Gibt die Schriftschnitte 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 Schriftschnitten von Text, die den Zellen im Bereich zugeordnet sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFormula()`

Gibt die Formel (A1-Notation) für die linke obere Zelle des Bereichs 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFormulaR1C1()`

Gibt die Formel (R1C1-Notation) für eine bestimmte Zelle zurück oder null, wenn keine 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFormulas()`

Gibt die Formeln (A1-Notation) für die Zellen im Bereich zurück. Einträge im 2D-Array sind leere 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getFormulasR1C1()`

Gibt die Formeln (R1C1-Notation) für die Zellen im Bereich zurück. Die 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 von Formeln in R1C1-Notation.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getGridId()`

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

// 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 Raster-ID des übergeordneten Tabellenblatts.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getHeight()`

Gibt die Höhe des Bereichs zurück.

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getHorizontalAlignment()`

Gibt die horizontale Textausrichtung (links/Mitte/rechts) der Zelle oben links im Bereich 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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 Textausrichtungen, die den Zellen im Bereich zugeordnet sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getLastColumn()`

Gibt die Endposition der Spalte 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 Endpunkts des Bereichs in der Tabelle.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getLastRow()`

Gibt die Endzeilenposition 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getMergedRanges()`

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

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 den Bereich überschneiden.

`getNextDataCell(direction)`

Beginnend bei der Zelle in der ersten Spalte und Zeile des Bereichs wird die nächste Zelle in der angegebenen Richtung zurückgegeben, die sich am Rand eines zusammenhängenden Zellenbereichs mit Daten oder am Rand der Tabelle in dieser Richtung befindet. Das entspricht dem Eintippen von Ctrl+[arrow key] in den 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 gefunden werden soll.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getNote()`

Gibt den mit dem angegebenen Bereich verknüpften Hinweis zurück.

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

Logger.log(range.getNote());

Rückflug

String: Der der angegebenen Zelle zugeordnete Hinweis.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getNotes()`

Gibt die Notizen zurück, die mit den Zellen im Bereich verknüpft 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 von Notizen, die mit Zellen im Bereich verknüpft sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getNumColumns()`

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

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getNumRows()`

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

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getNumberFormat()`

Die Zahlen- oder Datumsformatierung der Zelle links oben im angegebenen Bereich abrufen. Die zurückgegebenen Formatmuster werden in der API-Dokumentation für Google Tabellen 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 linken oberen Zelle des Bereichs.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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 Google Tabellen 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getRichTextValue()`

Gibt den Wert im Rich-Text-Format für die linke obere 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 Wert im Rich-Text-Format der linken oberen Zelle im Bereich oder null, wenn der Zellenwert kein Text ist.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getRichTextValues()`

Gibt die Werte im Rich-Text-Format 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getRow()`

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

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getRowIndex()`

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

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getTextDirection()`

Gibt die Textrichtung für die linke obere 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getTextDirections()`

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

// 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 von Textrichtungen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getTextRotation()`

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

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

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

Rückflug

TextRotation: Einstellungen für die Textdrehung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getTextRotations()`

Gibt die Einstellungen für die Textdrehung 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 von Textdrehungen, die mit Zellen im Bereich verknüpft sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getTextStyle()`

Gibt den Textstil der oberen linken 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 oberen linken Zelle im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getTextStyles()`

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

// Get the text styles for all cells in range B5:C6
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 Textstilen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getValue()`

Gibt den Wert der linken oberen Zelle im Bereich zurück. Der Wert kann vom Typ Number, Boolean, Date oder String sein, je nach Wert der Zelle. 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getValues()`

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

Gibt ein zweidimensionales Array von Werten zurück, das nach Zeile und dann nach Spalte indexiert ist. Die Werte können vom Typ Number, Boolean, Date oder String sein, je nach Wert der Zelle. Leere Zellen werden im Array durch einen leeren String dargestellt. Denken Sie daran, dass ein Bereichsindex bei 1, 1 beginnt, das JavaScript-Array jedoch bei [0][0].

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getVerticalAlignment()`

Gibt die vertikale Ausrichtung (oben/Mitte/unten) der Zelle oben links im Bereich 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getVerticalAlignments()`

Gibt die vertikale 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.getVerticalAlignments();

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getWidth()`

Gibt die Breite des Bereichs in Spalten zurück.

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

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

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

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

Rückflug

Integer – Die Anzahl der Spalten im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getWrap()`

Gibt zurück, ob der Text in der Zelle umgebrochen wird. Wenn du eine detailliertere Strategie für das Ende des Videos erhalten möchtest, verwende 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getWrapStrategies()`

Gibt die Textumbruchstrategien 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getWrapStrategy()`

Gibt die Textumbruchstrategie für die linke obere Zelle des Bereichs 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 Textumbruch der oberen linken Zelle im Bereich.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`getWraps()`

Gibt zurück, ob der Text in den Zellen umgebrochen wird. Wenn du eine detailliertere Strategie für die Textumbruch-Funktion erhalten möchtest, verwende 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 Textausrichtungen, die mit Zellen im Bereich verknüpft sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`insertCells(shiftDimension)`

Fügt in diesen Bereich leere Zellen ein. Die neuen Zellen behalten die Formatierung der Zellen bei, die zuvor diesen Bereich belegten. Vorhandene Daten in der Tabelle, die der angegebenen Dimension entsprechen, werden 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 derer vorhandene Daten verschoben werden sollen.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`insertCheckboxes()`

Es werden Kästchen in jede Zelle im Bereich eingefügt, die mit true für angeklickt und false für nicht angeklickt 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`insertCheckboxes(checkedValue)`

Setzt in jede Zelle im Bereich Kästchen ein, die mit einem benutzerdefinierten Wert für „Ausgewählt“ und dem leeren String für „Nicht ausgewählt“ konfiguriert sind. Der Wert jeder Zelle im Bereich wird auf den leeren String festgelegt.

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 angeklickte Wert für die Kästchendatenvalidierung.

Rückflug

Range – Dieser Bereich, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`insertCheckboxes(checkedValue, uncheckedValue)`

In jede Zelle im Bereich werden Kästchen eingefügt, die mit benutzerdefinierten Werten für den angeklickten und den nicht angeklickten Status konfiguriert sind. Der Wert jeder Zelle im Bereich wird auf den benutzerdefinierten Wert gesetzt, der nicht angeklickt ist.

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 angeklickte Wert für die Kästchendatenvalidierung.
`uncheckedValue`	`Object`	Der Wert für das Kästchen ohne Häkchen bei der Datenvalidierung.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`isBlank()`

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

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`isChecked()`

Gibt zurück, ob für alle Zellen im Bereich der Kästchenstatus „angeklickt“ ist. Gibt null zurück, wenn einige Zellen angeklickt und der Rest nicht angeklickt ist oder wenn einige Zellen keine Kästchen für die Datenvalidierung haben.

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 angeklickt sind, false, wenn alle Zellen im Bereich nicht angeklickt sind, oder null, wenn eine der Zellen nicht angeklickt ist oder keine Kästchendatenvalidierung hat.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`isEndColumnBounded()`

Bestimmt, ob das Ende des Bereichs an eine bestimmte Spalte gebunden ist. Für die Bereiche A1:B10 oder B:B, die am Ende des Bereichs an Spalten 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; false andernfalls.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`isEndRowBounded()`

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`isPartOfMerge()`

Gibt true zurück, wenn die Zellen im aktuellen Bereich mit zusammengeführten Zellen überlappen.

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 der Bereich mit zusammengeführten Zellen übereinstimmt, andernfalls false.

`isStartColumnBounded()`

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`isStartRowBounded()`

Bestimmt, ob der Beginn des Bereichs an eine bestimmte Zeile gebunden ist. Für die Bereiche A1:B10 oder 3:7, die am Anfang des Bereichs an Zeilen gebunden sind, gibt diese Methode beispielsweise true zurück. Für den Bereich B:B, der am Anfang des Bereichs nur an eine bestimmte Spalte 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`merge()`

Die Zellen im Bereich werden zu einem einzigen Block zusammengeführt.

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, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`mergeAcross()`

Die Zellen im Bereich werden über die Spalten des Bereichs zusammengeführt.

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`mergeVertically()`

Die Zellen im Bereich werden zusammengeführt.

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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 (sowohl Format als auch Werte) in den Zielbereich ein.

// 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`	Zielbereich, in den dieser Bereich kopiert werden soll. Nur die Position der Zelle links oben ist relevant.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`offset(rowOffset, columnOffset)`

Gibt einen neuen Bereich zurück, der um die angegebene Anzahl von Zeilen und Spalten (kann negativ sein) 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 nach unten von der linken oberen Zelle des Bereichs. Negative Werte stehen für Zeilen nach oben von der linken oberen Zelle des Bereichs.
`columnOffset`	`Integer`	Die Anzahl der Spalten rechts von der linken oberen Zelle des Bereichs. Negative Werte stehen für Spalten links von der linken oberen Zelle des Bereichs.

Rückflug

Range – Dieser Bereich, für die Verkettung.

`offset(rowOffset, columnOffset, numRows)`

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

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 nach unten von der linken oberen Zelle des Bereichs. Negative Werte stehen für Zeilen nach oben von der linken oberen Zelle des Bereichs.
`columnOffset`	`Integer`	Die Anzahl der Spalten rechts von der linken oberen Zelle des Bereichs. Negative Werte stehen für Spalten links von der linken oberen Zelle des Bereichs.
`numRows`	`Integer`	Die Höhe des neuen Bereichs in Zeilen.

Rückflug

Range – Dieser Bereich, zur Verkettung.

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

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 nach unten von der linken oberen Zelle des Bereichs. Negative Werte stehen für Zeilen nach oben von der linken oberen Zelle des Bereichs.
`columnOffset`	`Integer`	Die Anzahl der Spalten rechts von der linken oberen Zelle des Bereichs. Negative Werte stehen für Spalten links von der linken oberen Zelle des Bereichs.
`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 Bearbeitung geschützt werden kann, mit Ausnahme von Nutzern mit Berechtigung. Solange das Script die Liste der Bearbeiter für den Bereich nicht tatsächlich ändert (durch Aufruf von Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) oder Festlegen eines neuen Werts für Protection.setDomainEdit(editable)), entsprechen die Berechtigungen denen der Tabelle selbst. Das bedeutet, dass der Bereich weiterhin 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`randomize()`

Die Reihenfolge der Zeilen im angegebenen Bereich wird zufällig.

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`removeCheckboxes()`

Entfernt alle Kästchen aus dem Bereich. Die Datenvalidierung für jede Zelle wird gelöscht. Wenn die Zelle den angeklickten oder nicht angeklickten Wert enthält, wird auch dieser gelöscht.

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, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`removeDuplicates()`

Entfernt Zeilen in diesem Bereich, die Werte enthalten, die mit Werten in einer vorherigen Zeile identisch 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 angezeigt werden (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 Bereich, der nach dem Entfernen von Duplikaten übrig bleibt. Die Größe des Bereichs wird um eine Zeile reduziert, wenn eine Zeile entfernt wird.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`removeDuplicates(columnsToCompare)`

Entfernt Zeilen in diesem Bereich, die Werte in den angegebenen Spalten enthalten, die mit den Werten einer vorherigen Zeile identisch sind. Zeilen mit identischen Werten und unterschiedlicher Groß- und Kleinschreibung, Formatierung oder unterschiedlichen Formeln gelten ebenfalls als Duplikate. Mit dieser Methode werden auch 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 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, in denen nach doppelten Werten gesucht werden soll. Wenn keine Spalten angegeben werden, werden alle Spalten auf Duplikate geprüft.

Rückflug

Range: Der Bereich, der nach dem Entfernen von Duplikaten übrig bleibt. Die Größe des Bereichs wird um eine Zeile reduziert, wenn eine Zeile entfernt wird.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setBackground(color)`

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

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setBackgroundObject(color)`

Hiermit wird die Hintergrundfarbe aller Zellen im Bereich festgelegt.

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 Hintergrundfarbe, die festgelegt werden soll. Der Wert `null` setzt die Hintergrundfarbe zurück.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setBackgroundObjects(color)`

Hiermit wird ein rechteckiges Raster mit Hintergrundfarben festgelegt. Die Abmessungen müssen mit denen des Bereichs übereinstimmen.

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. `null`-Werte setzen die Farbe zurück.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setBackgroundRGB(red, green, blue)`

Hiermit wird der Hintergrund mithilfe von RGB-Werten (Ganzzahlen zwischen 0 und 255) auf die angegebene Farbe festgelegt.

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ünwert in RGB-Schreibweise.
`blue`	`Integer`	Der Blauwert in RGB-Schreibweise.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setBackgrounds(color)`

Hiermit wird ein rechteckiges Raster mit Hintergrundfarben festgelegt. Die Abmessungen müssen mit denen des Bereichs übereinstimmen. Die Farben sind in CSS-Notation (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'`); `null`-Werte setzen die Farbe zurück.

Rückflug

Range – Dieser Bereich, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

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

Legt die Rahmeneigenschaft 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 keinen Rahmen, `null` für keine Änderung.
`left`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`bottom`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`right`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`vertical`	`Boolean`	`true` für vertikale Innenränder, `false` für keine Ränder, `null` für keine Änderung.
`horizontal`	`Boolean`	`true` für horizontale interne Rahmen, `false` für keine, `null` für keine Änderung.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

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

Legt die Rahmeneigenschaft mit Farbe und/oder Stil fest. Gültige Werte sind true (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 keinen Rahmen, `null` für keine Änderung.
`left`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`bottom`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`right`	`Boolean`	`true` für Rahmen, `false` für keinen Rahmen, `null` für keine Änderung.
`vertical`	`Boolean`	`true` für vertikale Innenränder, `false` für keine Ränder, `null` für keine Änderung.
`horizontal`	`Boolean`	`true` für horizontale interne Rahmen, `false` für keine, `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 (durchgehend).

Rückflug

Range – Dieser Bereich, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setDataValidation(rule)`

Hiermit wird eine Datenvalidierungsregel für alle Zellen im Bereich festgelegt.

// 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 zu festzulegende Regel für die Datenvalidierung oder `null`, um die Datenvalidierung zu entfernen.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setDataValidations(rules)`

Legt die Regeln für die Datenvalidierung für alle Zellen im Bereich fest. Diese Methode nimmt ein zweidimensionales Array von Datenvalidierungen an, das nach Zeile und dann nach Spalte indexiert ist. Die Arraydimensionen müssen mit den Bereichsdimensionen übereinstimmen.

// 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 mit Datenvalidierungsregeln, die festgelegt werden sollen. `null`-Werte entfernen die Datenvalidierung.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFontColor(color)`

Hiermit wird die Schriftfarbe in CSS-Notation (z. B. '#ffffff' oder 'white') festgelegt.

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFontColorObject(color)`

Legt die Schriftfarbe des angegebenen Bereichs fest.

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 Schriftfarbe, die festgelegt werden soll. Mit dem Wert `null` wird die Farbe zurückgesetzt.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFontColorObjects(colors)`

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

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, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFontColors(colors)`

Legt ein rechteckiges Raster mit Schriftfarben fest (muss den Abmessungen dieses Bereichs entsprechen). Die Farben 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'`); `null`-Werte setzen die Farbe zurück.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFontFamilies(fontFamilies)`

Hiermit wird ein rechteckiges Raster mit Schriftfamilien festgelegt. Die Abmessungen müssen mit den Abmessungen 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. Mit `null`-Werten wird die Schriftfamilie zurückgesetzt.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFontFamily(fontFamily)`

Hiermit wird die Schriftfamilie festgelegt, 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 Schriftfamilie, die festgelegt werden soll. Bei einem Wert von `null` wird die Schriftfamilie zurückgesetzt.

Rückflug

Range – Dieser Bereich, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFontLine(fontLine)`

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

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 Schriftschnitt, entweder `'underline'`, `'line-through'` oder `'none'`. Der Wert `null` setzt den Schriftschnitt zurück.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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 Abmessungen 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 von Schriftlinienstilen (`'underline'`, `'line-through'` oder `'none'`). Mit `null`-Werten wird der Schriftlinienstil zurückgesetzt.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFontSize(size)`

Hiermit wird die Schriftgröße festgelegt. 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFontSizes(sizes)`

Hiermit wird ein rechteckiges Raster mit Schriftgrößen festgelegt. Die Schriftgrößen müssen mit den Abmessungen 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFontStyle(fontStyle)`

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

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

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

Parameter

Name	Typ	Beschreibung
`fontStyle`	`String`	Die Schriftart, entweder `'italic'` oder `'normal'`. Mit dem Wert `null` wird die Schriftart zurückgesetzt.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFontStyles(fontStyles)`

Hiermit wird ein rechteckiges Raster mit Schriftstilen festgelegt. Es muss den Abmessungen dieses Bereichs entsprechen.

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 mit Schriftarten, entweder `'italic'` oder `'normal'`. Mit `null` wird die Schriftart zurückgesetzt.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFontWeights(fontWeights)`

Hiermit wird ein rechteckiges Raster mit Schriftschnitten festgelegt. Es muss den Abmessungen dieses Bereichs entsprechen. Ein Beispiel für eine Schriftschnittstä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 mit Schriftstärken, entweder `'bold'` oder `'normal'`. Mit `null` wird die Schriftstärke zurückgesetzt.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFormula(formula)`

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

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 Formel darstellt, die für die Zelle festgelegt werden soll.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFormulaR1C1(formula)`

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

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFormulas(formulas)`

Hiermit wird ein rechteckiges Raster mit Formeln festgelegt. Die Abmessungen müssen mit den Abmessungen dieses Bereichs übereinstimmen. Die angegebenen Formeln müssen in A1-Notation sein. Diese Methode nimmt ein zweidimensionales Array von Formeln an, das nach Zeile und dann nach Spalte indexiert ist. Die Arraydimensionen 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setFormulasR1C1(formulas)`

Hiermit wird ein rechteckiges Raster mit Formeln festgelegt. Die Abmessungen müssen mit den Abmessungen dieses Bereichs übereinstimmen. 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setHorizontalAlignment(alignment)`

Legen Sie die horizontale Ausrichtung (von links nach rechts) 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'`. Mit dem Wert `null` wird die Ausrichtung zurückgesetzt.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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 mit Ausrichtungen, entweder `'left'`, `'center'` oder `'normal'`. Ein Wert von `null` setzt die Ausrichtung zurück.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Weitere Informationen

setHorizontalAlignment(alignment)

`setNote(note)`

Legt den Notizentext 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 Hinweiswert, der für den Bereich festgelegt werden soll. Wenn Sie den Wert auf `null` setzen, wird der Hinweis entfernt.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setNotes(notes)`

Hiermit wird ein rechteckiges Notizen-Raster festgelegt, 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 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. Werte von `null` entfernen die Notiz.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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 zulässigen Formatmuster sind in der Google Tabellen 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 String für das Zahlenformat.

Rückflug

Range – Dieser Bereich, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setNumberFormats(numberFormats)`

Hiermit wird ein rechteckiges Raster mit Zahlen- oder Datumsformaten festgelegt. Es muss mit den Dimensionen dieses Bereichs übereinstimmen. Die Werte sind Formatmusterstrings, wie in der Tabellen 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setRichTextValue(value)`

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

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello"
// bolded.
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setRichTextValues(values)`

Hiermit wird ein rechteckiges Raster mit Rich-Text-Werten festgelegt.

// 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setShowHyperlink(showHyperlink)`

Hiermit wird festgelegt, 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setTextDirection(direction)`

Hiermit wird die Textrichtung für die Zellen im Bereich festgelegt. Wenn als Richtung null angegeben 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` angegeben ist, wird die Richtung vor der Einstellung abgeleitet.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setTextDirections(directions)`

Hiermit wird ein rechteckiges Raster mit Textrichtungen festgelegt. Wenn als Richtung null angegeben 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ünschte Textausrichtung. 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setTextRotation(degrees)`

Hiermit werden die Einstellungen für die Textdrehung für die Zellen im Bereich festgelegt. Die Eingabe entspricht dem Winkel zwischen der Standardtextausrichtung und der gewünschten Ausrichtung. Ein Wert von null gibt an, dass der Text auf die Standardausrichtung eingestellt ist.

Bei einer linksläufigen Textrichtung sind positive Winkel gegen den Uhrzeigersinn, bei einer rechtsläufigen Textrichtung 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 linksläufigem Text sind positive Winkel gegen den Uhrzeigersinn.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setTextRotation(rotation)`

Hiermit werden die Einstellungen für die Textdrehung für die Zellen im Bereich festgelegt.

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

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setTextRotations(rotations)`

Hiermit wird ein rechteckiges Raster mit Textdrehungen festgelegt.

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

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setTextStyle(style)`

Hiermit wird der Textstil für die Zellen im Bereich festgelegt.

// 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, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setTextStyles(styles)`

Hiermit wird ein rechteckiges Raster mit Textstilen festgelegt.

// 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setValue(value)`

Legt den Wert des Bereichs fest. Der Wert kann numerisch, ein String, ein boolescher Wert oder ein Datum sein. Wenn der String mit '=' beginnt, wird er 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setValues(values)`

Hiermit wird ein rechteckiges Raster mit Werten festgelegt, das den Abmessungen dieses Bereichs entsprechen 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setVerticalAlignment(alignment)`

Legen Sie die vertikale Ausrichtung (von oben nach unten) für den angegebenen Bereich 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'`. Mit dem Wert `null` wird die Ausrichtung zurückgesetzt.

Rückflug

Range – Dieser Bereich, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setVerticalAlignments(alignments)`

Hiermit wird ein rechteckiges Raster mit vertikalen Ausrichtungen festgelegt. Es muss mit den Abmessungen 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 alignments = [['top', 'middle', 'bottom']];

const range = sheet.getRange('B2:D2');
range.setVerticalAlignments(alignments);

Parameter

Name	Typ	Beschreibung
`alignments`	`Object[][]`	Ein zweidimensionales Array mit Ausrichtungen, entweder `'top'`, `'middle'` oder `'bottom'`. Mit einem `null`-Wert wird die Ausrichtung zurückgesetzt.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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 Textdrehung in Grad 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`	Ob der Text gestapelt werden soll.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setWrap(isWrapEnabled)`

Legen Sie die Zellumbruchfunktion für den angegebenen Bereich fest.

Bei Zellen, für die das Umbrechen aktiviert ist (Standardeinstellung), wird die Größe so angepasst, dass der gesamte Inhalt angezeigt wird. In Zellen, bei denen das Umbruch-Attribut deaktiviert ist, wird der Inhalt so weit wie möglich in der Zelle angezeigt, ohne dass die Größe geändert oder mehrere Zeilen verwendet werden müssen.

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

const cell = sheet.getRange('B2');
cell.setWrap(true);

Parameter

Name	Typ	Beschreibung
`isWrapEnabled`	`Boolean`	Ob Text umgebrochen werden soll oder nicht.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setWrapStrategies(strategies)`

Legt ein rechteckiges Raster mit 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setWrapStrategy(strategy)`

Hiermit wird die Textumbruchstrategie für die Zellen im Bereich festgelegt.

// 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, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`setWraps(isWrapEnabled)`

Hiermit wird ein rechteckiges Raster mit Richtlinien für den Wortumbruch festgelegt. Es muss den Abmessungen dieses Bereichs entsprechen. Bei Zellen, für die das Umbrechen aktiviert ist (Standardeinstellung), wird die Größe so angepasst, dass der gesamte Inhalt angezeigt wird. In Zellen, in denen das Umbrechen deaktiviert ist, wird der Inhalt so weit wie möglich dargestellt, ohne dass die Zellengröße geändert oder der Inhalt auf mehrere Zeilen verteilt werden 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 wraps = [[true, true, false]];

const range = sheet.getRange('B2:D2');
range.setWraps(wraps);

Parameter

Name	Typ	Beschreibung
`isWrapEnabled`	`Object[][]`	Ein zweidimensionales Array von Umbruchvariablen, das festlegt, ob Text in einer Zelle umgebrochen wird oder nicht.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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 Sie die Gruppentiefe unter null oder über acht senken.

Wenn column group control position = BEFORE ist, wird beim Versuch, die Tiefe der ersten Zeile zu verschieben, ein Fehler ausgegeben.

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 Wert, um den die Tiefe der Spaltengruppe dieses Bereichs geändert werden soll.

Rückflug

Range – Dieser Bereich, zur Verkettung.

Löst aus

Error: Beim Versuch, die Tiefe der ersten Spalte zu ändern, wenn die Steuerposition GroupControlTogglePosition.BEFORE ist

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`shiftRowGroupDepth(delta)`

Ändert die Tiefe der Zeilengruppierung des Bereichs um den angegebenen Wert.

Das hat keine Auswirkungen, wenn Sie die Gruppenebene unter null oder über acht senken.

Wenn row group control position BEFORE ist, wird beim Versuch, die Tiefe der ersten Zeile zu verschieben, ein Fehler ausgegeben.

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 Wert, um den die Tiefe der Zeilengruppe dieses Bereichs geändert werden soll.

Rückflug

Range – Dieser Bereich, für die Verkettung.

Löst aus

Error – beim Versuch, die Tiefe der ersten Zeile zu ändern, wenn die Steuerelementposition GroupControlTogglePosition.BEFORE ist

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`sort(sortSpecObj)`

Sortiert die Zellen im angegebenen Bereich nach der angegebenen Spalte und Reihenfolge.

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`splitTextToColumns()`

Teilt eine Textspalte anhand eines automatisch erkannten Trennzeichens in mehrere Spalten auf.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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, an dem die Aufteilung erfolgen soll.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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, anhand dessen die Spalte aufgeteilt werden soll.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`trimWhitespace()`

Hiermit werden die Leerzeichen (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) in jeder Zelle dieses Bereichs entfernt. Entfernt alle Leerzeichen am Anfang und Ende des Texts in jeder Zelle und reduziert jede Folge verbleibender Leerzeichenzeichen 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

`uncheck()`

Der Status der Kästchen im Bereich wird in „Deaktiviert“ geändert. Zellen im Bereich, die derzeit weder den konfigurierten Wert „Angeklickt“ noch „Deaktiviert“ 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Logger.log(range.getFontColor());

Rückflug

String: Schriftfarbe in CSS-Notation (z. B. '#ffffff' oder 'white').

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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 von Schriftfarben, die den Zellen im Bereich zugeordnet sind.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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