Diese Seite wurde von der Cloud Translation API übersetzt.

Class Sheet

Auf Tabellenblätter zugreifen und sie bearbeiten. Häufige Vorgänge sind das Umbenennen eines Tabellenblatts und der Zugriff auf Bereichsobjekte aus dem Tabellenblatt.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`activate()`	`Sheet`	Aktiviert dieses Tabellenblatt.
`addDeveloperMetadata(key)`	`Sheet`	Fügt dem Tab Entwicklermetadaten mit dem angegebenen Schlüssel hinzu.
`addDeveloperMetadata(key, visibility)`	`Sheet`	Fügt dem Tabellenblatt Entwicklermetadaten mit dem angegebenen Schlüssel und der angegebenen Sichtbarkeit hinzu.
`addDeveloperMetadata(key, value)`	`Sheet`	Fügt dem Tabellenblatt Entwicklermetadaten mit dem angegebenen Schlüssel und Wert hinzu.
`addDeveloperMetadata(key, value, visibility)`	`Sheet`	Fügt dem Tabellenblatt Entwicklermetadaten mit dem angegebenen Schlüssel, Wert und der angegebenen Sichtbarkeit hinzu.
`appendRow(rowContents)`	`Sheet`	Fügt eine Zeile unten an den aktuellen Datenbereich im Tabellenblatt an.
`asDataSourceSheet()`	`DataSourceSheet`	Gibt das Tabellenblatt als `DataSourceSheet` zurück, wenn es vom Typ `SheetType.DATASOURCE` ist, andernfalls `null`.
`autoResizeColumn(columnPosition)`	`Sheet`	Legt die Breite der angegebenen Spalte so fest, dass sie an den Inhalt angepasst wird.
`autoResizeColumns(startColumn, numColumns)`	`Sheet`	Legt die Breite aller Spalten ab der angegebenen Spaltenposition so fest, dass sie an ihren Inhalt angepasst wird.
`autoResizeRows(startRow, numRows)`	`Sheet`	Legt die Höhe aller Zeilen ab der angegebenen Zeilenposition so fest, dass sie an den Inhalt angepasst wird.
`clear()`	`Sheet`	Entfernt alle Inhalte und Formatierungsinformationen aus dem Tabellenblatt.
`clear(options)`	`Sheet`	Löscht den Inhalt und/oder das Format des Blatts gemäß den angegebenen erweiterten Optionen.
`clearConditionalFormatRules()`	`void`	Entfernt alle Regeln für die bedingte Formatierung aus dem Tabellenblatt.
`clearContents()`	`Sheet`	Löscht den Inhalt des Blatts, wobei die Formatierungsinformationen beibehalten werden.
`clearFormats()`	`Sheet`	Entfernt die Formatierung aus dem Tabellenblatt, wobei der Inhalt erhalten bleibt.
`clearNotes()`	`Sheet`	Entfernt alle Notizen aus dem Tabellenblatt.
`collapseAllColumnGroups()`	`Sheet`	Minimiert alle Spaltengruppen im Tabellenblatt.
`collapseAllRowGroups()`	`Sheet`	Minimiert alle Zeilengruppen im Tabellenblatt.
`copyTo(spreadsheet)`	`Sheet`	Kopiert das Tabellenblatt in eine bestimmte Tabelle, die mit der Quelltabelle identisch sein kann.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Gibt ein `DeveloperMetadataFinder` zurück, um Entwicklermetadaten im Bereich dieses Blatts zu finden.
`createTextFinder(findText)`	`TextFinder`	Erstellt eine Textsuche für das Tabellenblatt, mit der Text im Tabellenblatt gesucht und ersetzt werden kann.
`deleteColumn(columnPosition)`	`Sheet`	Löscht die Spalte an der angegebenen Spaltenposition.
`deleteColumns(columnPosition, howMany)`	`void`	Löscht eine bestimmte Anzahl von Spalten ab der angegebenen Spaltenposition.
`deleteRow(rowPosition)`	`Sheet`	Löscht die Zeile an der angegebenen Zeilenposition.
`deleteRows(rowPosition, howMany)`	`void`	Löscht eine bestimmte Anzahl von Zeilen ab der angegebenen Zeilenposition.
`expandAllColumnGroups()`	`Sheet`	Maximiert alle Spaltengruppen im Tabellenblatt.
`expandAllRowGroups()`	`Sheet`	Maximiert alle Zeilengruppen im Tabellenblatt.
`expandColumnGroupsUpToDepth(groupDepth)`	`Sheet`	Maximiert alle Spaltengruppen bis zur angegebenen Tiefe und minimiert alle anderen.
`expandRowGroupsUpToDepth(groupDepth)`	`Sheet`	Maximiert alle Zeilengruppen bis zur angegebenen Tiefe und minimiert alle anderen.
`getActiveCell()`	`Range`	Gibt die aktive Zelle in diesem Tabellenblatt zurück.
`getActiveRange()`	`Range`	Gibt den ausgewählten Bereich im aktiven Tabellenblatt zurück oder `null`, wenn kein aktiver Bereich vorhanden ist.
`getActiveRangeList()`	`RangeList`	Gibt die Liste der aktiven Bereiche im aktiven Tabellenblatt oder `null` zurück, wenn keine aktiven Bereiche vorhanden sind.
`getBandings()`	`Banding[]`	Gibt alle Bandings in diesem Tabellenblatt zurück.
`getCharts()`	`EmbeddedChart[]`	Gibt ein Array von Diagrammen auf diesem Tabellenblatt zurück.
`getColumnGroup(columnIndex, groupDepth)`	`Group`	Gibt die Spaltengruppe mit dem angegebenen Index und der angegebenen Gruppentiefe zurück.
`getColumnGroupControlPosition()`	`GroupControlTogglePosition`	Gibt die `GroupControlTogglePosition` für alle Spaltengruppen im Tabellenblatt zurück.
`getColumnGroupDepth(columnIndex)`	`Integer`	Gibt die Gruppierungstiefe der Spalte am angegebenen Index zurück.
`getColumnWidth(columnPosition)`	`Integer`	Gibt die Breite der angegebenen Spalte in Pixeln zurück.
`getConditionalFormatRules()`	`ConditionalFormatRule[]`	Alle Regeln für die bedingte Formatierung in diesem Tabellenblatt abrufen.
`getCurrentCell()`	`Range`	Gibt die aktuelle Zelle im aktiven Tabellenblatt oder `null` zurück, wenn keine aktuelle Zelle vorhanden ist.
`getDataRange()`	`Range`	Gibt ein `Range` zurück, das den Dimensionen entspricht, in denen Daten vorhanden sind.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Ruft alle Datenquellenformeln ab.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Ruft alle Pivot-Tabellen der Datenquelle ab.
`getDataSourceTables()`	`DataSourceTable[]`	Ruft alle Datenquellentabellen ab.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Ruft alle Entwicklermetadaten ab, die mit diesem Tabellenblatt verknüpft sind.
`getDrawings()`	`Drawing[]`	Gibt ein Array von Zeichnungen auf dem Tabellenblatt zurück.
`getFilter()`	`Filter`	Gibt den Filter in diesem Tabellenblatt zurück oder `null`, wenn kein Filter vorhanden ist.
`getFormUrl()`	`String`	Gibt die URL für das Formular zurück, dessen Antworten an dieses Tabellenblatt gesendet werden, oder `null`, wenn diesem Tabellenblatt kein Formular zugeordnet ist.
`getFrozenColumns()`	`Integer`	Gibt die Anzahl der fixierten Spalten zurück.
`getFrozenRows()`	`Integer`	Gibt die Anzahl der fixierten Zeilen zurück.
`getImages()`	`OverGridImage[]`	Gibt alle Bilder zurück, die sich nicht in Zellen befinden.
`getIndex()`	`Integer`	Gibt die Position des Tabellenblatts in der übergeordneten Tabelle zurück.
`getLastColumn()`	`Integer`	Gibt die Position der letzten Spalte mit Inhalt zurück.
`getLastRow()`	`Integer`	Gibt die Position der letzten Zeile mit Inhalt zurück.
`getMaxColumns()`	`Integer`	Gibt die aktuelle Anzahl der Spalten im Tabellenblatt zurück, unabhängig vom Inhalt.
`getMaxRows()`	`Integer`	Gibt die aktuelle Anzahl der Zeilen im Tabellenblatt zurück, unabhängig vom Inhalt.
`getName()`	`String`	Gibt den Namen des Tabellenblatts zurück.
`getNamedRanges()`	`NamedRange[]`	Ruft alle benannten Bereiche in diesem Tabellenblatt ab.
`getParent()`	`Spreadsheet`	Gibt die `Spreadsheet` zurück, die dieses Tabellenblatt enthält.
`getPivotTables()`	`PivotTable[]`	Gibt alle Pivot-Tabellen in diesem Tabellenblatt zurück.
`getProtections(type)`	`Protection[]`	Ruft ein Array von Objekten ab, die alle geschützten Bereiche im Tabellenblatt darstellen, oder ein Array mit einem Element, das den Schutz des Tabellenblatts selbst darstellt.
`getRange(row, column)`	`Range`	Gibt den Bereich mit der Zelle oben links an den angegebenen Koordinaten zurück.
`getRange(row, column, numRows)`	`Range`	Gibt den Bereich mit der Zelle oben links an den angegebenen Koordinaten und mit der angegebenen Anzahl von Zeilen zurück.
`getRange(row, column, numRows, numColumns)`	`Range`	Gibt den Bereich mit der Zelle oben links an den angegebenen Koordinaten mit der angegebenen Anzahl von Zeilen und Spalten zurück.
`getRange(a1Notation)`	`Range`	Gibt den Bereich in A1- oder R1C1-Notation zurück.
`getRangeList(a1Notations)`	`RangeList`	Gibt die `RangeList`-Sammlung zurück, die die Bereiche im selben Tabellenblatt darstellt, die durch eine nicht leere Liste von A1- oder R1C1-Notationen angegeben werden.
`getRowGroup(rowIndex, groupDepth)`	`Group`	Gibt die Zeilengruppe mit dem angegebenen Index und der angegebenen Gruppentiefe zurück.
`getRowGroupControlPosition()`	`GroupControlTogglePosition`	Gibt die `GroupControlTogglePosition` für alle Zeilengruppen im Tabellenblatt zurück.
`getRowGroupDepth(rowIndex)`	`Integer`	Gibt die Gruppierungstiefe der Zeile am angegebenen Index zurück.
`getRowHeight(rowPosition)`	`Integer`	Gibt die Höhe der angegebenen Zeile in Pixeln zurück.
`getSelection()`	`Selection`	Gibt die aktuelle `Selection` in der Tabelle zurück.
`getSheetId()`	`Integer`	Gibt die ID des Tabellenblatts zurück, das durch dieses Objekt dargestellt wird.
`getSheetName()`	`String`	Gibt den Namen des Tabellenblatts zurück.
`getSheetValues(startRow, startColumn, numRows, numColumns)`	`Object[][]`	Gibt das rechteckige Raster von Werten für diesen Bereich zurück, beginnend mit den angegebenen Koordinaten.
`getSlicers()`	`Slicer[]`	Gibt ein Array von Slicern im Tabellenblatt zurück.
`getTabColorObject()`	`Color`	Gibt die Farbe des Tabellenblatt-Tabs zurück oder `null`, wenn der Tabellenblatt-Tab keine Farbe hat.
`getType()`	`SheetType`	Gibt den Typ des Tabellenblatts zurück.
`hasHiddenGridlines()`	`Boolean`	Gibt `true` zurück, wenn die Tabellengitterlinien ausgeblendet sind. Andernfalls wird `false` zurückgegeben.
`hideColumn(column)`	`void`	Blendet die Spalte(n) im angegebenen Bereich aus.
`hideColumns(columnIndex)`	`void`	Blendet eine einzelne Spalte am angegebenen Index aus.
`hideColumns(columnIndex, numColumns)`	`void`	Blendet eine oder mehrere aufeinanderfolgende Spalten ab dem angegebenen Index aus.
`hideRow(row)`	`void`	Blendet die Zeilen im angegebenen Bereich aus.
`hideRows(rowIndex)`	`void`	Blendet die Zeile am angegebenen Index aus.
`hideRows(rowIndex, numRows)`	`void`	Blendet eine oder mehrere aufeinanderfolgende Zeilen ab dem angegebenen Index aus.
`hideSheet()`	`Sheet`	Blendet dieses Tabellenblatt aus.
`insertChart(chart)`	`void`	Fügt diesem Tabellenblatt ein neues Diagramm hinzu.
`insertColumnAfter(afterPosition)`	`Sheet`	Fügt eine Spalte nach der angegebenen Spaltenposition ein.
`insertColumnBefore(beforePosition)`	`Sheet`	Fügt eine Spalte vor der angegebenen Spaltenposition ein.
`insertColumns(columnIndex)`	`void`	Fügt eine leere Spalte an der angegebenen Position in ein Tabellenblatt ein.
`insertColumns(columnIndex, numColumns)`	`void`	Fügt ab der angegebenen Position eine oder mehrere aufeinanderfolgende leere Spalten in ein Tabellenblatt ein.
`insertColumnsAfter(afterPosition, howMany)`	`Sheet`	Fügt nach der angegebenen Spaltenposition eine bestimmte Anzahl von Spalten ein.
`insertColumnsBefore(beforePosition, howMany)`	`Sheet`	Fügt eine bestimmte Anzahl von Spalten vor der angegebenen Spaltenposition ein.
`insertImage(blobSource, column, row)`	`OverGridImage`	Fügt ein `BlobSource` als Bild in das Dokument in einer bestimmten Zeile und Spalte ein.
`insertImage(blobSource, column, row, offsetX, offsetY)`	`OverGridImage`	Fügt ein `BlobSource` als Bild in das Dokument in einer bestimmten Zeile und Spalte mit einem Pixel-Offset ein.
`insertImage(url, column, row)`	`OverGridImage`	Fügt ein Bild in das Dokument in einer bestimmten Zeile und Spalte ein.
`insertImage(url, column, row, offsetX, offsetY)`	`OverGridImage`	Fügt ein Bild mit einem Pixel-Offset in das Dokument an einer bestimmten Zeile und Spalte ein.
`insertRowAfter(afterPosition)`	`Sheet`	Fügt eine Zeile nach der angegebenen Zeilenposition ein.
`insertRowBefore(beforePosition)`	`Sheet`	Fügt eine Zeile vor der angegebenen Zeilenposition ein.
`insertRows(rowIndex)`	`void`	Fügt an der angegebenen Stelle eine leere Zeile in ein Tabellenblatt ein.
`insertRows(rowIndex, numRows)`	`void`	Fügt ab der angegebenen Position eine oder mehrere aufeinanderfolgende leere Zeilen in ein Tabellenblatt ein.
`insertRowsAfter(afterPosition, howMany)`	`Sheet`	Fügt nach der angegebenen Zeilenposition eine bestimmte Anzahl von Zeilen ein.
`insertRowsBefore(beforePosition, howMany)`	`Sheet`	Fügt eine bestimmte Anzahl von Zeilen vor der angegebenen Zeilenposition ein.
`insertSlicer(range, anchorRowPos, anchorColPos)`	`Slicer`	Fügt diesem Tabellenblatt einen neuen Slicer hinzu.
`insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)`	`Slicer`	Fügt diesem Tabellenblatt einen neuen Slicer hinzu.
`isColumnHiddenByUser(columnPosition)`	`Boolean`	Gibt zurück, ob die angegebene Spalte vom Nutzer ausgeblendet wurde.
`isRightToLeft()`	`Boolean`	Gibt `true` zurück, wenn das Tabellenblattlayout von rechts nach links ist.
`isRowHiddenByFilter(rowPosition)`	`Boolean`	Gibt zurück, ob die angegebene Zeile durch einen Filter (nicht durch eine Filteransicht) ausgeblendet wird.
`isRowHiddenByUser(rowPosition)`	`Boolean`	Gibt zurück, ob die angegebene Zeile vom Nutzer ausgeblendet wurde.
`isSheetHidden()`	`Boolean`	Gibt `true` zurück, wenn das Tabellenblatt derzeit ausgeblendet ist.
`moveColumns(columnSpec, destinationIndex)`	`void`	Verschiebt die durch den angegebenen Bereich ausgewählten Spalten an die durch `destinationIndex` angegebene Position.
`moveRows(rowSpec, destinationIndex)`	`void`	Verschiebt die durch den angegebenen Bereich ausgewählten Zeilen an die durch das `destinationIndex` angegebene Position.
`newChart()`	`EmbeddedChartBuilder`	Gibt einen Builder zurück, mit dem ein neues Diagramm für dieses Tabellenblatt erstellt werden kann.
`protect()`	`Protection`	Erstellt ein Objekt, mit dem das Tabellenblatt vor Änderungen geschützt werden kann, die nicht von Nutzern mit Berechtigung vorgenommen werden.
`removeChart(chart)`	`void`	Entfernt ein Diagramm aus dem übergeordneten Tabellenblatt.
`setActiveRange(range)`	`Range`	Legt den angegebenen Bereich als `active range` im aktiven Tabellenblatt fest. Die obere linke Zelle im Bereich wird als `current cell` verwendet.
`setActiveRangeList(rangeList)`	`RangeList`	Legt die angegebene Liste von Bereichen als `active ranges` im aktiven Tabellenblatt fest.
`setActiveSelection(range)`	`Range`	Legt den aktiven Auswahlbereich für dieses Tabellenblatt fest.
`setActiveSelection(a1Notation)`	`Range`	Legt die aktive Auswahl fest, wie in der A1- oder R1C1-Notation angegeben.
`setColumnGroupControlPosition(position)`	`Sheet`	Hiermit wird die Position des Ein/Aus-Schalters für die Spaltengruppensteuerung im Tabellenblatt festgelegt.
`setColumnWidth(columnPosition, width)`	`Sheet`	Legt die Breite der angegebenen Spalte in Pixeln fest.
`setColumnWidths(startColumn, numColumns, width)`	`Sheet`	Legt die Breite der angegebenen Spalten in Pixeln fest.
`setConditionalFormatRules(rules)`	`void`	Ersetzt alle vorhandenen Regeln für die bedingte Formatierung im Tabellenblatt durch die Eingaberegeln.
`setCurrentCell(cell)`	`Range`	Legt die angegebene Zelle als `current cell` fest.
`setFrozenColumns(columns)`	`void`	Friert die angegebene Anzahl von Spalten ein.
`setFrozenRows(rows)`	`void`	Fixiert die angegebene Anzahl von Zeilen.
`setHiddenGridlines(hideGridlines)`	`Sheet`	Blendet die Gitternetzlinien des Tabellenblatts ein oder aus.
`setName(name)`	`Sheet`	Legt den Namen des Tabellenblatts fest.
`setRightToLeft(rightToLeft)`	`Sheet`	Legt das Arbeitsblattlayout auf „Linksläufig“ fest oder hebt die Festlegung auf.
`setRowGroupControlPosition(position)`	`Sheet`	Legt die Position des Ein/Aus-Schalters für die Zeilengruppensteuerung im Tabellenblatt fest.
`setRowHeight(rowPosition, height)`	`Sheet`	Legt die Zeilenhöhe der angegebenen Zeile in Pixeln fest.
`setRowHeights(startRow, numRows, height)`	`Sheet`	Legt die Höhe der angegebenen Zeilen in Pixeln fest.
`setRowHeightsForced(startRow, numRows, height)`	`Sheet`	Legt die Höhe der angegebenen Zeilen in Pixeln fest.
`setTabColor(color)`	`Sheet`	Legt die Farbe des Tabellenblatt-Tabs fest.
`setTabColorObject(color)`	`Sheet`	Legt die Farbe des Tabellenblatt-Tabs fest.
`showColumns(columnIndex)`	`void`	Macht die Spalte am angegebenen Index wieder sichtbar.
`showColumns(columnIndex, numColumns)`	`void`	Macht eine oder mehrere aufeinanderfolgende Spalten ab dem angegebenen Index wieder sichtbar.
`showRows(rowIndex)`	`void`	Macht die Zeile am angegebenen Index wieder sichtbar.
`showRows(rowIndex, numRows)`	`void`	Macht eine oder mehrere aufeinanderfolgende Zeilen ab dem angegebenen Index wieder sichtbar.
`showSheet()`	`Sheet`	Macht das Tabellenblatt sichtbar.
`sort(columnPosition)`	`Sheet`	Sortiert ein Tabellenblatt aufsteigend nach Spalte.
`sort(columnPosition, ascending)`	`Sheet`	Sortiert ein Tabellenblatt nach Spalte.
`unhideColumn(column)`	`void`	Macht die Spalte im angegebenen Bereich wieder sichtbar.
`unhideRow(row)`	`void`	Macht die Zeile im angegebenen Bereich wieder sichtbar.
`updateChart(chart)`	`void`	Aktualisiert das Diagramm auf diesem Tabellenblatt.

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getSheetProtection()`	`PageProtection`	Gibt eine `PageProtection`-Instanz zurück, die die Berechtigungen für das aktuelle Tabellenblatt beschreibt.
`getTabColor()`	`String`	Gibt die Farbe des Tabellenblatt-Tabs zurück oder `null`, wenn der Tabellenblatt-Tab keine Farbe hat.
`setSheetProtection(permissions)`	`void`	Legt die Berechtigungen für das aktuelle Tabellenblatt fest.

Detaillierte Dokumentation

`activate()`

Aktiviert dieses Tabellenblatt. Das Blatt selbst wird nicht geändert, nur die Vorstellung des übergeordneten Elements vom aktiven Blatt.

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.activate();

Rückflug

Sheet: Das neu aktivierte Tabellenblatt.

`addDeveloperMetadata(key)`

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

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

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

// Adds the key 'NAME' to the developer metadata for the sheet.
sheet.addDeveloperMetadata('NAME');

// Gets the updated metadata info and logs it to the console.
console.log(sheet.getDeveloperMetadata()[0].getKey());

Parameter

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

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`addDeveloperMetadata(key, visibility)`

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

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

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

// Adds the key 'NAME' and sets the developer metadata visibility to PROJECT
// for the sheet.
sheet.addDeveloperMetadata(
    'NAME',
    SpreadsheetApp.DeveloperMetadataVisibility.PROJECT,
);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = sheet.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

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`addDeveloperMetadata(key, value)`

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

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

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

// Adds the key 'COMPANY' with the value 'TECH' to the developer metadata for
// the sheet.
sheet.addDeveloperMetadata('COMPANY', 'TECH');

// Gets the updated metadata info and logs it to the console.
const developerMetaData = sheet.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

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`addDeveloperMetadata(key, value, visibility)`

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

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

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

// Adds the key 'COMPANY' with the value 'TECH' to the developer metadata and
// sets the visibility to DOCUMENT for the sheet.
sheet.addDeveloperMetadata(
    'COMPANY',
    'TECH',
    SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT,
);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = sheet.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

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`appendRow(rowContents)`

Fügt eine Zeile unten an den aktuellen Datenbereich im Tabellenblatt an. Wenn der Inhalt einer Zelle mit = beginnt, wird er als Formel interpretiert.

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

// Appends a new row with 3 columns to the bottom of the current
// data region in the sheet containing the values in the array.
sheet.appendRow(['a man', 'a plan', 'panama']);

Parameter

Name	Typ	Beschreibung
`rowContents`	`Object[]`	Ein Array von Werten, die nach der letzten Zeile im Tabellenblatt eingefügt werden sollen.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`asDataSourceSheet()`

Gibt das Tabellenblatt als DataSourceSheet zurück, wenn es vom Typ SheetType.DATASOURCE ist, andernfalls null.

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the data source sheet value if the sheet is of type
// SpreadsheetApp.SheetType.DATASOURCE, otherwise this returns a null value.
const dataSourceSheet = sheet.asDataSourceSheet();

// Gets the data source sheet value and logs it to the console.
console.log(dataSourceSheet);
console.log(sheet.getType().toString());

Rückflug

DataSourceSheet: Ein Datenquellenblatt.

Autorisierung

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

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

`autoResizeColumn(columnPosition)`

Legt die Breite der angegebenen Spalte so fest, dass sie an den Inhalt angepasst wird.

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

sheet.getRange('a1').setValue(
    'Whenever it is a damp, drizzly November in my soul...');

// Sets the first column to a width which fits the text
sheet.autoResizeColumn(1);

Parameter

Name	Typ	Beschreibung
`columnPosition`	`Integer`	Die Position der Spalte, deren Größe geändert werden soll.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`autoResizeColumns(startColumn, numColumns)`

Legt die Breite aller Spalten ab der angegebenen Spaltenposition so fest, dass sie an ihren Inhalt angepasst wird.

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

// Sets the first 15 columns to a width that fits their text.
sheet.autoResizeColumns(1, 15);

Parameter

Name	Typ	Beschreibung
`startColumn`	`Integer`	Die Startspalte, deren Größe automatisch angepasst werden soll.
`numColumns`	`Integer`	Die Anzahl der Spalten, deren Größe automatisch angepasst werden soll.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`autoResizeRows(startRow, numRows)`

Legt die Höhe aller Zeilen ab der angegebenen Zeilenposition so fest, dass sie an den Inhalt angepasst wird.

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

// Sets the first 15 rows to a height that fits their text.
sheet.autoResizeRows(1, 15);

Parameter

Name	Typ	Beschreibung
`startRow`	`Integer`	Die Startzeile, deren Größe automatisch angepasst werden soll.
`numRows`	`Integer`	Die Anzahl der Zeilen, deren Größe automatisch angepasst werden soll.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`clear()`

Entfernt alle Inhalte und Formatierungsinformationen aus dem Tabellenblatt.

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.clear();

Rückflug

Sheet – Das gelöschte Tabellenblatt.

Autorisierung

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

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

`clear(options)`

Löscht den Inhalt und/oder das Format des Blatts gemäß den angegebenen erweiterten Optionen.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
sheet.clear({formatOnly: true, contentsOnly: true});

Parameter

Name	Typ	Beschreibung
`options`	`Object`	Eine JavaScript-Karte mit erweiterten Optionen (siehe unten).

Erweiterte Parameter

Name	Typ	Beschreibung
`contentsOnly`	`Boolean`	Ob der Inhalt gelöscht werden soll.
`formatOnly`	`Boolean`	Gibt an, ob das Format gelöscht werden soll.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`clearConditionalFormatRules()`

Entfernt alle Regeln für die bedingte Formatierung aus dem Tabellenblatt. Entspricht dem Aufruf von setConditionalFormatRules(rules) mit einem leeren Array als Eingabe.

const sheet = SpreadsheetApp.getActiveSheet();
sheet.clearConditionalFormatRules();

Autorisierung

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

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

`clearContents()`

Löscht den Inhalt des Blatts, wobei die Formatierungsinformationen beibehalten werden.

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.clearContents();

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`clearFormats()`

Entfernt die Formatierung aus dem Tabellenblatt, wobei der Inhalt erhalten bleibt.

Die Formatierung bezieht sich darauf, wie Daten gemäß den Optionen im Menü „Format“ formatiert werden (z. B. fett, kursiv, bedingte Formatierung) und nicht auf die Breite oder Höhe von Zellen.

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.clearFormats();

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`clearNotes()`

Entfernt alle Notizen aus dem Tabellenblatt.

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.clearNotes();

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`collapseAllColumnGroups()`

Minimiert alle Spaltengruppen im Tabellenblatt.

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

// All column groups on the sheet are collapsed.
sheet.collapseAllColumnGroups();

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`collapseAllRowGroups()`

Minimiert alle Zeilengruppen im Tabellenblatt.

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

// All row groups on the sheet are collapsed.
sheet.collapseAllRowGroups();

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`copyTo(spreadsheet)`

Kopiert das Tabellenblatt in eine bestimmte Tabelle, die mit der Quelltabelle identisch sein kann. Das kopierte Tabellenblatt erhält den Namen „Kopie von [Originalname]“.

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

const destination = SpreadsheetApp.openById('ID_GOES HERE');
sheet.copyTo(destination);

Parameter

Name	Typ	Beschreibung
`spreadsheet`	`Spreadsheet`	Die Tabelle, in die dieses Tabellenblatt kopiert werden soll. Das kann dieselbe Tabelle wie die Quelle sein.

Rückflug

Sheet: Das neue Tabellenblatt für die Verkettung.

Autorisierung

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

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

`createDeveloperMetadataFinder()`

Gibt ein DeveloperMetadataFinder zurück, um Entwicklermetadaten im Bereich dieses Blatts zu finden. Metadaten sind im Bereich eines bestimmten Tabellenblatts, wenn sie entweder dem Tabellenblatt selbst oder einer Zeile, Spalte oder einem Bereich in diesem Tabellenblatt zugeordnet sind.

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds developer metadata for testing.
sheet.addDeveloperMetadata('CITY', 'PARIS');

// Creates the developer metadata finder.
const metadatafinder = sheet.createDeveloperMetadataFinder();

// Finds the metadata with value 'PARIS' and displays its key in the console.
console.log(metadatafinder.withValue('PARIS').find()[0].getKey());

Rückflug

DeveloperMetadataFinder: Ein Tool zum Suchen nach Entwicklermetadaten im Bereich dieses Tabellenblatts.

`createTextFinder(findText)`

Erstellt eine Textsuche für das Tabellenblatt, mit der Text im Tabellenblatt gesucht und ersetzt werden kann.

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

// Creates  a text finder.
const textFinder = sheet.createTextFinder('dog');

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

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

Parameter

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

Rückflug

TextFinder: Die TextFinder für das Tabellenblatt.

`deleteColumn(columnPosition)`

Löscht die Spalte an der angegebenen Spaltenposition.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first column
sheet.deleteColumn(1);

Parameter

Name	Typ	Beschreibung
`columnPosition`	`Integer`	Die Position der Spalte, beginnend mit 1 für die erste Spalte.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`deleteColumns(columnPosition, howMany)`

Löscht eine bestimmte Anzahl von Spalten ab der angegebenen Spaltenposition.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first two columns
sheet.deleteColumns(1, 2);

Parameter

Name	Typ	Beschreibung
`columnPosition`	`Integer`	Die Position der ersten Spalte, die gelöscht werden soll.
`howMany`	`Integer`	Die Anzahl der zu löschenden Spalten.

Autorisierung

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

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

`deleteRow(rowPosition)`

Löscht die Zeile an der angegebenen Zeilenposition.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first row
sheet.deleteRow(1);

Parameter

Name	Typ	Beschreibung
`rowPosition`	`Integer`	Die Position der Zeile, beginnend mit 1 für die erste Zeile.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`deleteRows(rowPosition, howMany)`

Löscht eine bestimmte Anzahl von Zeilen ab der angegebenen Zeilenposition.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first two rows
sheet.deleteRows(1, 2);

Parameter

Name	Typ	Beschreibung
`rowPosition`	`Integer`	Die Position der ersten zu löschenden Zeile.
`howMany`	`Integer`	Die Anzahl der zu löschenden Zeilen.

Autorisierung

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

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

`expandAllColumnGroups()`

Maximiert alle Spaltengruppen im Tabellenblatt. Für diese Methode ist mindestens eine Spaltengruppe erforderlich.

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

// All column groups on the sheet are expanded.
sheet.expandAllColumnGroups();

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`expandAllRowGroups()`

Maximiert alle Zeilengruppen im Tabellenblatt. Für diese Methode ist mindestens eine Zeilengruppe erforderlich.

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

// All row groups on the sheet are expanded.
sheet.expandAllRowGroups();

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`expandColumnGroupsUpToDepth(groupDepth)`

Maximiert alle Spaltengruppen bis zur angegebenen Tiefe und minimiert alle anderen.

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

// All column groups of depth 2 and lower are expanded, and groups with depth
// 3 and higher are collapsed.
sheet.expandColumnGroupsUpToDepth(2);

Parameter

Name	Typ	Beschreibung
`groupDepth`	`Integer`	Die Gruppentiefe, bis zu der die Spaltengruppen maximiert werden sollen.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`expandRowGroupsUpToDepth(groupDepth)`

Maximiert alle Zeilengruppen bis zur angegebenen Tiefe und minimiert alle anderen.

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

// All row groups of depth 2 and lower are expanded, and groups with depth
// 3 and higher are collapsed.
sheet.expandRowGroupsUpToDepth(2);

Parameter

Name	Typ	Beschreibung
`groupDepth`	`Integer`	Die Gruppentiefe, bis zu der die Zeilengruppen maximiert werden sollen.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`getActiveCell()`

Gibt die aktive Zelle in diesem Tabellenblatt zurück.

Hinweis:Es ist besser, getCurrentCell() zu verwenden, da damit die aktuell markierte Zelle zurückgegeben wird.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Returns the active cell
const cell = sheet.getActiveCell();

Rückflug

Range: Die aktuell aktive Zelle.

Autorisierung

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

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

`getActiveRange()`

Gibt den ausgewählten Bereich im aktiven Tabellenblatt zurück oder null, wenn kein aktiver Bereich vorhanden ist. Wenn mehrere Bereiche ausgewählt sind, wird mit dieser Methode nur der zuletzt ausgewählte Bereich zurückgegeben.

Der Begriff „aktiver Bereich“ bezieht sich auf den Bereich, den ein Nutzer im aktiven Tabellenblatt ausgewählt hat. In einer benutzerdefinierten Funktion bezieht er sich auf die Zelle, die aktiv neu berechnet wird.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const activeRange = sheet.getActiveRange();

Rückflug

Range: Der aktive Bereich.

Autorisierung

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

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

Weitere Informationen

setActiveRange(range)

`getActiveRangeList()`

Gibt die Liste der aktiven Bereiche im aktiven Tabellenblatt oder null zurück, wenn keine aktiven Bereiche vorhanden sind.

Wenn ein einzelner Bereich ausgewählt ist, verhält sich das wie ein getActiveRange()-Aufruf.

const sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
const activeRangeList = sheet.getActiveRangeList();

Rückflug

RangeList: Die Liste der aktiven Bereiche.

Autorisierung

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

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

Weitere Informationen

setActiveRangeList(rangeList)

`getBandings()`

Gibt alle Bandings in diesem Tabellenblatt 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

// Gets info on the bandings' second row color and logs it to the console.
for (const banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Rückflug

Banding[]: Alle Bandings in diesem Tabellenblatt.

Autorisierung

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

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

`getCharts()`

Gibt ein Array von Diagrammen auf diesem Tabellenblatt zurück.

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

for (const i in charts) {
  const chart = charts[i];
  // Do something with the chart
}

Rückflug

EmbeddedChart[]: Ein Array von Diagrammen.

Autorisierung

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

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

`getColumnGroup(columnIndex, groupDepth)`

Gibt die Spaltengruppe mit dem angegebenen Index und der angegebenen Gruppentiefe zurück.

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

// Returns the group whose control index is at column 2 and has a depth of 1, or
// null if the group doesn’t exist.
const columnGroup = sheet.getColumnGroup(2, 1);

Parameter

Name	Typ	Beschreibung
`columnIndex`	`Integer`	Der Spaltenindex des Umschalters für die Gruppensteuerung oder ein Index innerhalb der Gruppe.
`groupDepth`	`Integer`	Die Tiefe der Gruppe.

Rückflug

Group: Die Spaltengruppe mit dem Kontrollindex und der Tiefe. Wenn die Gruppe nicht vorhanden ist, wird eine Ausnahme ausgelöst.

Autorisierung

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

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

`getColumnGroupControlPosition()`

Gibt die GroupControlTogglePosition für alle Spaltengruppen im Tabellenblatt zurück.

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

// GroupControlTogglePosition.AFTER if the column grouping control toggle is
// shown after the group.
const columnGroupControlPosition = sheet.getColumnGroupControlPosition();

Rückflug

GroupControlTogglePosition – true, wenn die Ein/Aus-Schaltfläche für die Spaltengruppierung nach der Gruppe auf diesem Tabellenblatt angezeigt wird, und false andernfalls.

Autorisierung

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

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

`getColumnGroupDepth(columnIndex)`

Gibt die Gruppierungstiefe der Spalte am angegebenen Index zurück.

Die Gruppentiefe gibt an, wie viele Gruppen sich mit der Spalte überschneiden. Der Wert kann zwischen 0 und 8 liegen.

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

// 1 if there is a group over columns 1 through 3
const groupDepth = sheet.getColumnGroupDepth(1);

Parameter

Name	Typ	Beschreibung
`columnIndex`	`Integer`	Der Index der Spalte.

Rückflug

Integer – Die Gruppentiefe der Spalte am angegebenen Index.

Autorisierung

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

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

`getColumnWidth(columnPosition)`

Gibt die Breite der angegebenen Spalte in Pixeln zurück.

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

// Columns start at 1
Logger.log(sheet.getColumnWidth(1));

Parameter

Name	Typ	Beschreibung
`columnPosition`	`Integer`	Die Position der zu untersuchenden Spalte.

Rückflug

Integer – Spaltenbreite in Pixeln.

Autorisierung

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

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

`getConditionalFormatRules()`

Alle Regeln für die bedingte Formatierung in diesem Tabellenblatt abrufen.

// Logs the conditional format rules in a sheet.
const rules = SpreadsheetApp.getActiveSheet().getConditionalFormatRules();
for (let i = 0; i < rules.length; i++) {
  const rule = rules[i];
  Logger.log(rule);
}

Rückflug

ConditionalFormatRule[]: Ein Array mit allen Regeln im Tabellenblatt.

Autorisierung

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

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

`getCurrentCell()`

Gibt die aktuelle Zelle im aktiven Tabellenblatt oder null zurück, wenn keine aktuelle Zelle vorhanden ist. Die aktuelle Zelle ist die Zelle, die in der Google Tabellen-Benutzeroberfläche den Fokus hat und durch einen dunklen Rahmen hervorgehoben wird. Es gibt immer nur eine aktuelle Zelle. Wenn ein Nutzer einen oder mehrere Zellbereiche auswählt, ist eine der Zellen in der Auswahl die aktuelle Zelle.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
// Returns the current highlighted cell in the one of the active ranges.
const currentCell = sheet.getCurrentCell();

Rückflug

Range: Die aktuelle Zelle.

Autorisierung

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

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

`getDataRange()`

Gibt ein Range zurück, das den Dimensionen entspricht, in denen Daten vorhanden sind.

Dies entspricht funktional dem Erstellen eines Bereichs, der durch A1 und (Sheet.getLastColumn(), Sheet.getLastRow()) begrenzt wird.

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

// This represents ALL the data
const range = sheet.getDataRange();
const values = range.getValues();

// This logs the spreadsheet in CSV format with a trailing comma
for (let i = 0; i < values.length; i++) {
  let row = '';
  for (let j = 0; j < values[i].length; j++) {
    if (values[i][j]) {
      row = row + values[i][j];
    }
    row = `${row},`;
  }
  Logger.log(row);
}

Rückflug

Range: Ein Bereich, der alle Daten in der Tabelle enthält.

Autorisierung

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

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

`getDataSourceFormulas()`

Ruft alle Datenquellenformeln ab.

// Opens the spreadsheet by its ID. If you created your script from within 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 an array of the data source formulas on Sheet1.
// To get an array of data source formulas for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceFormulas = sheet.getDataSourceFormulas();

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

Rückflug

DataSourceFormula[]: Eine Liste mit Datenquellenformeln.

Autorisierung

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

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

`getDataSourcePivotTables()`

Ruft alle Pivot-Tabellen der Datenquelle ab.

// 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 an array of the data source pivot tables on Sheet1.
// To get an array of data source pivot tables for the entire
// spreadsheet, replace 'sheet' with 'ss'.
const dataSourcePivotTables = sheet.getDataSourcePivotTables();

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

Rückflug

DataSourcePivotTable[]: Eine Liste mit Pivot-Tabellen für Datenquellen.

Autorisierung

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

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

`getDataSourceTables()`

Ruft alle Datenquellentabellen ab.

// 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 an array of data source tables on Sheet1.
// To get an array of data source tables for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceTables = sheet.getDataSourceTables();

// Logs the last completed data execution time on the first data source table.
console.log(dataSourceTables[0].getStatus().getLastExecutionTime());

Rückflug

DataSourceTable[]: Eine Liste der Datenquellentabellen.

Autorisierung

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

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

`getDeveloperMetadata()`

Ruft alle Entwicklermetadaten ab, die mit diesem Tabellenblatt verknüpft sind.

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds developer metadata for testing.
sheet.addDeveloperMetadata('CITY', 'PARIS');

// Gets all the developer metadata for the sheet.
const developerMetaDataList = sheet.getDeveloperMetadata();

// Logs the developer metadata to the console.
for (const developerMetaData of developerMetaDataList) {
  console.log(developerMetaData.getKey());
}

Rückflug

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

Autorisierung

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

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

`getDrawings()`

Gibt ein Array von Zeichnungen auf dem Tabellenblatt 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all the drawings from the sheet.
const allDrawings = sheet.getDrawings();

// Logs the number of drawings present on the sheet.
console.log(allDrawings.length);

Rückflug

Drawing[]: Die Liste der Zeichnungen auf diesem Blatt.

Autorisierung

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

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

`getFilter()`

Gibt den Filter in diesem Tabellenblatt zurück oder null, wenn kein Filter vorhanden ist.

// Gets the filter on the active sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();

Rückflug

Filter: Der Filter.

Autorisierung

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

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

`getFormUrl()`

Gibt die URL für das Formular zurück, dessen Antworten an dieses Tabellenblatt gesendet werden, oder null, wenn diesem Tabellenblatt kein Formular zugeordnet ist. Löst eine Ausnahme aus, wenn der Nutzer keine Berechtigung zum Bearbeiten der Tabelle hat.

const sheet = SpreadsheetApp.getActiveSheet();
const url = sheet.getFormUrl();

Rückflug

String: Die URL des Formulars, dessen Antworten in dieser Tabelle gespeichert werden, oder null, wenn dieser Tabelle kein Formular zugeordnet ist.

Autorisierung

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

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

`getFrozenColumns()`

Gibt die Anzahl der fixierten Spalten zurück.

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

Logger.log('Number of frozen columns: %s', sheet.getFrozenColumns());

Rückflug

Integer – Die Anzahl der fixierten Spalten.

Autorisierung

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

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

`getFrozenRows()`

Gibt die Anzahl der fixierten Zeilen zurück.

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

Logger.log('Number of frozen rows: %s', sheet.getFrozenRows());

Rückflug

Integer: Die Anzahl der fixierten Zeilen.

Autorisierung

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

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

`getImages()`

Gibt alle Bilder zurück, die sich nicht in Zellen befinden.

// Opens the spreadsheet file 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 over-the-grid images from Sheet1.
// To get the over-the-grid images from the entire spreadsheet, use
// ss.getImages() instead.
const images = sheet.getImages();

// For each image, logs the anchor cell in A1 notation.
for (const image of images) {
  console.log(image.getAnchorCell().getA1Notation());
}

Rückflug

OverGridImage[]: Ein Array mit über das Raster gelegten Bildern.

Autorisierung

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

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

`getIndex()`

Gibt die Position des Tabellenblatts in der übergeordneten Tabelle zurück. Beginnt mit 1.

const ss = SpreadsheetApp.getActiveSpreadsheet();
// Note that the JavaScript index is 0, but this logs 1
const sheet = ss.getSheets()[0];
// ... because spreadsheets are 1-indexed
Logger.log(sheet.getIndex());

Rückflug

Integer: Die Position des Tabellenblatts in der übergeordneten Tabelle.

Autorisierung

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

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

`getLastColumn()`

Gibt die Position der letzten Spalte mit Inhalt zurück.

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

// This logs the value in the very last cell of this sheet
const lastRow = sheet.getLastRow();
const lastColumn = sheet.getLastColumn();
const lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Rückflug

Integer: Die letzte Spalte des Tabellenblatts, die Inhalt enthält.

Autorisierung

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

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

`getLastRow()`

Gibt die Position der letzten Zeile mit Inhalt zurück.

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

// This logs the value in the very last cell of this sheet
const lastRow = sheet.getLastRow();
const lastColumn = sheet.getLastColumn();
const lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Rückflug

Integer: Die letzte Zeile des Blatts, die Inhalt enthält.

Autorisierung

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

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

`getMaxColumns()`

Gibt die aktuelle Anzahl der Spalten im Tabellenblatt zurück, unabhängig vom Inhalt.

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
Logger.log(first.getMaxColumns());

Rückflug

Integer – Die maximale Breite des Tabellenblatts.

Autorisierung

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

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

`getMaxRows()`

Gibt die aktuelle Anzahl der Zeilen im Tabellenblatt zurück, unabhängig vom Inhalt.

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
Logger.log(first.getMaxRows());

Rückflug

Integer: Die maximale Höhe des Tabellenblatts.

Autorisierung

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

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

`getName()`

Gibt den Namen des Tabellenblatts zurück.

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

Rückflug

String: Der Name des Tabellenblatts.

Autorisierung

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

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

`getNamedRanges()`

Ruft alle benannten Bereiche in diesem Tabellenblatt ab.

// The code below logs the name of the first named range.
const namedRanges = SpreadsheetApp.getActiveSheet().getNamedRanges();
if (namedRanges.length > 1) {
  Logger.log(namedRanges[0].getName());
}

Rückflug

NamedRange[]: Ein Array mit allen benannten Bereichen im Tabellenblatt.

Autorisierung

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

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

`getParent()`

Gibt die Spreadsheet zurück, die dieses Tabellenblatt enthält.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// parent is identical to ss
const parent = sheet.getParent();

Rückflug

Spreadsheet: Die übergeordnete Tabelle.

Autorisierung

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

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

`getPivotTables()`

Gibt alle Pivot-Tabellen in diesem Tabellenblatt 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all the pivot table info for the sheet.
const pivotTables = sheet.getPivotTables();

// Logs the pivot tables to the console.
for (const pivotTable of pivotTables) {
  console.log(pivotTable.getSourceDataRange().getValues());
}

Rückflug

PivotTable[]: Die Pivot-Tabellen auf diesem Tabellenblatt.

Autorisierung

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

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

`getProtections(type)`

Ruft ein Array von Objekten ab, die alle geschützten Bereiche im Tabellenblatt darstellen, oder ein Array mit einem Element, das den Schutz des Tabellenblatts selbst darstellt.

// Remove all range protections in the spreadsheet that the user has permission
// to edit.
const sheet = SpreadsheetApp.getActiveSheet();
const protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (let i = 0; i < protections.length; i++) {
  const protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

// Remove sheet protection from the active sheet, if the user has permission to
// edit it.
const sheet = SpreadsheetApp.getActiveSheet();
const protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0];
if (protection?.canEdit()) {
  protection.remove();
}

Parameter

Name	Typ	Beschreibung
`type`	`ProtectionType`	Der Typ des Schutzgebiets, entweder `SpreadsheetApp.ProtectionType.RANGE` oder `SpreadsheetApp.ProtectionType.SHEET`.

Rückflug

Protection[]: Ein Array von Objekten, das alle geschützten Bereiche im Tabellenblatt darstellt, oder ein Array mit einem Element, das den Schutz des Tabellenblatts selbst darstellt.

Autorisierung

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

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

`getRange(row, column)`

Gibt den Bereich mit der Zelle oben links an den angegebenen Koordinaten zurück.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Passing only two arguments returns a "range" with a single cell.
const range = sheet.getRange(1, 1);
const values = range.getValues();
Logger.log(values[0][0]);

Parameter

Name	Typ	Beschreibung
`row`	`Integer`	Der Zeilenindex der Zelle, die zurückgegeben werden soll. Die Zeilenindexierung beginnt mit 1.
`column`	`Integer`	Der Spaltenindex der Zelle, die zurückgegeben werden soll. Die Spaltenindexierung beginnt mit 1.

Rückflug

Range: Ein Bereich, der nur diese Zelle enthält.

Autorisierung

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

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

`getRange(row, column, numRows)`

Gibt den Bereich mit der Zelle oben links an den angegebenen Koordinaten und mit der angegebenen Anzahl von Zeilen zurück.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// When the "numRows" argument is used, only a single column of data is
// returned.
const range = sheet.getRange(1, 1, 3);
const values = range.getValues();

// Prints 3 values from the first column, starting from row 1.
for (const row in values) {
  for (const col in values[row]) {
    Logger.log(values[row][col]);
  }
}

Parameter

Name	Typ	Beschreibung
`row`	`Integer`	Der Startzeilenindex des Bereichs. Die Zeilenindexierung beginnt mit 1.
`column`	`Integer`	Der Spaltenindex des Bereichs. Die Spaltenindexierung beginnt mit 1.
`numRows`	`Integer`	Die Anzahl der zurückzugebenden Zeilen.

Rückflug

Range: Ein Bereich mit einer einzelnen Datenspalte mit der angegebenen Anzahl von Zeilen.

Autorisierung

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

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

`getRange(row, column, numRows, numColumns)`

Gibt den Bereich mit der Zelle oben links an den angegebenen Koordinaten mit der angegebenen Anzahl von Zeilen und Spalten zurück.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange(1, 1, 3, 3);
const values = range.getValues();

// Print values from a 3x3 box.
for (const row in values) {
  for (const col in values[row]) {
    Logger.log(values[row][col]);
  }
}

Parameter

Name	Typ	Beschreibung
`row`	`Integer`	Der Startzeilenindex des Bereichs. Die Zeilenindexierung beginnt mit 1.
`column`	`Integer`	Der Startspaltenindex des Bereichs. Die Spaltenindexierung beginnt mit 1.
`numRows`	`Integer`	Die Anzahl der zurückzugebenden Zeilen.
`numColumns`	`Integer`	Die Anzahl der zurückzugebenden Spalten.

Rückflug

Range: Ein Bereich, der dem angegebenen Gebiet entspricht.

Autorisierung

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

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

`getRange(a1Notation)`

Gibt den Bereich in A1- oder R1C1-Notation zurück.

// Get a range A1:D4 on sheet titled "Invoices"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const range = ss.getRange('Invoices!A1:D4');

// Get cell A1 on the first sheet
const sheet = ss.getSheets()[0];
const cell = sheet.getRange('A1');

Parameter

Name	Typ	Beschreibung
`a1Notation`	`String`	Der zurückzugebende Bereich in A1- oder R1C1-Notation.

Rückflug

Range: Die Reichweite am angegebenen Standort.

Autorisierung

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

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

`getRangeList(a1Notations)`

Gibt die RangeList-Sammlung zurück, die die Bereiche im selben Tabellenblatt darstellt, die durch eine nicht leere Liste von A1- oder R1C1-Notationen angegeben werden.

// Get a list of ranges A1:D4, F1:H4.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);

Parameter

Name	Typ	Beschreibung
`a1Notations`	`String[]`	Die Liste der Bereiche, die zurückgegeben werden sollen, angegeben in A1- oder R1C1-Notation.

Rückflug

RangeList: Die Bereichsliste am angegebenen Ort.

Autorisierung

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

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

`getRowGroup(rowIndex, groupDepth)`

Gibt die Zeilengruppe mit dem angegebenen Index und der angegebenen Gruppentiefe zurück.

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

// Returns the group whose control index is at row 2 and has a depth of 1, or
// null if the group doesn’t exist.
const rowGroup = sheet.getRowGroup(2, 1);

Parameter

Name	Typ	Beschreibung
`rowIndex`	`Integer`	Der Zeilenindex des Umschalters für die Gruppensteuerung oder ein Index innerhalb der Gruppe.
`groupDepth`	`Integer`	Die Tiefe der Gruppe.

Rückflug

Group: Die Zeilengruppe mit dem Kontrollindex und der Tiefe. Es wird eine Ausnahme ausgelöst, wenn die Gruppe nicht vorhanden ist.

Autorisierung

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

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

`getRowGroupControlPosition()`

Gibt die GroupControlTogglePosition für alle Zeilengruppen im Tabellenblatt zurück.

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

// GroupControlTogglePosition.AFTER if the row grouping control toggle is shown
// after the group.
const rowGroupControlPosition = sheet.getRowGroupControlPosition();

Rückflug

GroupControlTogglePosition – true, wenn das Ein/Aus-Umschaltfeld für die Zeilengruppierung nach der Gruppe auf diesem Tabellenblatt angezeigt wird, und false andernfalls.

Autorisierung

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

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

`getRowGroupDepth(rowIndex)`

Gibt die Gruppierungstiefe der Zeile am angegebenen Index zurück.

Die Gruppentiefe gibt an, wie viele Gruppen sich mit der Zeile überschneiden. Der Wert kann zwischen 0 und 8 liegen.

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

// 1 if there is a group over rows 1 through 3
const groupDepth = sheet.getRowGroupDepth(1);

Parameter

Name	Typ	Beschreibung
`rowIndex`	`Integer`	Der Index der Zeile.

Rückflug

Integer – Die Gruppentiefe der Zeile am angegebenen Index.

Autorisierung

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

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

`getRowHeight(rowPosition)`

Gibt die Höhe der angegebenen Zeile in Pixeln zurück.

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

// Rows start at 1
Logger.log(sheet.getRowHeight(1));

Parameter

Name	Typ	Beschreibung
`rowPosition`	`Integer`	Die Position der zu untersuchenden Zeile.

Rückflug

Integer – Zeilenhöhe in Pixeln.

Autorisierung

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

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

`getSelection()`

Gibt die aktuelle Selection in der Tabelle zurück.

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
const currentCell = selection.getCurrentCell();

Rückflug

Selection: Die aktuelle Auswahl.

Autorisierung

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

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

`getSheetId()`

Gibt die ID des Tabellenblatts zurück, das durch dieses Objekt dargestellt wird.

Dies ist eine ID für das Tabellenblatt, die für die Tabelle eindeutig ist. Die ID ist eine monoton steigende Ganzzahl, die bei der Erstellung des Tabellenblatts zugewiesen wird und unabhängig von der Position des Tabellenblatts ist. Das ist in Verbindung mit Methoden wie Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd) nützlich, die einen gridId-Parameter anstelle einer Sheet-Instanz verwenden.

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

Logger.log(sheet.getSheetId());

Rückflug

Integer: Eine ID für das Tabellenblatt, die für die Tabelle eindeutig ist.

Autorisierung

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

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

`getSheetName()`

Gibt den Namen des Tabellenblatts zurück.

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

Logger.log(sheet.getSheetName());

Rückflug

String: Der Name des Tabellenblatts.

Autorisierung

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

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

`getSheetValues(startRow, startColumn, numRows, numColumns)`

Gibt das rechteckige Raster von Werten für diesen Bereich zurück, beginnend mit den angegebenen Koordinaten. Ein Wert von -1 für die Zeilen- oder Spaltenposition entspricht der letzten Zeile oder Spalte mit Daten im Tabellenblatt.

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

// The two samples below produce the same output
let values = sheet.getSheetValues(1, 1, 3, 3);
Logger.log(values);

const range = sheet.getRange(1, 1, 3, 3);
values = range.getValues();
Logger.log(values);

Parameter

Name	Typ	Beschreibung
`startRow`	`Integer`	Die Position der Startzeile.
`startColumn`	`Integer`	Die Position der Startspalte.
`numRows`	`Integer`	Die Anzahl der Zeilen, für die Werte zurückgegeben werden sollen.
`numColumns`	`Integer`	Die Anzahl der Spalten, für die Werte zurückgegeben werden sollen.

Rückflug

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

Autorisierung

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

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

`getSlicers()`

Gibt ein Array von Slicern im Tabellenblatt 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all slicers in the spreadsheet.
const slicers = sheet.getSlicers();

// Logs the slicer titles to the console.
for (const slicer of slicers) {
  console.log(slicer.getTitle());
}

Rückflug

Slicer[]: Die Liste der Slicer auf diesem Tabellenblatt.

Autorisierung

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

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

`getTabColorObject()`

Gibt die Farbe des Tabellenblatt-Tabs zurück oder null, wenn der Tabellenblatt-Tab keine Farbe hat.

// This example assumes there is a sheet named "Sheet1"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('Sheet1');
const color = first.getTabColorObject();

Rückflug

Color: Die Farbe des Tabellenblatt-Tabs oder null, wenn der Tabellenblatt-Tab keine Farbe hat.

Autorisierung

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

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

`getType()`

Gibt den Typ des Tabellenblatts zurück.

Der Standardtyp von Tabellenblatt ist SheetType.GRID. Ein Tabellenblatt, das ein einzelnes eingebettetes Objekt wie ein EmbeddedChart enthält, ist ein SheetType.OBJECT-Tabellenblatt.

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

Rückflug

SheetType: Der Typ des Tabellenblatts.

Autorisierung

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

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

`hasHiddenGridlines()`

Gibt true zurück, wenn die Tabellengitterlinien ausgeblendet sind. Andernfalls wird false zurückgegeben. Standardmäßig sind Gitternetzlinien sichtbar.

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Checks if the spreadsheet has hidden gridelines and logs the result to the
// console.
console.log(sheet.hasHiddenGridlines());

Rückflug

Boolean: true, wenn die Rasterlinien ausgeblendet sind, andernfalls false.

Autorisierung

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

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

`hideColumn(column)`

Blendet die Spalte(n) im angegebenen Bereich aus.

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

// This hides the first column
let range = sheet.getRange('A1');
sheet.hideColumn(range);

// This hides the first 3 columns
range = sheet.getRange('A:C');
sheet.hideColumn(range);

Parameter

Name	Typ	Beschreibung
`column`	`Range`	Der Spaltenbereich, der ausgeblendet werden soll.

Autorisierung

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

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

`hideColumns(columnIndex)`

Blendet eine einzelne Spalte am angegebenen Index aus. Verwenden Sie für diese Methode den 1-Index.

Wenn Sie mehrere Spalten mithilfe eines Index ausblenden möchten, verwenden Sie hideColumns(columnIndex, numColumns).

Wenn Sie mehrere Spalten mithilfe eines Bereichs ausblenden möchten, verwenden Sie hideColumn().

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Hides the first column
sheet.hideColumns(1);

Parameter

Name	Typ	Beschreibung
`columnIndex`	`Integer`	Der Index der auszublendenden Spalte.

Autorisierung

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

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

`hideColumns(columnIndex, numColumns)`

Blendet eine oder mehrere aufeinanderfolgende Spalten ab dem angegebenen Index aus. Verwenden Sie für diese Methode den 1-Index.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Hides the first three columns
sheet.hideColumns(1, 3);

Parameter

Name	Typ	Beschreibung
`columnIndex`	`Integer`	Der Startindex der Spalten, die ausgeblendet werden sollen.
`numColumns`	`Integer`	Die Anzahl der auszublendenden Spalten.

Autorisierung

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

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

`hideRow(row)`

Blendet die Zeilen im angegebenen Bereich aus.

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

// This hides the first row
const range = sheet.getRange('A1');
sheet.hideRow(range);

Parameter

Name	Typ	Beschreibung
`row`	`Range`	Der Zeilenbereich, der ausgeblendet werden soll.

Autorisierung

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

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

`hideRows(rowIndex)`

Blendet die Zeile am angegebenen Index aus.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Hides the first row
sheet.hideRows(1);

Parameter

Name	Typ	Beschreibung
`rowIndex`	`Integer`	Der Index der auszublendenden Zeile.

Autorisierung

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

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

`hideRows(rowIndex, numRows)`

Blendet eine oder mehrere aufeinanderfolgende Zeilen ab dem angegebenen Index aus.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Hides the first three rows
sheet.hideRows(1, 3);

Parameter

Name	Typ	Beschreibung
`rowIndex`	`Integer`	Der Startindex der auszublendenden Zeilen.
`numRows`	`Integer`	Die Anzahl der auszublendenden Zeilen.

Autorisierung

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

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

`hideSheet()`

Blendet dieses Tabellenblatt aus. Hat keine Auswirkungen, wenn das Tabellenblatt bereits ausgeblendet ist. Wenn diese Methode für das einzige sichtbare Tabellenblatt aufgerufen wird, wird eine Ausnahme ausgelöst.

const sheet = SpreadsheetApp.getActiveSheet();
sheet.hideSheet();

Rückflug

Sheet: Das aktuelle Tabellenblatt.

Autorisierung

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

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

`insertChart(chart)`

Fügt diesem Tabellenblatt ein neues Diagramm hinzu.

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

// This creates a simple bar chart from the first three rows
// of the first two columns of the spreadsheet
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B4'))
                  .setPosition(5, 5, 0, 0)
                  .setOption('title', 'Dynamic Chart')
                  .build();
sheet.insertChart(chart);

Parameter

Name	Typ	Beschreibung
`chart`	`EmbeddedChart`	Das einzufügende Diagramm.

Autorisierung

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

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

`insertColumnAfter(afterPosition)`

Fügt eine Spalte nach der angegebenen Spaltenposition ein.

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

// This inserts a column after the first column position
sheet.insertColumnAfter(1);

Parameter

Name	Typ	Beschreibung
`afterPosition`	`Integer`	Die Spalte, nach der die neue Spalte eingefügt werden soll.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`insertColumnBefore(beforePosition)`

Fügt eine Spalte vor der angegebenen Spaltenposition ein.

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

// This inserts a column in the first column position
sheet.insertColumnBefore(1);

Parameter

Name	Typ	Beschreibung
`beforePosition`	`Integer`	Die Spalte, vor der die neue Spalte eingefügt werden soll.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`insertColumns(columnIndex)`

Fügt eine leere Spalte an der angegebenen Position in ein Tabellenblatt ein.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Shifts all columns by one
sheet.insertColumns(1);

Parameter

Name	Typ	Beschreibung
`columnIndex`	`Integer`	Der Index, der angibt, wo eine Spalte eingefügt werden soll.

Autorisierung

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

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

`insertColumns(columnIndex, numColumns)`

Fügt ab der angegebenen Position eine oder mehrere aufeinanderfolgende leere Spalten in ein Tabellenblatt ein.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Shifts all columns by three
sheet.insertColumns(1, 3);

Parameter

Name	Typ	Beschreibung
`columnIndex`	`Integer`	Der Index, der angibt, wo eine Spalte eingefügt werden soll.
`numColumns`	`Integer`	Die Anzahl der einzufügenden Spalten.

Autorisierung

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

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

`insertColumnsAfter(afterPosition, howMany)`

Fügt nach der angegebenen Spaltenposition eine bestimmte Anzahl von Spalten ein.

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

// Inserts two columns after the first column on the first sheet of the
// spreadsheet.
sheet.insertColumnsAfter(1, 2);

Parameter

Name	Typ	Beschreibung
`afterPosition`	`Integer`	Die Spalte, nach der die neue Spalte eingefügt werden soll.
`howMany`	`Integer`	Die Anzahl der einzufügenden Spalten.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`insertColumnsBefore(beforePosition, howMany)`

Fügt eine bestimmte Anzahl von Spalten vor der angegebenen Spaltenposition ein.

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

// This inserts five columns before the first column
sheet.insertColumnsBefore(1, 5);

Parameter

Name	Typ	Beschreibung
`beforePosition`	`Integer`	Die Spalte, vor der die neue Spalte eingefügt werden soll.
`howMany`	`Integer`	Die Anzahl der einzufügenden Spalten.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`insertImage(blobSource, column, row)`

Fügt ein BlobSource als Bild in das Dokument in einer bestimmten Zeile und Spalte ein. Die Bildgröße wird aus dem Blob-Inhalt abgerufen. Die maximal unterstützte Blob-Größe beträgt 2 MB.

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

const binaryData = [];  // TODO(developer): Replace with your binary data.
const blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1);

Parameter

Name	Typ	Beschreibung
`blobSource`	`BlobSource`	Das Blob mit dem Bildinhalt, dem MIME-Typ und optional dem Namen.
`column`	`Integer`	Die Spaltenposition.
`row`	`Integer`	Die Zeilenposition.

Rückflug

OverGridImage: Das eingefügte Bild.

Autorisierung

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

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

`insertImage(blobSource, column, row, offsetX, offsetY)`

Fügt ein BlobSource als Bild in das Dokument in einer bestimmten Zeile und Spalte mit einem Pixel-Offset ein. Die Bildgröße wird aus dem Blob-Inhalt abgerufen. Die maximal unterstützte Blob-Größe beträgt 2 MB.

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

const binaryData = [];  // TODO(developer): Replace with your binary data.
const blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1, 10, 10);

Parameter

Name	Typ	Beschreibung
`blobSource`	`BlobSource`	Das Blob mit dem Bildinhalt, dem MIME-Typ und optional dem Namen.
`column`	`Integer`	Die Spaltenposition.
`row`	`Integer`	Die Zeilenposition.
`offsetX`	`Integer`	Der horizontale Offset von der Zellenecke in Pixeln.
`offsetY`	`Integer`	Der vertikale Offset von der Zellenecke in Pixeln.

Rückflug

OverGridImage: Das eingefügte Bild.

Autorisierung

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

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

`insertImage(url, column, row)`

Fügt ein Bild in das Dokument in einer bestimmten Zeile und Spalte ein.

Die angegebene URL muss öffentlich zugänglich sein.

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

sheet.insertImage('https://www.google.com/images/srpr/logo3w.png', 1, 1);

Parameter

Name	Typ	Beschreibung
`url`	`String`	Die URL des Bildes.
`column`	`Integer`	Die Position der Spalte im Raster.
`row`	`Integer`	Die Position der Rasterzeile.

Rückflug

OverGridImage: Das eingefügte Bild.

Autorisierung

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

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

`insertImage(url, column, row, offsetX, offsetY)`

Fügt ein Bild mit einem Pixel-Offset in das Dokument an einer bestimmten Zeile und Spalte ein.

Die angegebene URL muss öffentlich zugänglich sein.

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

sheet.insertImage(
    'https://www.google.com/images/srpr/logo3w.png',
    1,
    1,
    10,
    10,
);

Parameter

Name	Typ	Beschreibung
`url`	`String`	Die URL für das Bild.
`column`	`Integer`	Die Spaltenposition.
`row`	`Integer`	Die Zeilenposition.
`offsetX`	`Integer`	Der horizontale Offset von der Zellenecke in Pixeln.
`offsetY`	`Integer`	Der vertikale Offset von der Zellenecke in Pixeln.

Rückflug

OverGridImage: Das eingefügte Bild.

Autorisierung

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

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

`insertRowAfter(afterPosition)`

Fügt eine Zeile nach der angegebenen Zeilenposition ein.

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

// This inserts a row after the first row position
sheet.insertRowAfter(1);

Parameter

Name	Typ	Beschreibung
`afterPosition`	`Integer`	Die Zeile, nach der die neue Zeile eingefügt werden soll.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`insertRowBefore(beforePosition)`

Fügt eine Zeile vor der angegebenen Zeilenposition ein.

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

// This inserts a row before the first row position
sheet.insertRowBefore(1);

Parameter

Name	Typ	Beschreibung
`beforePosition`	`Integer`	Die Zeile, vor der die neue Zeile eingefügt werden soll.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`insertRows(rowIndex)`

Fügt an der angegebenen Stelle eine leere Zeile in ein Tabellenblatt ein.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Shifts all rows down by one
sheet.insertRows(1);

Parameter

Name	Typ	Beschreibung
`rowIndex`	`Integer`	Der Index, der angibt, wo eine Zeile eingefügt werden soll.

Autorisierung

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

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

`insertRows(rowIndex, numRows)`

Fügt ab der angegebenen Position eine oder mehrere aufeinanderfolgende leere Zeilen in ein Tabellenblatt ein.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Shifts all rows down by three
sheet.insertRows(1, 3);

Parameter

Name	Typ	Beschreibung
`rowIndex`	`Integer`	Der Index, der angibt, wo eine Zeile eingefügt werden soll.
`numRows`	`Integer`	Die Anzahl der einzufügenden Zeilen.

Autorisierung

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

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

`insertRowsAfter(afterPosition, howMany)`

Fügt nach der angegebenen Zeilenposition eine bestimmte Anzahl von Zeilen ein.

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

// This inserts five rows after the first row
sheet.insertRowsAfter(1, 5);

Parameter

Name	Typ	Beschreibung
`afterPosition`	`Integer`	Die Zeile, nach der die neuen Zeilen eingefügt werden sollen.
`howMany`	`Integer`	Die Anzahl der einzufügenden Zeilen.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`insertRowsBefore(beforePosition, howMany)`

Fügt eine bestimmte Anzahl von Zeilen vor der angegebenen Zeilenposition ein.

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

// This inserts five rows before the first row
sheet.insertRowsBefore(1, 5);

Parameter

Name	Typ	Beschreibung
`beforePosition`	`Integer`	Die Zeile, vor der die neuen Zeilen eingefügt werden sollen.
`howMany`	`Integer`	Die Anzahl der einzufügenden Zeilen.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`insertSlicer(range, anchorRowPos, anchorColPos)`

Fügt diesem Tabellenblatt einen neuen Slicer hinzu.

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

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

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

// Inserts the slicer with a random range into the sheet.
const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10);

// Logs the insert slicer result to the console.
console.log(insertSlicers);

Parameter

Name	Typ	Beschreibung
`range`	`Range`	Der Bereich, für den der Datenschnitt erstellt wird.
`anchorRowPos`	`Integer`	Die Oberseite des Slicers ist in dieser Zeile verankert.
`anchorColPos`	`Integer`	Die Oberseite des Slicers ist in dieser Spalte verankert.

Rückflug

Slicer: Der neu eingefügte Datenschnitt.

Autorisierung

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

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

`insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)`

Fügt diesem Tabellenblatt einen neuen Slicer hinzu.

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

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

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

// Inserts a slicer using the random range function.
const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10, 0, 0);

// Logs the insert slicer result to the console.
console.log(insertSlicers);

Parameter

Name	Typ	Beschreibung
`range`	`Range`	Der Bereich, für den der Datenschnitt erstellt wird.
`anchorRowPos`	`Integer`	Die Oberseite des Slicers ist in dieser Zeile verankert.
`anchorColPos`	`Integer`	Die Oberseite des Slicers ist in dieser Spalte verankert.
`offsetX`	`Integer`	Der horizontale Offset von der Zellenecke in Pixeln.
`offsetY`	`Integer`	Der vertikale Offset von der Zellenecke in Pixeln.

Rückflug

Slicer: Der neu eingefügte Datenschnitt.

Autorisierung

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

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

`isColumnHiddenByUser(columnPosition)`

Gibt zurück, ob die angegebene Spalte vom Nutzer ausgeblendet wurde.

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

// Columns start at 1
Logger.log(sheet.isColumnHiddenByUser(1));

Parameter

Name	Typ	Beschreibung
`columnPosition`	`Integer`	Die Position der zu untersuchenden Spalte.

Rückflug

Boolean – true, wenn die Spalte ausgeblendet ist, andernfalls false.

Autorisierung

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

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

`isRightToLeft()`

Gibt true zurück, wenn das Tabellenblattlayout von rechts nach links ist. Gibt false zurück, wenn für das Tabellenblatt das standardmäßige Layout von links nach rechts verwendet wird.

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Checks if a spreadsheet is ordered from right to left and logs the result to
// the console.
console.log(sheet.isRightToLeft());

Rückflug

Boolean: true, wenn die Leserichtung von rechts nach links ist, andernfalls false.

Autorisierung

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

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

`isRowHiddenByFilter(rowPosition)`

Gibt zurück, ob die angegebene Zeile durch einen Filter (nicht durch eine Filteransicht) ausgeblendet wird.

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

// Rows start at 1
Logger.log(sheet.isRowHiddenByFilter(1));

Parameter

Name	Typ	Beschreibung
`rowPosition`	`Integer`	Die Position der zu untersuchenden Zeile.

Rückflug

Boolean – true, wenn die Zeile ausgeblendet ist, andernfalls false.

Autorisierung

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

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

`isRowHiddenByUser(rowPosition)`

Gibt zurück, ob die angegebene Zeile vom Nutzer ausgeblendet wurde.

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

// Rows start at 1
Logger.log(sheet.isRowHiddenByUser(1));

Parameter

Name	Typ	Beschreibung
`rowPosition`	`Integer`	Die Position der zu untersuchenden Zeile.

Rückflug

Boolean – true, wenn die Zeile ausgeblendet ist, andernfalls false.

Autorisierung

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

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

`isSheetHidden()`

Gibt true zurück, wenn das Tabellenblatt derzeit ausgeblendet ist.

const sheet = SpreadsheetApp.getActiveSheet();
if (sheet.isSheetHidden()) {
  // do something...
}

Rückflug

Boolean – true, wenn das Tabellenblatt ausgeblendet ist, andernfalls false.

Autorisierung

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

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

`moveColumns(columnSpec, destinationIndex)`

Verschiebt die durch den angegebenen Bereich ausgewählten Spalten an die durch destinationIndex angegebene Position. Das columnSpec muss nicht genau eine ganze Spalte oder Spaltengruppe darstellen, um verschoben zu werden. Es werden alle Spalten ausgewählt, die vom Bereich abgedeckt werden.

// The code below moves rows A-B to destination index 5.
// This results in those columns becoming columns C-D.
const sheet = SpreadsheetApp.getActiveSheet();
// Selects column A and column B to be moved.
const columnSpec = sheet.getRange('A1:B1');
sheet.moveColumns(columnSpec, 5);

Parameter

Name	Typ	Beschreibung
`columnSpec`	`Range`	Ein Bereich, der die Spalten umfasst, die verschoben werden sollen.
`destinationIndex`	`Integer`	Der Index, zu dem die Spalten verschoben werden sollen. Dieser Index basiert auf den Koordinaten, bevor die Spalten verschoben werden. Vorhandene Daten werden nach rechts verschoben, um Platz für die verschobenen Spalten zu schaffen. Die Quellspalten werden aus dem Tabellengitter entfernt. Die Daten können daher an einem anderen Index landen als ursprünglich angegeben.

Autorisierung

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

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

`moveRows(rowSpec, destinationIndex)`

Verschiebt die durch den angegebenen Bereich ausgewählten Zeilen an die durch das destinationIndex angegebene Position. Das rowSpec muss nicht genau eine ganze Zeile oder Gruppe von Zeilen darstellen, die verschoben werden sollen. Es werden alle Zeilen ausgewählt, die im Bereich enthalten sind.

// The code below moves rows 1-2 to destination index 5.
// This results in those rows becoming rows 3-4.
const sheet = SpreadsheetApp.getActiveSheet();
// Selects row 1 and row 2 to be moved.
const rowSpec = sheet.getRange('A1:A2');
sheet.moveRows(rowSpec, 5);

Parameter

Name	Typ	Beschreibung
`rowSpec`	`Range`	Ein Bereich, der die zu verschiebenden Zeilen umfasst.
`destinationIndex`	`Integer`	Der Index, zu dem die Zeilen verschoben werden sollen. Dieser Index basiert auf den Koordinaten, bevor die Zeilen verschoben werden. Vorhandene Daten werden nach unten verschoben, um Platz für die verschobenen Zeilen zu schaffen. Die Quellzeilen werden aus dem Tabellengrid entfernt. Daher können die Daten an einem anderen Index landen als ursprünglich angegeben.

Autorisierung

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

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

`newChart()`

Gibt einen Builder zurück, mit dem ein neues Diagramm für dieses Tabellenblatt erstellt werden kann.

In diesem Beispiel wird gezeigt, wie ein neues Diagramm erstellt wird:

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B8');
const chartBuilder = sheet.newChart();
chartBuilder.addRange(range)
    .setChartType(Charts.ChartType.LINE)
    .setPosition(2, 2, 0, 0)
    .setOption('title', 'My Line Chart!');
sheet.insertChart(chartBuilder.build());

Rückflug

EmbeddedChartBuilder: Ein Builder zum Erstellen eines neuen Diagramms.

`protect()`

Erstellt ein Objekt, mit dem das Tabellenblatt vor Änderungen geschützt werden kann, die nicht von Nutzern mit Berechtigung vorgenommen werden. Bis das Skript die Liste der Mitbearbeiter für das Tabellenblatt tatsächlich ändert (durch Aufrufen von Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) oder Festlegen eines neuen Werts für Protection.setDomainEdit(editable)), entsprechen die Berechtigungen denen der Tabelle selbst. Das bedeutet, dass das Tabellenblatt effektiv ungeschützt bleibt. Wenn das Tabellenblatt bereits geschützt ist, gibt diese Methode ein Objekt zurück, das die vorhandenen Schutzeinstellungen darstellt. Ein geschütztes Tabellenblatt kann ungeschützte Bereiche enthalten.

// Protect the active sheet, then remove all other users from the list of
// editors.
const sheet = SpreadsheetApp.getActiveSheet();
const protection = sheet.protect().setDescription('Sample protected sheet');

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

Rückflug

Protection: Ein Objekt, das die Schutzeinstellungen darstellt.

Autorisierung

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

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

`removeChart(chart)`

Entfernt ein Diagramm aus dem übergeordneten Tabellenblatt.

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

// This removes all the embedded charts from the spreadsheet
const charts = sheet.getCharts();
for (const i in charts) {
  sheet.removeChart(charts[i]);
}

Parameter

Name	Typ	Beschreibung
`chart`	`EmbeddedChart`	Das zu entfernende Diagramm.

Autorisierung

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

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

`setActiveRange(range)`

Legt den angegebenen Bereich als active range im aktiven Tabellenblatt fest. Die obere linke Zelle im Bereich wird als current cell verwendet.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const range = sheet.getRange('A1:D4');
sheet.setActiveRange(range);

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

Parameter

Name	Typ	Beschreibung
`range`	`Range`	Der Bereich, der als aktiver Bereich festgelegt werden soll.

Rückflug

Range: Der neu aktive Bereich.

Autorisierung

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

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

`setActiveRangeList(rangeList)`

Legt die angegebene Liste von Bereichen als active ranges im aktiven Tabellenblatt fest. Der letzte Bereich in der Liste wird als active range festgelegt.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
sheet.setActiveRangeList(rangeList);

const selection = sheet.getSelection();
// Current cell: B2
const currentCell = selection.getCurrentCell();
// Active range: B2:C4
const activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
const activeRangeList = selection.getActiveRangeList();

Parameter

Name	Typ	Beschreibung
`rangeList`	`RangeList`	Die Liste der auszuwählenden Bereiche.

Rückflug

RangeList: Die neu ausgewählte Liste von Bereichen.

Autorisierung

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

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

`setActiveSelection(range)`

Legt den aktiven Auswahlbereich für dieses Tabellenblatt fest.

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

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

Parameter

Name	Typ	Beschreibung
`range`	`Range`	Der Bereich, der als aktive Auswahl festgelegt werden soll.

Rückflug

Range: Der neu aktive Bereich.

Autorisierung

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

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

`setActiveSelection(a1Notation)`

Legt die aktive Auswahl fest, wie in der A1- oder R1C1-Notation angegeben.

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

sheet.setActiveSelection('A1:D4');

Parameter

Name	Typ	Beschreibung
`a1Notation`	`String`	Der Bereich, der als aktiv festgelegt werden soll, angegeben in A1- oder R1C1-Notation.

Rückflug

Range: Der neu aktive Bereich.

Autorisierung

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

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

`setColumnGroupControlPosition(position)`

Hiermit wird die Position des Ein/Aus-Schalters für die Spaltengruppensteuerung im Tabellenblatt festgelegt.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setColumnGroupControlPosition(
    SpreadsheetApp.GroupControlTogglePosition.AFTER,
);

Parameter

Name	Typ	Beschreibung
`position`	`GroupControlTogglePosition`	Die Position des Schalters für die Spaltengruppensteuerung.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`setColumnWidth(columnPosition, width)`

Legt die Breite der angegebenen Spalte in Pixeln fest.

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

// Sets the first column to a width of 200 pixels
sheet.setColumnWidth(1, 200);

Parameter

Name	Typ	Beschreibung
`columnPosition`	`Integer`	Die Position der festzulegenden Spalte.
`width`	`Integer`	Die Breite in Pixeln, die festgelegt werden soll.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`setColumnWidths(startColumn, numColumns, width)`

Legt die Breite der angegebenen Spalten in Pixeln fest.

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

// Sets the first three columns to a width of 200 pixels
sheet.setColumnWidths(1, 3, 200);

Parameter

Name	Typ	Beschreibung
`startColumn`	`Integer`	Die Startspaltenposition, die geändert werden soll.
`numColumns`	`Integer`	Die Anzahl der zu ändernden Spalten.
`width`	`Integer`	Die Breite in Pixeln, die festgelegt werden soll.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`setConditionalFormatRules(rules)`

Ersetzt alle vorhandenen Regeln für die bedingte Formatierung im Tabellenblatt durch die Eingaberegeln. Regeln werden in der Reihenfolge ihrer Eingabe ausgewertet.

// Remove one of the existing conditional format rules.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
rules.splice(1, 1);  // Deletes the 2nd format rule.
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`rules`	`ConditionalFormatRule[]`	Die neuen Regeln für die bedingte Formatierung.

Autorisierung

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

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

`setCurrentCell(cell)`

Legt die angegebene Zelle als current cell fest.

Wenn die angegebene Zelle in einem bereits ausgewählten Bereich vorhanden ist, wird dieser Bereich zum aktiven Bereich und die Zelle zur aktuellen Zelle.

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

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

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const cell = sheet.getRange('B5');
sheet.setCurrentCell(cell);

const selection = sheet.getSelection();
// Current cell: B5
const currentCell = selection.getCurrentCell();

Parameter

Name	Typ	Beschreibung
`cell`	`Range`	Die Zelle, die als aktuelle Zelle festgelegt werden soll.

Rückflug

Range: Die neu festgelegte aktuelle Zelle.

Autorisierung

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

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

`setFrozenColumns(columns)`

Friert die angegebene Anzahl von Spalten ein. Wenn der Wert null ist, werden keine Spalten fixiert.

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

// Freezes the first column
sheet.setFrozenColumns(1);

Parameter

Name	Typ	Beschreibung
`columns`	`Integer`	Die Anzahl der zu fixierenden Spalten.

Autorisierung

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

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

`setFrozenRows(rows)`

Fixiert die angegebene Anzahl von Zeilen. Wenn der Wert null ist, werden keine Zeilen fixiert.

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

// Freezes the first row
sheet.setFrozenRows(1);

Parameter

Name	Typ	Beschreibung
`rows`	`Integer`	Die Anzahl der zu fixierenden Zeilen.

Autorisierung

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

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

`setHiddenGridlines(hideGridlines)`

Blendet die Gitternetzlinien des Tabellenblatts ein oder aus.

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

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

// Hides the gridlines in the sheet.
sheet.setHiddenGridlines(true);

Parameter

Name	Typ	Beschreibung
`hideGridlines`	`Boolean`	Wenn `true`, werden die Gitternetzlinien in diesem Tabellenblatt ausgeblendet. Andernfalls werden sie angezeigt.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`setName(name)`

Legt den Namen des Tabellenblatts fest.

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.setName('not first anymore');

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der neue Name für das Tabellenblatt.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`setRightToLeft(rightToLeft)`

Legt das Arbeitsblattlayout auf „Linksläufig“ fest oder hebt die Festlegung auf.

// 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets the sheet layout, so that the sheet is ordered from right to left.
sheet.setRightToLeft(true);

Parameter

Name	Typ	Beschreibung
`rightToLeft`	`Boolean`	Wenn `true`, wird das Tabellenblattlayout auf „Rechts nach links“ festgelegt, wobei sich Zelle A1 oben rechts befindet. Wenn `false`, wird das Tabellenblattlayout auf die Standardeinstellung von links nach rechts festgelegt, wobei sich Zelle A1 oben links befindet.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`setRowGroupControlPosition(position)`

Legt die Position des Ein/Aus-Schalters für die Zeilengruppensteuerung im Tabellenblatt fest.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setRowGroupControlPosition(
    SpreadsheetApp.GroupControlTogglePosition.AFTER,
);

Parameter

Name	Typ	Beschreibung
`position`	`GroupControlTogglePosition`	Die Position des Ein/Aus-Schalters für die Zeilengruppensteuerung.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`setRowHeight(rowPosition, height)`

Legt die Zeilenhöhe der angegebenen Zeile in Pixeln fest. Standardmäßig werden Zeilen so angepasst, dass sie den Zelleninhalt aufnehmen können. Wenn Sie Zeilen auf eine bestimmte Höhe festlegen möchten, verwenden Sie setRowHeightsForced(startRow, numRows, height).

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

// Sets the first row to a height of 200 pixels
sheet.setRowHeight(1, 200);

Parameter

Name	Typ	Beschreibung
`rowPosition`	`Integer`	Die zu ändernde Zeilenposition.
`height`	`Integer`	Die Höhe in Pixeln, die festgelegt werden soll.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`setRowHeights(startRow, numRows, height)`

Legt die Höhe der angegebenen Zeilen in Pixeln fest. Standardmäßig werden Zeilen so angepasst, dass sie den Zelleninhalt aufnehmen können. Wenn Sie Zeilen auf eine bestimmte Höhe festlegen möchten, verwenden Sie setRowHeightsForced(startRow, numRows, height).

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

// Sets the first three rows to a height of 20 pixels
sheet.setRowHeights(1, 3, 20);

Parameter

Name	Typ	Beschreibung
`startRow`	`Integer`	Die Startzeilenposition, die geändert werden soll.
`numRows`	`Integer`	Die Anzahl der zu ändernden Zeilen.
`height`	`Integer`	Die Höhe in Pixeln, die festgelegt werden soll.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`setRowHeightsForced(startRow, numRows, height)`

Legt die Höhe der angegebenen Zeilen in Pixeln fest. Standardmäßig werden Zeilen so angepasst, dass sie den Zelleninhalt aufnehmen können. Wenn Sie setRowHeightsForced verwenden, werden Zeilen auf die angegebene Höhe festgelegt, auch wenn der Zellinhalt höher als die Zeilenhöhe ist.

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

// Sets the first three rows to a height of 5 pixels.
sheet.setRowHeightsForced(1, 3, 5);

Parameter

Name	Typ	Beschreibung
`startRow`	`Integer`	Die Startzeilenposition, die geändert werden soll.
`numRows`	`Integer`	Die Anzahl der zu ändernden Zeilen.
`height`	`Integer`	Die Höhe in Pixeln, die festgelegt werden soll.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`setTabColor(color)`

Legt die Farbe des Tabellenblatt-Tabs fest.

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
first.setTabColor('ff0000');  // Set the color to red.
first.setTabColor(null);      // Unset the color.

Parameter

Name	Typ	Beschreibung
`color`	`String`	Ein Farbcode in CSS-Notation (z. B. `'#ffffff'` oder `'white'`) oder `null`, um die Tab-Farbe zurückzusetzen.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`setTabColorObject(color)`

Legt die Farbe des Tabellenblatt-Tabs fest.

// This example assumes there is a sheet named "Sheet1"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('Sheet1');
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                  .build();
first.setTabColorObject(color);  // Set the color to theme accent 1.
first.setTabColorObject(null);   // Unset the color.

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Die Farbe des Tabellenblatt-Tabs, die festgelegt werden soll.

Rückflug

Sheet – Dieses Tabellenblatt zur Verkettung.

Autorisierung

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

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

`showColumns(columnIndex)`

Macht die Spalte am angegebenen Index wieder sichtbar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Unhides the first column
sheet.showColumns(1);

Parameter

Name	Typ	Beschreibung
`columnIndex`	`Integer`	Der Index der Spalte, die eingeblendet werden soll.

Autorisierung

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

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

`showColumns(columnIndex, numColumns)`

Macht eine oder mehrere aufeinanderfolgende Spalten ab dem angegebenen Index wieder sichtbar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Unhides the first three columns
sheet.showColumns(1, 3);

Parameter

Name	Typ	Beschreibung
`columnIndex`	`Integer`	Der Startindex der Spalten, die einblendet werden sollen.
`numColumns`	`Integer`	Die Anzahl der Spalten, die einblendet werden sollen.

Autorisierung

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

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

`showRows(rowIndex)`

Macht die Zeile am angegebenen Index wieder sichtbar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Unhides the first row
sheet.showRows(1);

Parameter

Name	Typ	Beschreibung
`rowIndex`	`Integer`	Der Index der Zeile, die eingeblendet werden soll.

Autorisierung

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

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

`showRows(rowIndex, numRows)`

Macht eine oder mehrere aufeinanderfolgende Zeilen ab dem angegebenen Index wieder sichtbar.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
// Unhides the first three rows
sheet.showRows(1, 3);

Parameter

Name	Typ	Beschreibung
`rowIndex`	`Integer`	Der Startindex der Zeilen, die ein- oder ausgeblendet werden sollen.
`numRows`	`Integer`	Die Anzahl der Zeilen, die einblendet werden sollen.

Autorisierung

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

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

`showSheet()`

Macht das Tabellenblatt sichtbar. Hat keine Auswirkungen, wenn das Tabellenblatt bereits sichtbar ist.

const sheet = SpreadsheetApp.getActiveSheet();
sheet.showSheet();

Rückflug

Sheet: Das aktuelle Tabellenblatt.

Autorisierung

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

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

`sort(columnPosition)`

Sortiert ein Tabellenblatt aufsteigend nach Spalte.

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

// Sorts the sheet by the first column, ascending
sheet.sort(1);

Parameter

Name	Typ	Beschreibung
`columnPosition`	`Integer`	Die Spalte, nach der sortiert werden soll.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`sort(columnPosition, ascending)`

Sortiert ein Tabellenblatt nach Spalte. Akzeptiert einen Parameter, um aufsteigend oder absteigend anzugeben.

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

// Sorts the sheet by the first column, descending
sheet.sort(1, false);

Parameter

Name	Typ	Beschreibung
`columnPosition`	`Integer`	Die Spalte, nach der sortiert werden soll.
`ascending`	`Boolean`	`true` für aufsteigende Sortierungen, `false` für absteigende.

Rückflug

Sheet: Das Blatt, das für die Verkettung von Methoden nützlich ist.

Autorisierung

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

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

`unhideColumn(column)`

Macht die Spalte im angegebenen Bereich wieder sichtbar.

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

// This unhides the first column if it was previously hidden
const range = sheet.getRange('A1');
sheet.unhideColumn(range);

Parameter

Name	Typ	Beschreibung
`column`	`Range`	Der Bereich, der ein- oder ausgeblendet werden soll.

Autorisierung

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

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

`unhideRow(row)`

Macht die Zeile im angegebenen Bereich wieder sichtbar.

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

// This unhides the first row if it was previously hidden
const range = sheet.getRange('A1');
sheet.unhideRow(range);

Parameter

Name	Typ	Beschreibung
`row`	`Range`	Der Bereich, der ein- oder ausgeblendet werden soll.

Autorisierung

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

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

`updateChart(chart)`

Aktualisiert das Diagramm auf diesem Tabellenblatt.

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

// This code is going to loop through all the charts and change them to
// column charts
const charts = sheet.getCharts();
for (const i in charts) {
  const chart = charts[i];
  const newChart = chart.modify().setChartType(Charts.ChartType.COLUMN).build();
  sheet.updateChart(newChart);
}

Parameter

Name	Typ	Beschreibung
`chart`	`EmbeddedChart`	Das zu aktualisierende Diagramm.

Autorisierung

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

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

Eingestellte Methoden

`getSheetProtection()`

Veraltet. Verwenden Sie für Tabellen, die in der neueren Version von Google Sheets erstellt wurden, getProtections(type). Dadurch wird die leistungsstärkere Klasse Protection zurückgegeben. Diese Methode ist zwar veraltet, aber aus Kompatibilitätsgründen mit der älteren Version von Google Tabellen weiterhin verfügbar.

Gibt eine PageProtection-Instanz zurück, die die Berechtigungen für das aktuelle Tabellenblatt beschreibt.

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

const permissions = sheet.getSheetProtection();

permissions.setProtected(true);
permissions.addUser('user@example.com');

// Logs the users that have access to edit this sheet. Note that this
// is different from access to the entire spreadsheet - getUsers()
// only returns users if permissions.isProtected() is set to true.
const users = permissions.getUsers();
Logger.log(users);

Rückflug

PageProtection: Ein Objekt, das die Zugriffsberechtigungen für das Tabellenblatt beschreibt.

Autorisierung

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

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

`getTabColor()`

Veraltet. Ersetzt durch getTabColorObject()

Gibt die Farbe des Tabellenblatt-Tabs zurück oder null, wenn der Tabellenblatt-Tab keine Farbe hat.

// This example assumes there is a sheet named "first"
const ss = SpreadsheetApp.getActiveSpreadsheet();
const first = ss.getSheetByName('first');
const color = first.getTabColor();

Rückflug

String – Farbcode in CSS-Notation (z. B. '#ffffff').

Autorisierung

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

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

`setSheetProtection(permissions)`

Veraltet. Verwenden Sie für Tabellen, die in der neueren Version von Google Sheets erstellt wurden, protect(). Dadurch wird die leistungsstärkere Klasse Protection zurückgegeben. Diese Methode ist zwar veraltet, bleibt aber zur Kompatibilität mit der älteren Version von Google Tabellen verfügbar.

Legt die Berechtigungen für das aktuelle Tabellenblatt fest.

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

const permissions = sheet.getSheetProtection();

// This copies the permissions on the first sheet to the second sheet
const sheetToClonePermissionsTo = ss.getSheets()[1];
sheetToClonePermissionsTo.setSheetProtection(permissions);

Parameter

Name	Typ	Beschreibung
`permissions`	`PageProtection`	Das Objekt mit den Zugriffsberechtigungen, das für dieses Tabellenblatt festgelegt werden soll.

Autorisierung

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

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

Class Sheet Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Methoden

Eingestellte Methoden

Detaillierte Dokumentation

activate()

Rückflug

addDeveloperMetadata(key)

Parameter

Rückflug

Autorisierung

addDeveloperMetadata(key, visibility)

Parameter

Rückflug

Autorisierung

addDeveloperMetadata(key, value)

Parameter

Rückflug

Autorisierung

addDeveloperMetadata(key, value, visibility)

Parameter

Rückflug

Autorisierung

appendRow(rowContents)

Parameter

Rückflug

Autorisierung

asDataSourceSheet()

Rückflug

Autorisierung

autoResizeColumn(columnPosition)

Parameter

Rückflug

Autorisierung

autoResizeColumns(startColumn, numColumns)

Parameter

Rückflug

Autorisierung

autoResizeRows(startRow, numRows)

Parameter

Rückflug

Autorisierung

clear()

Rückflug

Autorisierung

clear(options)

Parameter

Erweiterte Parameter

Rückflug

Autorisierung

clearConditionalFormatRules()

Autorisierung

clearContents()

Rückflug

Autorisierung

clearFormats()

Rückflug

Autorisierung

clearNotes()

Rückflug

Autorisierung

collapseAllColumnGroups()

Rückflug

Autorisierung

collapseAllRowGroups()

Rückflug

Autorisierung

copyTo(spreadsheet)

Parameter

Rückflug

Autorisierung

createDeveloperMetadataFinder()

Rückflug

createTextFinder(findText)

Parameter

Rückflug

deleteColumn(columnPosition)

Parameter

Rückflug

Autorisierung

deleteColumns(columnPosition, howMany)

Class Sheet

`activate()`

`addDeveloperMetadata(key)`

`addDeveloperMetadata(key, visibility)`

`addDeveloperMetadata(key, value)`

`addDeveloperMetadata(key, value, visibility)`

`appendRow(rowContents)`

`asDataSourceSheet()`

`autoResizeColumn(columnPosition)`

`autoResizeColumns(startColumn, numColumns)`

`autoResizeRows(startRow, numRows)`

`clear()`

`clear(options)`

`clearConditionalFormatRules()`

`clearContents()`

`clearFormats()`

`clearNotes()`

`collapseAllColumnGroups()`

`collapseAllRowGroups()`

`copyTo(spreadsheet)`

`createDeveloperMetadataFinder()`

`createTextFinder(findText)`

`deleteColumn(columnPosition)`

`deleteColumns(columnPosition, howMany)`

`deleteRow(rowPosition)`

`deleteRows(rowPosition, howMany)`

`expandAllColumnGroups()`

`expandAllRowGroups()`

`expandColumnGroupsUpToDepth(groupDepth)`

`expandRowGroupsUpToDepth(groupDepth)`

`getActiveCell()`

`getActiveRange()`

`getActiveRangeList()`

`getBandings()`

`getCharts()`

`getColumnGroup(columnIndex, groupDepth)`

`getColumnGroupControlPosition()`

`getColumnGroupDepth(columnIndex)`

`getColumnWidth(columnPosition)`

`getConditionalFormatRules()`

`getCurrentCell()`

`getDataRange()`

`getDataSourceFormulas()`

`getDataSourcePivotTables()`