Auf Tabellenblätter zugreifen und sie bearbeiten. Zu den gängigen Vorgängen gehören 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ügen Sie der Tabelle Entwicklermetadaten mit dem angegebenen Schlüssel hinzu. |
addDeveloperMetadata(key, visibility) | Sheet | Fügen Sie dem Tabellenblatt Entwicklermetadaten mit dem angegebenen Schlüssel und der Sichtbarkeit hinzu. |
addDeveloperMetadata(key, value) | Sheet | Fügen Sie dem Tabellenblatt Entwicklermetadaten mit dem angegebenen Schlüssel und Wert hinzu. |
addDeveloperMetadata(key, value, visibility) | Sheet | Fügen Sie dem Tabellenblatt Entwicklermetadaten mit dem angegebenen Schlüssel, Wert und der Sichtbarkeit hinzu. |
appendRow(rowContents) | Sheet | Fügt eine Zeile am Ende des aktuellen Datenbereichs im Tabellenblatt an. |
asDataSourceSheet() | DataSourceSheet | Gibt das Tabellenblatt als DataSourceSheet zurück, wenn es vom Typ SheetType.DATASOURCE ist, andernfalls als null . |
autoResizeColumn(columnPosition) | Sheet | Die Breite der angegebenen Spalte wird an den Inhalt angepasst. |
autoResizeColumns(startColumn, numColumns) | Sheet | Die Breite aller Spalten ab der angegebenen Spaltenposition wird so festgelegt, dass sie dem Inhalt entspricht. |
autoResizeRows(startRow, numRows) | Sheet | Die Höhe aller Zeilen ab der angegebenen Zeilenposition wird an den Inhalt angepasst. |
clear() | Sheet | Inhalte und Formatierungsinformationen werden aus dem Tabellenblatt gelöscht. |
clear(options) | Sheet | Löscht den Inhalt und/oder das Format des Tabellenblatts, wie in den erweiterten Optionen angegeben. |
clearConditionalFormatRules() | void | Entfernt alle Regeln für die bedingte Formatierung aus dem Tabellenblatt. |
clearContents() | Sheet | Der Inhalt des Tabellenblatts wird gelöscht, während Formatierungsinformationen beibehalten werden. |
clearFormats() | Sheet | Die Formatierung des Tabellenblatts wird gelöscht, der Inhalt bleibt erhalten. |
clearNotes() | Sheet | Löscht alle Notizen aus dem Tabellenblatt. |
collapseAllColumnGroups() | Sheet | Alle Spaltengruppen im Tabellenblatt werden minimiert. |
collapseAllRowGroups() | Sheet | Alle Zeilengruppen in der Tabelle werden minimiert. |
copyTo(spreadsheet) | Sheet | Das Tabellenblatt wird in eine bestimmte Tabelle kopiert. Das kann dieselbe Tabelle wie die Quelle sein. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Gibt eine DeveloperMetadataFinder zurück, wenn Entwicklermetadaten im Bereich dieses Tabellenblatts gefunden wurden. |
createTextFinder(findText) | TextFinder | Erstellt einen Textsuchmechanismus für das Tabellenblatt, mit dem Text im Tabellenblatt gefunden und ersetzt werden kann. |
deleteColumn(columnPosition) | Sheet | Löscht die Spalte an der angegebenen Spaltenposition. |
deleteColumns(columnPosition, howMany) | void | Löscht eine Reihe von Spalten, beginnend an der angegebenen Spaltenposition. |
deleteRow(rowPosition) | Sheet | Löscht die Zeile an der angegebenen Zeilenposition. |
deleteRows(rowPosition, howMany) | void | Löscht eine Reihe von Zeilen, beginnend an der angegebenen Zeilenposition. |
expandAllColumnGroups() | Sheet | Maximiert alle Spaltengruppen im Tabellenblatt. |
expandAllRowGroups() | Sheet | Maximiert alle Zeilengruppen auf dem Tabellenblatt. |
expandColumnGroupsUpToDepth(groupDepth) | Sheet | Hiermit werden alle Spaltengruppen bis zur angegebenen Tiefe maximiert und alle anderen minimiert. |
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 zurück oder null , wenn keine aktiven Bereiche vorhanden sind. |
getBandings() | Banding[] | Gibt alle Farbbänder in diesem Tabellenblatt zurück. |
getCharts() | EmbeddedChart[] | Gibt ein Array von Diagrammen auf diesem Tabellenblatt zurück. |
getColumnGroup(columnIndex, groupDepth) | Group | Gibt die Spaltengruppe am angegebenen Index und der angegebenen Gruppentiefe zurück. |
getColumnGroupControlPosition() | GroupControlTogglePosition | Gibt den GroupControlTogglePosition für alle Spaltengruppen im Tabellenblatt zurück. |
getColumnGroupDepth(columnIndex) | Integer | Gibt die Gruppentiefe der Spalte am angegebenen Index zurück. |
getColumnWidth(columnPosition) | Integer | Ruft die Breite der angegebenen Spalte in Pixeln ab. |
getConditionalFormatRules() | ConditionalFormatRule[] | Alle Regeln für die bedingte Formatierung in diesem Tabellenblatt abrufen |
getCurrentCell() | Range | Gibt die aktuelle Zelle im aktiven Tabellenblatt zurück oder null , wenn keine aktuelle Zelle vorhanden ist. |
getDataRange() | Range | Gibt ein Range zurück, das den Dimensionen entspricht, in denen Daten vorhanden sind. |
getDataSourceFormulas() | DataSourceFormula[] | Hier werden alle Formeln der Datenquelle abgerufen. |
getDataSourcePivotTables() | DataSourcePivotTable[] | Hier werden alle Pivot-Tabellen der Datenquelle abgerufen. |
getDataSourceTables() | DataSourceTable[] | Hier werden alle Tabellen der Datenquelle abgerufen. |
getDeveloperMetadata() | DeveloperMetadata[] | Alle Entwicklermetadaten abrufen, 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 | Die URL des Formulars, das seine Antworten an dieses Tabellenblatt sendet, oder null , wenn diesem Tabellenblatt kein Formular zugewiesen 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 über das Raster hinausragen. |
getIndex() | Integer | Ruft die Position des Tabellenblatts in der übergeordneten Tabelle ab. |
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[] | Hiermit werden alle benannten Bereiche in diesem Tabellenblatt abgerufen. |
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[] | Hiermit wird ein Array von Objekten zurückgegeben, 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 linken oberen Zelle an den angegebenen Koordinaten zurück. |
getRange(row, column, numRows) | Range | Gibt den Bereich mit der linken oberen Zelle an den angegebenen Koordinaten und mit der angegebenen Anzahl von Zeilen zurück. |
getRange(row, column, numRows, numColumns) | Range | Gibt den Bereich mit der linken oberen Zelle 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 auf demselben Tabellenblatt darstellt, die durch eine nicht leere Liste von A1- oder R1C1-Bezeichnungen angegeben werden. |
getRowGroup(rowIndex, groupDepth) | Group | Gibt die Zeilengruppe am angegebenen Index und der angegebenen Gruppentiefe zurück. |
getRowGroupControlPosition() | GroupControlTogglePosition | Gibt den GroupControlTogglePosition für alle Zeilengruppen im Tabellenblatt zurück. |
getRowGroupDepth(rowIndex) | Integer | Gibt die Gruppenebene der Zeile am angegebenen Index zurück. |
getRowHeight(rowPosition) | Integer | Die Höhe der angegebenen Zeile in Pixeln. |
getSelection() | Selection | Gibt das 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 Tabellennamen zurück. |
getSheetValues(startRow, startColumn, numRows, numColumns) | Object[][] | Gibt das rechteckige Raster mit Werten für diesen Bereich ab den angegebenen Koordinaten zurück. |
getSlicers() | Slicer[] | Gibt ein Array von Segmentierungstools auf dem Tabellenblatt zurück. |
getTabColorObject() | Color | Gibt die Farbe des Tabellenblatts zurück oder null , wenn das Tabellenblatt keine Farbe hat. |
getType() | SheetType | Gibt den Typ des Tabellenblatts zurück. |
hasHiddenGridlines() | Boolean | Gibt true zurück, wenn die Tabellenrasterlinien ausgeblendet sind. Andernfalls wird false zurückgegeben. |
hideColumn(column) | void | Die Spalte oder Spalten im angegebenen Bereich werden ausgeblendet. |
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 | Die Zeile am angegebenen Index wird ausgeblendet. |
hideRows(rowIndex, numRows) | void | Eine oder mehrere aufeinanderfolgende Zeilen ab dem angegebenen Index werden ausgeblendet. |
hideSheet() | Sheet | Blendet dieses Tabellenblatt aus. |
insertChart(chart) | void | Fügen Sie diesem Tabellenblatt ein neues Diagramm hinzu. |
insertColumnAfter(afterPosition) | Sheet | Fügt eine Spalte an der angegebenen Spaltenposition ein. |
insertColumnBefore(beforePosition) | Sheet | Hiermit wird eine Spalte vor der angegebenen Spaltenposition eingefügt. |
insertColumns(columnIndex) | void | Fügt an der angegebenen Stelle in einem Tabellenblatt eine leere Spalte ein. |
insertColumns(columnIndex, numColumns) | void | Fügt ein oder mehrere aufeinanderfolgende leere Spalten in ein Tabellenblatt ein, beginnend an der angegebenen Stelle. |
insertColumnsAfter(afterPosition, howMany) | Sheet | Fügt nach der angegebenen Spaltenposition eine bestimmte Anzahl von Spalten ein. |
insertColumnsBefore(beforePosition, howMany) | Sheet | Hiermit werden mehrere Spalten vor der angegebenen Spaltenposition eingefügt. |
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 Pixelversatz 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 in das Dokument in einer bestimmten Zeile und Spalte mit einem Pixelversatz 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 in einem Tabellenblatt eine leere Zeile ein. |
insertRows(rowIndex, numRows) | void | Fügt eine oder mehrere aufeinanderfolgende leere Zeilen in ein Tabellenblatt ein, beginnend an der angegebenen Stelle. |
insertRowsAfter(afterPosition, howMany) | Sheet | Fügt nach der angegebenen Zeilenposition eine bestimmte Anzahl von Zeilen ein. |
insertRowsBefore(beforePosition, howMany) | Sheet | Fügt vor der angegebenen Zeilenposition eine bestimmte Anzahl von Zeilen ein. |
insertSlicer(range, anchorRowPos, anchorColPos) | Slicer | Fügt diesem Tabellenblatt einen neuen Sliver hinzu. |
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY) | Slicer | Fügt diesem Tabellenblatt einen neuen Sliver hinzu. |
isColumnHiddenByUser(columnPosition) | Boolean | Gibt an, ob die angegebene Spalte vom Nutzer ausgeblendet ist. |
isRightToLeft() | Boolean | Gibt true zurück, wenn das Tabellenlayout von rechts nach links ist. |
isRowHiddenByFilter(rowPosition) | Boolean | Gibt zurück, ob die angegebene Zeile durch einen Filter (nicht durch eine Filteransicht) ausgeblendet ist. |
isRowHiddenByUser(rowPosition) | Boolean | Gibt zurück, ob die angegebene Zeile vom Nutzer ausgeblendet ist. |
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 Position, die durch das destinationIndex angegeben ist. |
moveRows(rowSpec, destinationIndex) | void | Verschiebt die durch den angegebenen Bereich ausgewählten Zeilen an die Position, die durch das destinationIndex angegeben ist. |
newChart() | EmbeddedChartBuilder | Hiermit wird ein Builder zurückgegeben, mit dem ein neues Diagramm für dieses Tabellenblatt erstellt werden kann. |
protect() | Protection | Erstellt ein Objekt, mit dem das Tabellenblatt vor Bearbeitungen geschützt werden kann, mit Ausnahme von Nutzern mit Berechtigung. |
removeChart(chart) | void | Entfernt ein Diagramm aus dem übergeordneten Tabellenblatt. |
setActiveRange(range) | Range | Der angegebene Bereich wird als active range in der aktiven Tabelle festgelegt, wobei die linke obere Zelle im Bereich als current cell festgelegt wird. |
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 A1- oder R1C1-Notation angegeben. |
setColumnGroupControlPosition(position) | Sheet | Hiermit wird die Position des Schalters für die Spaltengruppensteuerung auf dem Tabellenblatt festgelegt. |
setColumnWidth(columnPosition, width) | Sheet | Hiermit wird die Breite der angegebenen Spalte in Pixeln festgelegt. |
setColumnWidths(startColumn, numColumns, width) | Sheet | Hiermit wird die Breite der angegebenen Spalten in Pixeln festgelegt. |
setConditionalFormatRules(rules) | void | Ersetzt alle derzeit vorhandenen Regeln für die bedingte Formatierung in der Tabelle durch die Eingaberegeln. |
setCurrentCell(cell) | Range | Die angegebene Zelle wird als current cell festgelegt. |
setFrozenColumns(columns) | void | Die angegebene Anzahl von Spalten wird fixiert. |
setFrozenRows(rows) | void | Die angegebene Anzahl von Zeilen wird fixiert. |
setHiddenGridlines(hideGridlines) | Sheet | Blendet die Gitternetzlinien des Tabellenblatts ein oder aus. |
setName(name) | Sheet | Legt den Tabellennamen fest. |
setRightToLeft(rightToLeft) | Sheet | Hiermit wird das Layout des Arbeitsblatts auf „Linksläufig“ festgelegt oder aufgehoben. |
setRowGroupControlPosition(position) | Sheet | Hiermit wird die Position des Ein/Aus-Schalters für die Zeilengruppensteuerung auf dem Tabellenblatt festgelegt. |
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 Tabellenblatts fest. |
setTabColorObject(color) | Sheet | Legt die Farbe des Tabellenblatts fest. |
showColumns(columnIndex) | void | Die Spalte am angegebenen Index wird eingeblendet. |
showColumns(columnIndex, numColumns) | void | Blendet eine oder mehrere aufeinanderfolgende Spalten ab dem angegebenen Index ein. |
showRows(rowIndex) | void | Die Zeile am angegebenen Index wird sichtbar gemacht. |
showRows(rowIndex, numRows) | void | Eine oder mehrere aufeinanderfolgende Zeilen ab dem angegebenen Index werden sichtbar gemacht. |
showSheet() | Sheet | Macht das Tabellenblatt sichtbar. |
sort(columnPosition) | Sheet | Sortiert ein Tabellenblatt nach Spalte in aufsteigender Reihenfolge. |
sort(columnPosition, ascending) | Sheet | Sortiert ein Tabellenblatt nach Spalte. |
unhideColumn(column) | void | Die Spalte im angegebenen Bereich wird eingeblendet. |
unhideRow(row) | void | Blendet die Zeile im angegebenen Bereich ein. |
updateChart(chart) | void | Aktualisiert das Diagramm auf diesem Tabellenblatt. |
Detaillierte Dokumentation
activate()
Aktiviert dieses Tabellenblatt. Das Tabellenblatt selbst wird nicht geändert, sondern nur die Ansicht des übergeordneten Elements.
// 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 aktive Tabellenblatt.
addDeveloperMetadata(key)
Fügen Sie der Tabelle 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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
Fügen Sie dem Tabellenblatt Entwicklermetadaten mit dem angegebenen Schlüssel und der Sichtbarkeit hinzu.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets 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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Fügen Sie 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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Fügen Sie dem Tabellenblatt Entwicklermetadaten mit dem angegebenen Schlüssel, Wert und der Sichtbarkeit hinzu.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets 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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
appendRow(rowContents)
Fügt eine Zeile am Ende des aktuellen Datenbereichs 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 mit Werten, die nach der letzten Zeile im Tabellenblatt eingefügt werden sollen. |
Rückflug
Sheet
: Das Tabellenblatt, nützlich für die Methodenverkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
asDataSourceSheet()
Gibt das Tabellenblatt als DataSourceSheet
zurück, wenn es vom Typ SheetType.DATASOURCE
ist, andernfalls als 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
: Eine Tabelle mit Datenquellen.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnPosition)
Die Breite der angegebenen Spalte wird an den Inhalt angepasst.
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 Sie ändern möchten. |
Rückflug
Sheet
– das Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumns(startColumn, numColumns)
Die Breite aller Spalten ab der angegebenen Spaltenposition wird so festgelegt, dass sie dem Inhalt entspricht.
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 Anfangsspalte, 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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeRows(startRow, numRows)
Die Höhe aller Zeilen ab der angegebenen Zeilenposition wird an den Inhalt angepasst.
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 Anfangszeile, deren Größe automatisch geändert werden soll. |
numRows | Integer | Die Anzahl der Zeilen, deren Größe automatisch geändert werden soll. |
Rückflug
Sheet
– dieses Tabellenblatt, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Inhalte und Formatierungsinformationen werden aus dem Tabellenblatt gelöscht.
// 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Löscht den Inhalt und/oder das Format des Tabellenblatts, wie in den erweiterten Optionen angegeben.
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, die unten aufgeführt sind. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
contentsOnly | Boolean | Ob der Inhalt gelöscht werden soll. |
formatOnly | Boolean | Gibt an, ob die Formatierung entfernt werden soll. |
Rückflug
Sheet
– dieses Tabellenblatt, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContents()
Der Inhalt des Tabellenblatts wird gelöscht, während 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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormats()
Die Formatierung des Tabellenblatts wird gelöscht, der Inhalt bleibt erhalten.
Die Formatierung bezieht sich auf die Formatierung von Daten, wie sie im Menü „Format“ zulässig ist (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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNotes()
Löscht 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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllColumnGroups()
Alle Spaltengruppen im Tabellenblatt werden minimiert.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are collapsed. sheet.collapseAllColumnGroups();
Rückflug
Sheet
– dieses Tabellenblatt, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllRowGroups()
Alle Zeilengruppen in der Tabelle werden minimiert.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are collapsed. sheet.collapseAllRowGroups();
Rückflug
Sheet
– dieses Tabellenblatt, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(spreadsheet)
Das Tabellenblatt wird in eine bestimmte Tabelle kopiert. Das kann dieselbe Tabelle wie die Quelle sein. Die kopierte Tabelle heißt „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. Dies kann dieselbe Tabelle wie die Quelle sein. |
Rückflug
Sheet
: Das neue Tabellenblatt für die Verknüpfung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Gibt eine DeveloperMetadataFinder
zurück, wenn Entwicklermetadaten im Bereich dieses Tabellenblatts gefunden wurden. Metadaten gehören zu einem bestimmten Tabellenblatt, wenn sie entweder mit dem Tabellenblatt selbst oder mit einer Zeile, Spalte oder einem Bereich auf 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'); // 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 Suchtool für Entwicklermetadaten, mit dem Sie nach Metadaten in diesem Tabellenblatt suchen können.
createTextFinder(findText)
Erstellt einen Textsuchmechanismus für das Tabellenblatt, mit dem Text im Tabellenblatt gefunden 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 Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumns(columnPosition, howMany)
Löscht eine Reihe von Spalten, beginnend an 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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 Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRows(rowPosition, howMany)
Löscht eine Reihe von Zeilen, beginnend an 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 Zeile, die gelöscht werden soll. |
howMany | Integer | Die Anzahl der zu löschenden Zeilen. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandAllRowGroups()
Maximiert alle Zeilengruppen auf dem 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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandColumnGroupsUpToDepth(groupDepth)
Hiermit werden alle Spaltengruppen bis zur angegebenen Tiefe maximiert und alle anderen minimiert.
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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveCell()
Gibt die aktive Zelle in diesem Tabellenblatt zurück.
Hinweis:Es wird empfohlen, 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 aktuelle aktive Zelle
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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, gibt diese Methode nur den zuletzt ausgewählten Bereich zurück.
Der Begriff „aktiver Bereich“ bezieht sich auf den Bereich, den ein Nutzer in der aktiven Tabelle ausgewählt hat. In einer benutzerdefinierten Funktion bezieht er sich jedoch 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Weitere Informationen
getActiveRangeList()
Gibt die Liste der aktiven Bereiche im aktiven Tabellenblatt zurück oder null
, wenn keine aktiven Bereiche vorhanden sind.
Wenn nur ein Bereich ausgewählt ist, verhält sich das Ganze wie ein getActiveRange()
-Aufruf.
const sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. const activeRangeList = sheet.getActiveRangeList();
Rückflug
RangeList
– Liste der aktiven Bereiche
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Weitere Informationen
getBandings()
Gibt alle Farbbänder 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 Farbbänder in diesem Tabellenblatt.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroup(columnIndex, groupDepth)
Gibt die Spaltengruppe am 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 der Gruppensteuerung oder ein Index innerhalb der Gruppe. |
groupDepth | Integer | Die Tiefe der Gruppe. |
Rückflug
Group
: Die Spaltengruppe am Steuerelementindex und der Steuerelementtiefe. Andernfalls wird eine Ausnahme ausgelöst, wenn die Gruppe nicht vorhanden ist.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupControlPosition()
Gibt den 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
bis true
, wenn die Ein/Aus-Schaltfläche für die Spaltengruppierung nach der Gruppe auf diesem Tabellenblatt angezeigt wird, andernfalls false
.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupDepth(columnIndex)
Gibt die Gruppentiefe der Spalte am angegebenen Index zurück.
Die Gruppentiefe gibt an, wie viele Gruppen sich mit der Spalte überschneiden. Dieser Wert kann zwischen null und acht 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnWidth(columnPosition)
Ruft die Breite der angegebenen Spalte in Pixeln ab.
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 prüfenden Spalte. |
Rückflug
Integer
: Spaltenbreite in Pixeln
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 in der Tabelle.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCurrentCell()
Gibt die aktuelle Zelle im aktiven Tabellenblatt zurück oder null
, wenn keine aktuelle Zelle vorhanden ist. Die aktuelle Zelle ist die Zelle, die in Google Tabellen den Fokus hat. Sie ist durch einen dunklen Rahmen hervorgehoben. Es gibt nie mehr als eine aktuelle Zelle. Wenn ein Nutzer einen oder mehrere Zellenbereiche 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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.
Das entspricht funktional dem Erstellen eines Bereichs, der durch A1 und (Sheet.getLastColumn(), Sheet.getLastRow()) begrenzt ist.
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
Hier werden alle Formeln der Datenquelle abgerufen.
// 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[]
: Liste der Datenquellenformeln.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
Hier werden alle Pivot-Tabellen der Datenquelle abgerufen.
// 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[]
: Liste der Pivot-Tabellen der Datenquelle.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
Hier werden alle Tabellen der Datenquelle abgerufen.
// 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[]
: Liste der Tabellen der Datenquelle.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
Alle Entwicklermetadaten abrufen, 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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[]
: Liste der Zeichnungen auf diesem Blatt.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
Gibt den Filter 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormUrl()
Die URL des Formulars, das seine Antworten an dieses Tabellenblatt sendet, oder null
, wenn diesem Tabellenblatt kein Formular zugewiesen ist. Es wird eine Ausnahme ausgelöst, 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 diese Tabelle eingetragen werden. Wenn dieser Tabelle kein Formular zugewiesen ist, wird null
angezeigt.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getImages()
Gibt alle Bilder zurück, die über das Raster hinausragen.
// 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[]
: Eine Reihe von über das Raster gelegten Bildern.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getIndex()
Ruft die Position des Tabellenblatts in der übergeordneten Tabelle ab. 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
Gibt die 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 der Tabelle, die Inhalte enthält
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
Gibt die 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 der Tabelle, die Inhalte enthält
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNamedRanges()
Hiermit werden alle benannten Bereiche in diesem Tabellenblatt abgerufen.
// 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 aller benannten Bereiche im Tabellenblatt.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getProtections(type)
Hiermit wird ein Array von Objekten zurückgegeben, 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column)
Gibt den Bereich mit der linken oberen Zelle 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column, numRows)
Gibt den Bereich mit der linken oberen Zelle 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 Zeilenindex 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column, numRows, numColumns)
Gibt den Bereich mit der linken oberen Zelle 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 Zeilenindex des Bereichs. Die Zeilenindexierung beginnt mit 1. |
column | Integer | Der Startindex der Spalte im Bereich. 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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 Bereich, der zurückgegeben werden soll, in A1- oder R1C1-Notation. |
Rückflug
Range
– der Bereich am angegebenen Standort
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRangeList(a1Notations)
Gibt die RangeList
-Sammlung zurück, die die Bereiche auf demselben Tabellenblatt darstellt, die durch eine nicht leere Liste von A1- oder R1C1-Bezeichnungen 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[] | Liste der zurückzugebenden Bereiche, angegeben in A1- oder R1C1-Notation. |
Rückflug
RangeList
– die Bereichsliste am angegebenen Standort
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroup(rowIndex, groupDepth)
Gibt die Zeilengruppe am 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 der Gruppensteuerung oder ein Index innerhalb der Gruppe. |
groupDepth | Integer | Die Tiefe der Gruppe. |
Rückflug
Group
: Die Zeilengruppe mit dem Index und der Tiefe der Steuerung. Andernfalls wird eine Ausnahme ausgelöst, wenn die Gruppe nicht vorhanden ist.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupControlPosition()
Gibt den 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
bis true
, wenn das Umschaltfeld für die Zeilengruppierung nach der Gruppe auf diesem Tabellenblatt angezeigt wird, andernfalls false
.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupDepth(rowIndex)
Gibt die Gruppenebene der Zeile am angegebenen Index zurück.
Die Gruppentiefe gibt an, wie viele Gruppen sich mit der Zeile überschneiden. Dieser Wert kann zwischen null und acht 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowHeight(rowPosition)
Die Höhe der angegebenen Zeile in Pixeln.
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 Zeile, die geprüft werden soll. |
Rückflug
Integer
– Zeilenhöhe in Pixeln
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSelection()
Gibt das 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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 eindeutige ID für die Tabelle. Die ID ist eine monoton steigende Ganzzahl, die beim Erstellen des Tabellenblatts zugewiesen wird und unabhängig von der Tabellenblattposition ist. Das ist nützlich in Verbindung mit Methoden wie Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
, die einen gridId
-Parameter anstelle einer Sheet
-Instanz annehmen.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Rückflug
Integer
: Eine eindeutige ID für die Tabelle.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetName()
Gibt den Tabellennamen zurück.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Rückflug
String
– der Name der Tabelle
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(startRow, startColumn, numRows, numColumns)
Gibt das rechteckige Raster mit Werten für diesen Bereich ab den angegebenen Koordinaten zurück. Wenn Sie als Zeilen- oder Spaltenposition den Wert „-1“ angeben, wird die letzte Zeile oder Spalte mit Daten im Tabellenblatt zurückgegeben.
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSlicers()
Gibt ein Array von Segmentierungstools 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 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[]
: Liste der Segmentierungstools auf diesem Tabellenblatt.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTabColorObject()
Gibt die Farbe des Tabellenblatts zurück oder null
, wenn das Tabellenblatt 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getType()
Gibt den Typ des Tabellenblatts zurück.
Der Standardtyp für Blätter 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hasHiddenGridlines()
Gibt true
zurück, wenn die Tabellenrasterlinien ausgeblendet sind. Andernfalls wird false
zurückgegeben.
Rasterlinien sind standardmäßig 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumn(column)
Die Spalte oder Spalten im angegebenen Bereich werden ausgeblendet.
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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 Index 1.
Wenn Sie mehrere Spalten mit einem Index ausblenden möchten, verwenden Sie hideColumns(columnIndex, numColumns)
.
Wenn Sie mehrere Spalten mit einem Bereich 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 Spalte, die ausgeblendet werden soll. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex, numColumns)
Blendet eine oder mehrere aufeinanderfolgende Spalten ab dem angegebenen Index aus. Verwenden Sie für diese Methode den Index 1.
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 zu blendenden Spalten. |
numColumns | Integer | Die Anzahl der zu blendenden Spalten. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 zu blendende Zeilenbereich. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex)
Die Zeile am angegebenen Index wird ausgeblendet.
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 Zeile, die ausgeblendet werden soll. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex, numRows)
Eine oder mehrere aufeinanderfolgende Zeilen ab dem angegebenen Index werden ausgeblendet.
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 zu versteckenden Zeilen. |
numRows | Integer | Die Anzahl der Zeilen, die ausgeblendet werden sollen. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertChart(chart)
Fügen Sie 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnAfter(afterPosition)
Fügt eine Spalte an 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 Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnBefore(beforePosition)
Hiermit wird eine Spalte vor der angegebenen Spaltenposition eingefügt.
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 Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex)
Fügt an der angegebenen Stelle in einem Tabellenblatt eine leere Spalte 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex, numColumns)
Fügt ein oder mehrere aufeinanderfolgende leere Spalten in ein Tabellenblatt ein, beginnend an der angegebenen Stelle.
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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 Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsBefore(beforePosition, howMany)
Hiermit werden mehrere Spalten vor der angegebenen Spaltenposition eingefügt.
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 Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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. Blobs dürfen maximal 2 MB groß sein.
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 | Der 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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 Pixelversatz ein. Die Bildgröße wird aus dem Blob-Inhalt abgerufen. Blobs dürfen maximal 2 MB groß sein.
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 | Der Blob mit dem Bildinhalt, dem MIME-Typ und (optional) dem Namen. |
column | Integer | Die Spaltenposition. |
row | Integer | Die Zeilenposition. |
offsetX | Integer | Der horizontale Abstand 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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 Rasterspalte. |
row | Integer | Die Position der Rasterzeile. |
Rückflug
OverGridImage
: Das eingefügte Bild.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row, offsetX, offsetY)
Fügt ein Bild in das Dokument in einer bestimmten Zeile und Spalte mit einem Pixelversatz 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 Abstand 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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 Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex)
Fügt an der angegebenen Stelle in einem Tabellenblatt eine leere Zeile 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex, numRows)
Fügt eine oder mehrere aufeinanderfolgende leere Zeilen in ein Tabellenblatt ein, beginnend an der angegebenen Stelle.
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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 Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsBefore(beforePosition, howMany)
Fügt vor der angegebenen Zeilenposition eine bestimmte Anzahl von Zeilen 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 Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSlicer(range, anchorRowPos, anchorColPos)
Fügt diesem Tabellenblatt einen neuen Sliver 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, über den der Datenschnitt erstellt wird. |
anchorRowPos | Integer | Die Oberseite des Sprengschnitts 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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 Sliver 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, über den der Datenschnitt erstellt wird. |
anchorRowPos | Integer | Die Oberseite des Sprengschnitts ist in dieser Zeile verankert. |
anchorColPos | Integer | Die Oberseite des Slicers ist in dieser Spalte verankert. |
offsetX | Integer | Der horizontale Abstand 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isColumnHiddenByUser(columnPosition)
Gibt an, ob die angegebene Spalte vom Nutzer ausgeblendet ist.
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 prüfenden Spalte. |
Rückflug
Boolean
– true
, wenn die Spalte ausgeblendet ist, andernfalls false
.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRightToLeft()
Gibt true
zurück, wenn das Tabellenlayout von rechts nach links ist. Gibt false
zurück, wenn auf dem Tabellenblatt das Standardlayout 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
bei Rechtsschreibrichtung, false
bei Linksschreibrichtung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByFilter(rowPosition)
Gibt zurück, ob die angegebene Zeile durch einen Filter (nicht durch eine Filteransicht) ausgeblendet ist.
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 Zeile, die geprüft werden soll. |
Rückflug
Boolean
– true
, wenn die Zeile ausgeblendet ist, andernfalls false
.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByUser(rowPosition)
Gibt zurück, ob die angegebene Zeile vom Nutzer ausgeblendet ist.
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 Zeile, die geprüft werden soll. |
Rückflug
Boolean
– true
, wenn die Zeile ausgeblendet ist, andernfalls false
.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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 Position, die durch das destinationIndex
angegeben ist. Das columnSpec
muss nicht genau eine ganze Spalte oder eine Gruppe von Spalten darstellen, die verschoben werden sollen. Es werden alle Spalten ausgewählt, die der Bereich umfasst.
// 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 vor dem Verschieben der Spalten. Vorhandene Daten werden nach rechts verschoben, um Platz für die verschobenen Spalten zu schaffen. Die Quellspalten werden aus dem Raster entfernt. Daher werden die Daten möglicherweise in einem anderen Index als ursprünglich angegeben gespeichert. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveRows(rowSpec, destinationIndex)
Verschiebt die durch den angegebenen Bereich ausgewählten Zeilen an die Position, die durch das destinationIndex
angegeben ist. Das rowSpec
muss nicht genau eine ganze Zeile oder eine Gruppe von Zeilen darstellen, die verschoben werden sollen. Es werden alle Zeilen ausgewählt, die der Bereich umfasst.
// 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 Zeilen umfasst, die verschoben werden sollen. |
destinationIndex | Integer | Der Index, zu dem die Zeilen verschoben werden sollen. Dieser Index basiert auf den Koordinaten vor dem Verschieben der Zeilen. Vorhandene Daten werden nach unten verschoben, um Platz für die verschobenen Zeilen zu schaffen. Die Quellzeilen werden aus dem Raster entfernt. Daher werden die Daten möglicherweise in einem anderen Index als ursprünglich angegeben gespeichert. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
newChart()
Hiermit wird ein Builder zurückgegeben, mit dem ein neues Diagramm für dieses Tabellenblatt erstellt werden kann.
In diesem Beispiel wird gezeigt, wie Sie ein neues Diagramm erstellen:
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 Bearbeitungen geschützt werden kann, mit Ausnahme von Nutzern mit Berechtigung. Solange das Script die Liste der Bearbeiter für das Tabellenblatt nicht tatsächlich ändert (durch Aufruf von Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
oder Festlegen eines neuen Werts für Protection.setDomainEdit(editable)
), entsprechen die Berechtigungen denen des Tabellenblatts selbst. Das bedeutet, dass das Tabellenblatt weiterhin 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRange(range)
Der angegebene Bereich wird als active range
in der aktiven Tabelle festgelegt, wobei die linke obere Zelle im Bereich als current cell
festgelegt wird.
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
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 | Liste der auszuwählenden Bereiche. |
Rückflug
RangeList
: die neu ausgewählte Liste von Bereichen
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(a1Notation)
Legt die aktive Auswahl fest, wie in 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, in A1- oder R1C1-Notation. |
Rückflug
Range
– der neu aktive Bereich
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnGroupControlPosition(position)
Hiermit wird die Position des Schalters für die Spaltengruppensteuerung auf dem Tabellenblatt festgelegt.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setColumnGroupControlPosition( SpreadsheetApp.GroupControlTogglePosition.AFTER, );
Parameter
Name | Typ | Beschreibung |
---|---|---|
position | GroupControlTogglePosition | Die Position der Ein/Aus-Schaltfläche für die Spaltengruppensteuerung. |
Rückflug
Sheet
– dieses Tabellenblatt, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidth(columnPosition, width)
Hiermit wird die Breite der angegebenen Spalte in Pixeln festgelegt.
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 zu setzenden Spalte. |
width | Integer | Die Breite in Pixeln. |
Rückflug
Sheet
– das Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidths(startColumn, numColumns, width)
Hiermit wird die Breite der angegebenen Spalten in Pixeln festgelegt.
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 Startposition der Spalte, die geändert werden soll. |
numColumns | Integer | Die Anzahl der Spalten, die geändert werden sollen. |
width | Integer | Die Breite in Pixeln. |
Rückflug
Sheet
– dieses Tabellenblatt, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setConditionalFormatRules(rules)
Ersetzt alle derzeit vorhandenen Regeln für die bedingte Formatierung in der Tabelle 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setCurrentCell(cell)
Die angegebene Zelle wird als current cell
festgelegt.
Wenn sich die angegebene Zelle in einem bereits ausgewählten Bereich befindet, wird dieser Bereich zum aktiven Bereich und die Zelle zur aktuellen Zelle.
Wenn sich die angegebene Zelle in keinem ausgewählten Bereich befindet, wird die vorhandene Auswahl entfernt und die Zelle wird zur aktuellen Zelle und zum aktiven Bereich.
Hinweis:Die angegebene Range
muss aus einer Zelle bestehen, andernfalls wird eine Ausnahme ausgelöst.
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenColumns(columns)
Die angegebene Anzahl von Spalten wird fixiert. Wenn der Wert „0“ ist, werden keine Spalten eingefroren.
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 Spalten, die fixiert werden sollen. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenRows(rows)
Die angegebene Anzahl von Zeilen wird fixiert. Wenn der Wert „0“ ist, werden keine Zeilen eingefroren.
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 Zeilen, die fixiert werden sollen. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 festgelegt ist, werden die Gitternetzlinien in diesem Tabellenblatt ausgeblendet. Andernfalls werden sie angezeigt. |
Rückflug
Sheet
– dieses Tabellenblatt, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
Legt den Tabellennamen 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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRightToLeft(rightToLeft)
Hiermit wird das Layout des Arbeitsblatts auf „Linksläufig“ festgelegt oder aufgehoben.
// 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 | Bei true ist das Tabellenlayout auf „Von rechts nach links“ gesetzt und Zelle A1 befindet sich oben rechts. Bei false ist das Tabellenlayout auf die Standardeinstellung „Von links nach rechts“ mit Zelle A1 links oben festgelegt. |
Rückflug
Sheet
– dieses Tabellenblatt, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowGroupControlPosition(position)
Hiermit wird die Position des Ein/Aus-Schalters für die Zeilengruppensteuerung auf dem Tabellenblatt festgelegt.
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, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeight(rowPosition, height)
Legt die Zeilenhöhe der angegebenen Zeile in Pixeln fest. Standardmäßig werden Zeilen so lange erweitert, bis sie den Zelleninhalt umfassen. 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. |
Rückflug
Sheet
: Das Tabellenblatt, nützlich für die Methodenverkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeights(startRow, numRows, height)
Legt die Höhe der angegebenen Zeilen in Pixeln fest. Standardmäßig werden Zeilen so lange erweitert, bis sie den Zelleninhalt umfassen. 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 Position der Startzeile, die geändert werden soll. |
numRows | Integer | Die Anzahl der Zeilen, die geändert werden sollen. |
height | Integer | Die Höhe in Pixeln. |
Rückflug
Sheet
– dieses Tabellenblatt, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeightsForced(startRow, numRows, height)
Legt die Höhe der angegebenen Zeilen in Pixeln fest. Standardmäßig werden Zeilen so lange erweitert, bis sie den Zelleninhalt umfassen. Wenn Sie setRowHeightsForced
verwenden, werden Zeilen auf die angegebene Höhe festgelegt, auch wenn der Zelleninhalt höher ist als die Zeilenhöhe.
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 Position der Startzeile, die geändert werden soll. |
numRows | Integer | Die Anzahl der Zeilen, die geändert werden sollen. |
height | Integer | Die Höhe in Pixeln. |
Rückflug
Sheet
– dieses Tabellenblatt, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColor(color)
Legt die Farbe des Tabellenblatts 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 | Einen Farbcode in CSS-Notation (z. B. '#ffffff' oder 'white' ) oder null , um die Tabfarbe zurückzusetzen. |
Rückflug
Sheet
– dieses Tabellenblatt, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColorObject(color)
Legt die Farbe des Tabellenblatts 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 Tabellenblatts. |
Rückflug
Sheet
– dieses Tabellenblatt, für die Verkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex)
Die Spalte am angegebenen Index wird eingeblendet.
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex, numColumns)
Blendet eine oder mehrere aufeinanderfolgende Spalten ab dem angegebenen Index ein.
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 eingeblendet werden sollen. |
numColumns | Integer | Die Anzahl der Spalten, die sichtbar gemacht werden sollen. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex)
Die Zeile am angegebenen Index wird sichtbar gemacht.
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex, numRows)
Eine oder mehrere aufeinanderfolgende Zeilen ab dem angegebenen Index werden sichtbar gemacht.
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 sichtbar gemacht werden sollen. |
numRows | Integer | Die Anzahl der Zeilen, die sichtbar gemacht werden sollen. |
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition)
Sortiert ein Tabellenblatt nach Spalte in aufsteigender Reihenfolge.
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 Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition, ascending)
Sortiert ein Tabellenblatt nach Spalte. Erforderlich ist ein 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 aufsteigend, false für absteigend. |
Rückflug
Sheet
– das Tabellenblatt, nützlich für die Methodenverkettung
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideColumn(column)
Die Spalte im angegebenen Bereich wird eingeblendet.
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 |
---|---|---|