Tabellenblätter aufrufen und bearbeiten Gängige Vorgänge sind das Umbenennen eines Tabellenblatts und der Zugriff auf Bereichsobjekte aus dem Tabellenblatt.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
activate() | Sheet | Aktiviert dieses Tabellenblatt. |
addDeveloperMetadata(key) | Sheet | Fügt dem Tabellenblatt Entwicklermetadaten mit dem angegebenen Schlüssel hinzu. |
addDeveloperMetadata(key, visibility) | Sheet | Fügt dem Tabellenblatt Entwicklermetadaten mit dem angegebenen Schlüssel und der angegebenen Sichtbarkeit hinzu. |
addDeveloperMetadata(key, value) | Sheet | Fügt dem Tabellenblatt Entwicklermetadaten mit dem angegebenen Schlüssel und Wert hinzu. |
addDeveloperMetadata(key, value, visibility) | Sheet | Fügt dem Tabellenblatt Entwicklermetadaten mit dem angegebenen Schlüssel, Wert und der Sichtbarkeit hinzu. |
appendRow(rowContents) | Sheet | Hängt am Ende des aktuellen Datenbereichs im Tabellenblatt eine Zeile an. |
asDataSourceSheet() | DataSourceSheet | Gibt das Tabellenblatt als DataSourceSheet zurück, wenn das Tabellenblatt vom Typ SheetType.DATASOURCE ist, andernfalls als null . |
autoResizeColumn(columnPosition) | Sheet | Legt die Breite der angegebenen Spalte so fest, dass sie in den Inhalt passt. |
autoResizeColumns(startColumn, numColumns) | Sheet | Legt die Breite aller Spalten, beginnend an der angegebenen Spaltenposition, für den Inhalt fest. |
autoResizeRows(startRow, numRows) | Sheet | Legt die Höhe aller Zeilen, beginnend an der angegebenen Zeilenposition, für den Inhalt fest. |
clear() | Sheet | Löscht die Inhalts- und Formatierungsinformationen auf dem Tabellenblatt. |
clear(options) | Sheet | Löscht die Inhalte 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 | Löscht den Inhalt des Tabellenblatts, während die Formatierungsinformationen erhalten bleiben. |
clearFormats() | Sheet | Löscht die Formatierung des Tabellenblatts, während der Inhalt beibehalten wird. |
clearNotes() | Sheet | Löscht das Tabellenblatt mit allen Notizen. |
collapseAllColumnGroups() | Sheet | Minimiert alle Spaltengruppen im Tabellenblatt. |
collapseAllRowGroups() | Sheet | Minimiert alle Zeilengruppen im Tabellenblatt. |
copyTo(spreadsheet) | Sheet | Kopiert das Tabellenblatt in eine bestimmte Tabellenkalkulation, die mit der Quelle identisch sein kann. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Gibt ein DeveloperMetadataFinder zurück, um Entwicklermetadaten im Bereich dieser Tabelle zu finden. |
createTextFinder(findText) | TextFinder | Erstellt eine Textsuche für das Tabellenblatt, mit der Text im Tabellenblatt gesucht und ersetzt werden kann. |
deleteColumn(columnPosition) | Sheet | Löscht die Spalte an der angegebenen Spaltenposition. |
deleteColumns(columnPosition, howMany) | void | Löscht eine Reihe von Spalten ab der angegebenen Spaltenposition. |
deleteRow(rowPosition) | Sheet | Löscht die Zeile an der angegebenen Zeilenposition. |
deleteRows(rowPosition, howMany) | void | Löscht eine bestimmte Anzahl von Zeilen ab der angegebenen Zeilenposition. |
expandAllColumnGroups() | Sheet | Maximiert alle Spaltengruppen im Tabellenblatt. |
expandAllRowGroups() | Sheet | Maximiert alle Zeilengruppen im Tabellenblatt. |
expandColumnGroupsUpToDepth(groupDepth) | Sheet | Maximiert alle Spaltengruppen bis zur angegebenen Tiefe und minimiert alle anderen. |
expandRowGroupsUpToDepth(groupDepth) | Sheet | Maximiert alle Zeilengruppen bis zur angegebenen Tiefe und minimiert alle anderen. |
getActiveCell() | Range | Gibt die aktive Zelle in diesem Tabellenblatt zurück. |
getActiveRange() | Range | Gibt den ausgewählten Bereich im aktiven Tabellenblatt zurück oder null , wenn kein aktiver Bereich vorhanden ist |
getActiveRangeList() | RangeList | Gibt die Liste der aktiven Bereiche im aktiven Tabellenblatt zurück oder null , wenn keine aktiven Bereiche vorhanden sind. |
getBandings() | Banding[] | Gibt alle Bandings in diesem Blatt zurück. |
getCharts() | EmbeddedChart[] | Gibt ein Array mit Diagrammen auf diesem Tabellenblatt zurück. |
getColumnGroup(columnIndex, groupDepth) | Group | Gibt die Spaltengruppe mit dem angegebenen Index und der angegebenen Gruppentiefe zurück. |
getColumnGroupControlPosition() | GroupControlTogglePosition | Gibt das GroupControlTogglePosition für alle Spaltengruppen im Tabellenblatt zurück. |
getColumnGroupDepth(columnIndex) | Integer | Gibt die Gruppentiefe der Spalte beim angegebenen Index zurück. |
getColumnWidth(columnPosition) | Integer | Ruft die Breite der angegebenen Spalte in Pixeln ab. |
getConditionalFormatRules() | ConditionalFormatRule[] | Rufen Sie alle Regeln für die bedingte Formatierung in diesem Tabellenblatt ab. |
getCurrentCell() | Range | Gibt die aktuelle Zelle im aktiven Tabellenblatt zurück oder null , wenn keine Zelle vorhanden ist. |
getDataRange() | Range | Gibt eine Range zurück, die den Dimensionen entspricht, in denen Daten vorhanden sind. |
getDataSourceFormulas() | DataSourceFormula[] | Ruft alle Formeln für Datenquellen ab. |
getDataSourcePivotTables() | DataSourcePivotTable[] | Ruft alle Pivot-Tabellen der Datenquelle ab. |
getDataSourceTables() | DataSourceTable[] | Ruft alle Datenquellentabellen ab. |
getDeveloperMetadata() | DeveloperMetadata[] | Alle mit diesem Tabellenblatt verknüpften Entwicklermetadaten abrufen. |
getDrawings() | Drawing[] | Gibt ein Array mit Zeichnungen auf dem Tabellenblatt zurück. |
getFilter() | Filter | Gibt den Filter in diesem Tabellenblatt zurück oder null , wenn kein Filter vorhanden ist. |
getFormUrl() | String | Gibt die URL für das Formular zurück, das seine Antworten an dieses Tabellenblatt sendet, oder null , wenn dem Tabellenblatt kein Formular zugeordnet ist |
getFrozenColumns() | Integer | Gibt die Anzahl der fixierten Spalten zurück |
getFrozenRows() | Integer | Gibt die Anzahl der fixierten Zeilen zurück |
getImages() | OverGridImage[] | Gibt alle über das Raster gelegten Bilder im Tabellenblatt zurück. |
getIndex() | Integer | Ruft die Position des Tabellenblatts in seiner übergeordneten Tabellenkalkulation 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[] | Ruft alle benannten Bereiche in diesem Tabellenblatt ab. |
getParent() | Spreadsheet | Gibt das Spreadsheet zurück, das dieses Tabellenblatt enthält. |
getPivotTables() | PivotTable[] | Gibt alle Pivot-Tabellen auf diesem Tabellenblatt zurück |
getProtections(type) | Protection[] | Ruft ein Array mit Objekten ab, die alle geschützten Bereiche im Tabellenblatt darstellen, oder ein Array mit einem einzelnen Element, das den Schutz auf dem Tabellenblatt selbst darstellt. |
getRange(row, column) | Range | Gibt den Bereich zurück, in dem sich die linke obere Zelle an den angegebenen Koordinaten befindet. |
getRange(row, column, numRows) | Range | Gibt den Bereich zurück, in dem sich die linke obere Zelle an den angegebenen Koordinaten und die angegebene Anzahl von Zeilen befindet. |
getRange(row, column, numRows, numColumns) | Range | Gibt den Bereich zurück, in dem sich die linke obere Zelle an den angegebenen Koordinaten mit der angegebenen Anzahl von Zeilen und Spalten befindet. |
getRange(a1Notation) | Range | Gibt den Bereich in der A1- oder R1C1-Notation zurück. |
getRangeList(a1Notations) | RangeList | Gibt die Sammlung RangeList zurück, die die Bereiche im selben Tabellenblatt darstellt, die durch eine nicht leere Liste von A1- oder R1C1-Notationen angegeben werden. |
getRowGroup(rowIndex, groupDepth) | Group | Gibt die Zeilengruppe mit dem angegebenen Index und der angegebenen Gruppentiefe zurück. |
getRowGroupControlPosition() | GroupControlTogglePosition | Gibt das GroupControlTogglePosition für alle Zeilengruppen im Tabellenblatt zurück. |
getRowGroupDepth(rowIndex) | Integer | Gibt die Gruppentiefe der Zeile beim angegebenen Index zurück. |
getRowHeight(rowPosition) | Integer | Ruft die Höhe einer gegebenen Zeile in Pixeln ab. |
getSelection() | Selection | Gibt die aktuelle Selection in der Tabelle zurück. |
getSheetId() | Integer | Gibt die ID des durch dieses Objekt dargestellten Tabellenblatts zurück |
getSheetName() | String | Gibt den Namen des Tabellenblatts zurück |
getSheetValues(startRow, startColumn, numRows, numColumns) | Object[][] | Gibt das rechteckige Werteraster für diesen Bereich zurück, beginnend bei den angegebenen Koordinaten. |
getSlicers() | Slicer[] | Gibt ein Array von Datenschnitten im Tabellenblatt zurück. |
getTabColorObject() | Color | Ruft die Tabfarbe des Tabellenblatts ab oder null , wenn der Tab des Tabellenblatts keine Farbe hat |
getType() | SheetType | Gibt den Typ des Tabellenblatts zurück. |
hasHiddenGridlines() | Boolean | Gibt true zurück, wenn die Gitternetzlinien des Tabellenblatts ausgeblendet sind. Andernfalls wird false zurückgegeben. |
hideColumn(column) | void | Blendet die Spalte(n) im angegebenen Bereich aus. |
hideColumns(columnIndex) | void | Blendet eine einzelne Spalte beim angegebenen Index aus. |
hideColumns(columnIndex, numColumns) | void | Blendet eine oder mehrere aufeinanderfolgende Spalten ab dem angegebenen Index aus. |
hideRow(row) | void | Blendet die Zeilen im angegebenen Bereich aus. |
hideRows(rowIndex) | void | Blendet die Zeile beim angegebenen Index aus. |
hideRows(rowIndex, numRows) | void | Blendet eine oder mehrere aufeinanderfolgende Zeilen ab dem angegebenen Index aus. |
hideSheet() | Sheet | Blendet dieses Tabellenblatt aus. |
insertChart(chart) | void | Fügt diesem Tabellenblatt ein neues Diagramm hinzu. |
insertColumnAfter(afterPosition) | Sheet | Fügt eine Spalte nach der angegebenen Spaltenposition ein. |
insertColumnBefore(beforePosition) | Sheet | Fügt eine Spalte vor der angegebenen Spaltenposition ein. |
insertColumns(columnIndex) | void | Fügt an der angegebenen Stelle eine leere Spalte in ein Tabellenblatt ein. |
insertColumns(columnIndex, numColumns) | void | Fügt eine oder mehrere aufeinanderfolgende leere Spalten in ein Tabellenblatt ein, beginnend an der angegebenen Position. |
insertColumnsAfter(afterPosition, howMany) | Sheet | Fügt eine bestimmte Anzahl von Spalten nach der angegebenen Spaltenposition ein. |
insertColumnsBefore(beforePosition, howMany) | Sheet | Fügt eine bestimmte Anzahl von Spalten vor der angegebenen Spaltenposition ein. |
insertImage(blobSource, column, row) | OverGridImage | Fügt ein BlobSource als Bild in das Dokument bei einer bestimmten Zeile und Spalte ein. |
insertImage(blobSource, column, row, offsetX, offsetY) | OverGridImage | Fügt im Dokument an einer bestimmten Zeile und Spalte ein BlobSource als Bild mit Pixelversatz ein. |
insertImage(url, column, row) | OverGridImage | Fügt in einer bestimmten Zeile und Spalte ein Bild in das Dokument ein. |
insertImage(url, column, row, offsetX, offsetY) | OverGridImage | Fügt im Dokument ein Bild mit einem Pixelversatz in einer bestimmten Zeile und Spalte ein. |
insertRowAfter(afterPosition) | Sheet | Fügt eine Zeile nach der angegebenen Zeilenposition ein. |
insertRowBefore(beforePosition) | Sheet | Fügt eine Zeile vor der angegebenen Zeilenposition ein. |
insertRows(rowIndex) | void | Fügt an der angegebenen Position in ein 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 Position. |
insertRowsAfter(afterPosition, howMany) | Sheet | Fügt eine bestimmte Anzahl von Zeilen nach der angegebenen Zeilenposition ein. |
insertRowsBefore(beforePosition, howMany) | Sheet | Fügt eine bestimmte Anzahl von Zeilen vor der angegebenen Zeilenposition ein. |
insertSlicer(range, anchorRowPos, anchorColPos) | Slicer | Fügt diesem Tabellenblatt einen neuen Datenschnitt hinzu. |
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY) | Slicer | Fügt diesem Tabellenblatt einen neuen Datenschnitt hinzu. |
isColumnHiddenByUser(columnPosition) | Boolean | Gibt zurück, ob die angegebene Spalte vom Nutzer ausgeblendet wurde. |
isRightToLeft() | Boolean | Gibt true zurück, wenn das Tabellenblatt von rechts nach links angeordnet ist. |
isRowHiddenByFilter(rowPosition) | Boolean | Gibt zurück, ob die angegebene Zeile durch einen Filter (nicht durch eine Filteransicht) ausgeblendet wurde. |
isRowHiddenByUser(rowPosition) | Boolean | Gibt zurück, ob die angegebene Zeile vom Nutzer ausgeblendet wurde. |
isSheetHidden() | Boolean | Gibt true zurück, wenn das Tabellenblatt gerade ausgeblendet ist. |
moveColumns(columnSpec, destinationIndex) | void | Verschiebt die durch den angegebenen Bereich ausgewählten Spalten an die durch destinationIndex angegebene Position. |
moveRows(rowSpec, destinationIndex) | void | Verschiebt die durch den angegebenen Bereich ausgewählten Zeilen an die durch destinationIndex angegebene Position. |
newChart() | EmbeddedChartBuilder | Gibt einen Builder zurück, um ein neues Diagramm für dieses Tabellenblatt zu erstellen. |
protect() | Protection | Erstellt ein Objekt, das verhindern kann, dass das Tabellenblatt bearbeitet wird, außer von Nutzern mit entsprechender Berechtigung. |
removeChart(chart) | void | Entfernt ein Diagramm aus dem übergeordneten Tabellenblatt. |
setActiveRange(range) | Range | Legt den angegebenen Bereich als active range im aktiven Tabellenblatt fest, wobei die linke obere Zelle im Bereich als current cell festgelegt ist. |
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 wie in der A1- oder R1C1-Notation angegeben fest. |
setColumnGroupControlPosition(position) | Sheet | Legt die Position der Ein-/Aus-Schaltfläche für die Spaltengruppensteuerung auf dem Tabellenblatt fest. |
setColumnWidth(columnPosition, width) | Sheet | Legt die Breite der angegebenen Spalte in Pixeln fest. |
setColumnWidths(startColumn, numColumns, width) | Sheet | Legt die Breite der angegebenen Spalten in Pixeln fest. |
setConditionalFormatRules(rules) | void | Alle derzeit vorhandenen Regeln für die bedingte Formatierung im Tabellenblatt werden durch die Eingaberegeln ersetzt. |
setCurrentCell(cell) | Range | Legt die angegebene Zelle als current cell fest. |
setFrozenColumns(columns) | void | Fixiert die angegebene Anzahl von Spalten. |
setFrozenRows(rows) | void | Fixiert die angegebene Anzahl von Zeilen. |
setHiddenGridlines(hideGridlines) | Sheet | Blendet die Gitternetzlinien des Tabellenblatts ein oder aus. |
setName(name) | Sheet | Legt den Namen des Tabellenblatts fest. |
setRightToLeft(rightToLeft) | Sheet | Legt fest, dass das Tabellenblatt von rechts nach links ausgerichtet wird. |
setRowGroupControlPosition(position) | Sheet | Legt die Position der Ein-/Aus-Schaltfläche für die Zeilengruppe auf dem Tabellenblatt fest. |
setRowHeight(rowPosition, height) | Sheet | Legt die Zeilenhöhe der angegebenen Zeile in Pixeln fest. |
setRowHeights(startRow, numRows, height) | Sheet | Legt die Höhe der angegebenen Zeilen in Pixeln fest. |
setRowHeightsForced(startRow, numRows, height) | Sheet | Legt die Höhe der angegebenen Zeilen in Pixeln fest. |
setTabColor(color) | Sheet | Legt die Farbe der Registerkarte für das Tabellenblatt fest. |
setTabColorObject(color) | Sheet | Legt die Farbe der Registerkarte für das Tabellenblatt fest. |
showColumns(columnIndex) | void | Blendet die Spalte beim angegebenen Index ein |
showColumns(columnIndex, numColumns) | void | Blendet eine oder mehrere aufeinanderfolgende Spalten ab dem angegebenen Index ein. |
showRows(rowIndex) | void | Blendet die Zeile beim angegebenen Index ein |
showRows(rowIndex, numRows) | void | Blendet eine oder mehrere aufeinanderfolgende Zeilen ab dem angegebenen Index ein. |
showSheet() | Sheet | Macht das Tabellenblatt sichtbar. |
sort(columnPosition) | Sheet | Sortiert ein Tabellenblatt aufsteigend nach Spalte. |
sort(columnPosition, ascending) | Sheet | Sortiert ein Tabellenblatt nach Spalten. |
unhideColumn(column) | void | Blendet die Spalte im angegebenen Bereich ein |
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 Vorstellung des aktiven Tabellenblatts durch das übergeordnete Tabellenblatt.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.activate();
Return
Sheet
: Das neu aktive Tabellenblatt.
addDeveloperMetadata(key)
Fügt dem Tabellenblatt 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. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
Fügt dem Tabellenblatt Entwicklermetadaten mit dem angegebenen Schlüssel und der angegebenen Sichtbarkeit hinzu.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'NAME' and sets the developer metadata visibility to PROJECT // for the sheet. sheet.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getVisibility().toString());
Parameter
Name | Typ | Beschreibung |
---|---|---|
key | String | Der Schlüssel für die neuen Entwicklermetadaten. |
visibility | DeveloperMetadataVisibility | Die Sichtbarkeit der neuen Entwicklermetadaten. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Fügt dem 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. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Fügt dem 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. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
appendRow(rowContents)
Hängt am Ende des aktuellen Datenbereichs im Tabellenblatt eine Zeile an. Wenn der Inhalt einer Zelle mit =
beginnt, wird dies als Formel interpretiert.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Appends a new row with 3 columns to the bottom of the current // data region in the sheet containing the values in the array. sheet.appendRow(["a man", "a plan", "panama"]);
Parameter
Name | Typ | Beschreibung |
---|---|---|
rowContents | Object[] | Ein Array von Werten, die nach der letzten Zeile im Tabellenblatt eingefügt werden sollen. |
Return
Sheet
: Das Tabellenblatt, das für die Verkettung von Methoden nützlich ist.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
asDataSourceSheet()
Gibt das Tabellenblatt als DataSourceSheet
zurück, wenn das Tabellenblatt 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());
Return
DataSourceSheet
: Ein Tabellenblatt in einer Datenquelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnPosition)
Legt die Breite der angegebenen Spalte so fest, dass sie in den Inhalt passt.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...'); // Sets the first column to a width which fits the text sheet.autoResizeColumn(1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnPosition | Integer | Die Position der Spalte, deren Größe geändert werden soll. |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumns(startColumn, numColumns)
Legt die Breite aller Spalten, beginnend an der angegebenen Spaltenposition, für den Inhalt fest.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first 15 columns to a width that fits their text. sheet.autoResizeColumns(1, 15);
Parameter
Name | Typ | Beschreibung |
---|---|---|
startColumn | Integer | Die Startspalte für die automatische Anpassung der Größe. |
numColumns | Integer | Anzahl der Spalten, deren Größe automatisch angepasst werden soll. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeRows(startRow, numRows)
Legt die Höhe aller Zeilen, beginnend an der angegebenen Zeilenposition, für den Inhalt fest.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 erste Zeile, deren Größe automatisch angepasst werden soll. |
numRows | Integer | Anzahl der Zeilen, deren Größe automatisch angepasst werden soll. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Löscht die Inhalts- und Formatierungsinformationen auf dem Tabellenblatt.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clear();
Return
Sheet
: Das gelöschte Tabellenblatt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Löscht die Inhalte und/oder das Format des Tabellenblatts, wie in den erweiterten Optionen angegeben.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.clear({ formatOnly: true, contentsOnly: true });
Parameter
Name | Typ | Beschreibung |
---|---|---|
options | Object | Eine JavaScript-Karte mit den erweiterten Optionen, die unten aufgeführt sind. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
contentsOnly | Boolean | Gibt an, ob der Inhalt gelöscht werden soll. |
formatOnly | Boolean | Gibt an, ob das Format gelöscht werden soll. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearConditionalFormatRules()
Entfernt alle Regeln für die bedingte Formatierung aus dem Tabellenblatt. Entspricht dem Aufruf von setConditionalFormatRules(rules)
mit einem leeren Array als Eingabe.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.clearConditionalFormatRules();
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContents()
Löscht den Inhalt des Tabellenblatts, während die Formatierungsinformationen erhalten bleiben.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearContents();
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormats()
Löscht die Formatierung des Tabellenblatts, während der Inhalt beibehalten wird.
Die Formatierung bezieht sich darauf, wie Daten gemäß den Optionen im Menü "Format" formatiert werden (z. B. fett, kursiv, bedingte Formatierung) und nicht die Breite oder Höhe von Zellen.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearFormats();
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNotes()
Löscht das Tabellenblatt mit allen Notizen.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearNotes();
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllColumnGroups()
Minimiert alle Spaltengruppen im Tabellenblatt.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are collapsed. sheet.collapseAllColumnGroups();
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllRowGroups()
Minimiert alle Zeilengruppen im Tabellenblatt.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are collapsed. sheet.collapseAllRowGroups();
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(spreadsheet)
Kopiert das Tabellenblatt in eine bestimmte Tabellenkalkulation, die mit der Quelle identisch sein kann. Das kopierte Tabellenblatt heißt „Kopie von [Originalname]“.
var source = SpreadsheetApp.getActiveSpreadsheet(); var sheet = source.getSheets()[0]; var destination = SpreadsheetApp.openById('ID_GOES HERE'); sheet.copyTo(destination);
Parameter
Name | Typ | Beschreibung |
---|---|---|
spreadsheet | Spreadsheet | Die Tabelle, in die das Tabellenblatt kopiert werden soll. Dabei kann es sich um dieselbe Tabelle wie die Quelle handeln. |
Return
Sheet
: Das neue Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Gibt ein DeveloperMetadataFinder
zurück, um Entwicklermetadaten im Bereich dieser Tabelle zu finden. Metadaten fallen in ein bestimmtes Tabellenblatt, wenn sie entweder mit dem Tabellenblatt selbst oder mit einer Zeile, einer 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());
Return
DeveloperMetadataFinder
: Ein Entwicklermetadaten-Finder, mit dem Sie nach Metadaten im Rahmen dieser Tabelle suchen können.
createTextFinder(findText)
Erstellt eine Textsuche für das Tabellenblatt, mit der Text im Tabellenblatt gesucht und ersetzt werden kann.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Creates a text finder. var textFinder = sheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the sheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
Parameter
Name | Typ | Beschreibung |
---|---|---|
findText | String | Der Text, nach dem gesucht werden soll. |
Return
TextFinder
: Der TextFinder
für das Tabellenblatt.
deleteColumn(columnPosition)
Löscht die Spalte an der angegebenen Spaltenposition.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 bei 1 für die erste Spalte. |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumns(columnPosition, howMany)
Löscht eine Reihe von Spalten ab der angegebenen Spaltenposition.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 zu löschenden Spalte. |
howMany | Integer | Die Anzahl der zu löschenden Spalten. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRow(rowPosition)
Löscht die Zeile an der angegebenen Zeilenposition.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 bei 1 für die erste Zeile. |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRows(rowPosition, howMany)
Löscht eine bestimmte Anzahl von Zeilen ab der angegebenen Zeilenposition.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandAllColumnGroups()
Maximiert alle Spaltengruppen im Tabellenblatt. Für diese Methode ist mindestens eine Spaltengruppe erforderlich.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are expanded. sheet.expandAllColumnGroups();
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandAllRowGroups()
Maximiert alle Zeilengruppen im Tabellenblatt. Für diese Methode ist mindestens eine Zeilengruppe erforderlich.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are expanded. sheet.expandAllRowGroups();
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandColumnGroupsUpToDepth(groupDepth)
Maximiert alle Spaltengruppen bis zur angegebenen Tiefe und minimiert alle anderen.
var 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 erweitert werden sollen. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandRowGroupsUpToDepth(groupDepth)
Maximiert alle Zeilengruppen bis zur angegebenen Tiefe und minimiert alle anderen.
var 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 erweitert werden sollen. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveCell()
Gibt die aktive Zelle in diesem Tabellenblatt zurück.
Hinweis:Wir empfehlen die Verwendung von getCurrentCell()
, da damit die aktuell markierte Zelle zurückgegeben wird.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
Return
Range
: die aktuell aktive Zelle
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 im aktiven Tabellenblatt ausgewählt hat. In einer benutzerdefinierten Funktion bezieht er sich jedoch auf die Zelle, die aktiv neu berechnet wird.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var activeRange = sheet.getActiveRange();
Return
Range
– der aktive Bereich
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 dies wie ein getActiveRange()
-Aufruf.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
Return
RangeList
– die Liste der aktiven Bereiche
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Weitere Informationen
getBandings()
Gibt alle Bandings in diesem Blatt 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()); }
Return
Banding[]
: alle Streifen in diesem Blatt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCharts()
Gibt ein Array mit Diagrammen auf diesem Tabellenblatt zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; // Do something with the chart }
Return
EmbeddedChart[]
: Ein Array mit Diagrammen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroup(columnIndex, groupDepth)
Gibt die Spaltengruppe mit dem angegebenen Index und der angegebenen Gruppentiefe zurück.
var 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. var columnGroup = sheet.getColumnGroup(2, 1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnIndex | Integer | Der Spaltenindex der Ein-/Aus-Schaltfläche für die Gruppensteuerung oder ein Index innerhalb der Gruppe. |
groupDepth | Integer | Die Tiefe der Gruppe. |
Return
Group
: Die Spaltengruppe am Kontrollindex und in der Tiefe oder löst eine Ausnahme aus, wenn die Gruppe nicht vorhanden ist.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupControlPosition()
Gibt das GroupControlTogglePosition
für alle Spaltengruppen im Tabellenblatt zurück.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the column grouping control toggle is shown after the // group. var columnGroupControlPosition = sheet.getColumnGroupControlPosition();
Return
GroupControlTogglePosition
: true
, wenn die Ein-/Aus-Schaltfläche für die Spaltengruppierung auf diesem Tabellenblatt nach der Gruppe angezeigt wird, andernfalls false
.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupDepth(columnIndex)
Gibt die Gruppentiefe der Spalte beim angegebenen Index zurück.
Die Gruppentiefe gibt an, wie viele Gruppen sich mit der Spalte überschneiden. Diese kann zwischen null und acht liegen.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over columns 1 through 3 var groupDepth = sheet.getColumnGroupDepth(1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnIndex | Integer | Der Index der Spalte. |
Return
Integer
: Die Gruppentiefe der Spalte beim angegebenen Index.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnWidth(columnPosition)
Ruft die Breite der angegebenen Spalte in Pixeln ab.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnPosition | Integer | Die Position der zu untersuchenden Spalte. |
Return
Integer
: Spaltenbreite in Pixeln
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getConditionalFormatRules()
Rufen Sie alle Regeln für die bedingte Formatierung in diesem Tabellenblatt ab.
// Logs the conditional format rules in a sheet. var rules = SpreadsheetApp.getActiveSheet().getConditionalFormatRules(); for (var i = 0; i < rules.length; i++) { var rule = rules[i]; Logger.log(rule); }
Return
ConditionalFormatRule[]
: Ein Array aller Regeln im Tabellenblatt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCurrentCell()
Gibt die aktuelle Zelle im aktiven Tabellenblatt zurück oder null
, wenn keine Zelle vorhanden ist. Die aktuelle Zelle ist in der Benutzeroberfläche von Google Tabellen im Fokus und wird 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.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
Return
Range
: die aktuelle Zelle
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRange()
Gibt eine Range
zurück, die den Dimensionen entspricht, in denen Daten vorhanden sind.
Dies entspricht funktional der Erstellung eines durch A1 und (Sheet.getLastColumn(), Sheet.getLastRow()) begrenzten Bereichs.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This represents ALL the data var range = sheet.getDataRange(); var values = range.getValues(); // This logs the spreadsheet in CSV format with a trailing comma for (var i = 0; i < values.length; i++) { var row = ""; for (var j = 0; j < values[i].length; j++) { if (values[i][j]) { row = row + values[i][j]; } row = row + ","; } Logger.log(row); }
Return
Range
: ein Bereich, der aus allen Daten in der Tabelle besteht
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
Ruft alle Formeln für Datenquellen ab.
// Opens the spreadsheet by its ID. If you created your script from within a Google Sheets // file, use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source formulas on Sheet1. // To get an array of data source formulas for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceFormulas = sheet.getDataSourceFormulas(); // Logs the first data source formula in the array. console.log(dataSourceFormulas[0].getFormula());
Return
DataSourceFormula[]
: Eine Liste mit Datenquellenformeln.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
Ruft alle Pivot-Tabellen der Datenquelle ab.
// 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());
Return
DataSourcePivotTable[]
: Eine Liste der Pivot-Tabellen der Datenquelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
Ruft alle Datenquellentabellen ab.
// 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());
Return
DataSourceTable[]
: Eine Liste mit Datenquellentabellen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
Alle mit diesem Tabellenblatt verknüpften Entwicklermetadaten abrufen.
// 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()); }
Return
DeveloperMetadata[]
: Die mit diesem Tabellenblatt verknüpften Entwicklermetadaten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDrawings()
Gibt ein Array mit 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);
Return
Drawing[]
: die Liste der Zeichnungen auf diesem Tabellenblatt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
Gibt den Filter in diesem Tabellenblatt zurück oder null
, wenn kein Filter vorhanden ist.
// Gets the filter on the active sheet. let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter();
Return
Filter
: Der Filter.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormUrl()
Gibt die URL für das Formular zurück, das seine Antworten an dieses Tabellenblatt sendet, oder null
, wenn dem Tabellenblatt kein Formular zugeordnet ist
var sheet = SpreadsheetApp.getActiveSheet(); var url = sheet.getFormUrl();
Return
String
: Die URL für das Formular, über das Antworten in dieses Tabellenblatt eingefügt werden, oder null
, wenn dieses Tabellenblatt nicht mit einem Formular verknüpft ist.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenColumns()
Gibt die Anzahl der fixierten Spalten zurück
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
Return
Integer
: die Anzahl der fixierten Spalten
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenRows()
Gibt die Anzahl der fixierten Zeilen zurück
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
Return
Integer
: die Anzahl der fixierten Zeilen
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getImages()
Gibt alle über das Raster gelegten Bilder im Tabellenblatt zurück.
// 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()); }
Return
OverGridImage[]
: Ein Array von Bildern, die über das Raster gelegt werden.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getIndex()
Ruft die Position des Tabellenblatts in seiner übergeordneten Tabellenkalkulation ab. Beginnt bei 1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); // Note that the JavaScript index is 0, but this logs 1 var sheet = ss.getSheets()[0]; // ... because spreadsheets are 1-indexed Logger.log(sheet.getIndex());
Return
Integer
: Position des Tabellenblatts in der übergeordneten Tabelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
Gibt die Position der letzten Spalte mit Inhalt zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Return
Integer
: Die letzte Spalte des Tabellenblatts, die Inhalte enthält.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
Gibt die Position der letzten Zeile mit Inhalt zurück.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Return
Integer
: die letzte Zeile des Tabellenblatts, die Inhalte enthält
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxColumns()
Gibt die aktuelle Anzahl der Spalten im Tabellenblatt zurück, unabhängig vom Inhalt.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); Logger.log(first.getMaxColumns());
Return
Integer
: Die maximale Breite des Tabellenblatts.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxRows()
Gibt die aktuelle Anzahl der Zeilen im Tabellenblatt zurück, unabhängig vom Inhalt.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); Logger.log(first.getMaxRows());
Return
Integer
: Die maximale Höhe des Tabellenblatts.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getName()
Gibt den Namen des Tabellenblatts zurück
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getName());
Return
String
: Der Name des Tabellenblatts.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNamedRanges()
Ruft alle benannten Bereiche in diesem Tabellenblatt ab.
// The code below logs the name of the first named range. var namedRanges = SpreadsheetApp.getActiveSheet().getNamedRanges(); if (namedRanges.length > 1) { Logger.log(namedRanges[0].getName()); }
Return
NamedRange[]
: Ein Array aller benannten Bereiche im Tabellenblatt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getParent()
Gibt das Spreadsheet
zurück, das dieses Tabellenblatt enthält.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // parent is identical to ss var parent = sheet.getParent();
Return
Spreadsheet
: die übergeordnete Tabelle.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getPivotTables()
Gibt alle Pivot-Tabellen auf 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()); }
Return
PivotTable[]
: die Pivot-Tabellen auf diesem Tabellenblatt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getProtections(type)
Ruft ein Array mit Objekten ab, die alle geschützten Bereiche im Tabellenblatt darstellen, oder ein Array mit einem einzelnen Element, das den Schutz auf dem Tabellenblatt selbst darstellt.
// Remove all range protections in the spreadsheet that the user has permission to edit. var sheet = SpreadsheetApp.getActiveSheet(); var protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove sheet protection from the active sheet, if the user has permission to edit it. var sheet = SpreadsheetApp.getActiveSheet(); var protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0]; if (protection && protection.canEdit()) { protection.remove(); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
type | ProtectionType | Der Typ des Schutzgebiets, entweder SpreadsheetApp.ProtectionType.RANGE oder SpreadsheetApp.ProtectionType.SHEET . |
Return
Protection[]
: ein Array mit Objekten, die alle geschützten Bereiche im Tabellenblatt darstellen, oder ein Array mit einem Element, das den Schutz auf dem Tabellenblatt selbst darstellt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column)
Gibt den Bereich zurück, in dem sich die linke obere Zelle an den angegebenen Koordinaten befindet.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Passing only two arguments returns a "range" with a single cell. var range = sheet.getRange(1, 1); var values = range.getValues(); Logger.log(values[0][0]);
Parameter
Name | Typ | Beschreibung |
---|---|---|
row | Integer | Der Zeilenindex der Zelle, die zurückgegeben werden soll; der Zeilenindexierung beginnt mit 1. |
column | Integer | Der Spaltenindex der Zelle, die zurückgegeben werden soll. Die Spaltenindexierung beginnt mit 1. |
Return
Range
: Ein Bereich, der nur diese Zelle enthält.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column, numRows)
Gibt den Bereich zurück, in dem sich die linke obere Zelle an den angegebenen Koordinaten und die angegebene Anzahl von Zeilen befindet.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // When the "numRows" argument is used, only a single column of data is returned. var range = sheet.getRange(1, 1, 3); var values = range.getValues(); // Prints 3 values from the first column, starting from row 1. for (var row in values) { for (var col in values[row]) { Logger.log(values[row][col]); } }
Parameter
Name | Typ | Beschreibung |
---|---|---|
row | Integer | Der Startzeilenindex des Bereichs; der Zeilenindexierung beginnt mit 1. |
column | Integer | Der Spaltenindex des Bereichs; die Spaltenindexierung beginnt mit 1. |
numRows | Integer | Die Anzahl der zurückzugebenden Zeilen. |
Return
Range
: Ein Bereich, der eine einzelne Datenspalte mit der angegebenen Anzahl von Zeilen enthält.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column, numRows, numColumns)
Gibt den Bereich zurück, in dem sich die linke obere Zelle an den angegebenen Koordinaten mit der angegebenen Anzahl von Zeilen und Spalten befindet.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange(1, 1, 3, 3); var values = range.getValues(); // Print values from a 3x3 box. for (var row in values) { for (var col in values[row]) { Logger.log(values[row][col]); } }
Parameter
Name | Typ | Beschreibung |
---|---|---|
row | Integer | Der Startzeilenindex des Bereichs; der Zeilenindexierung beginnt mit 1. |
column | Integer | Der Startspaltenindex des Bereichs; die Spaltenindexierung beginnt mit 1. |
numRows | Integer | Die Anzahl der zurückzugebenden Zeilen. |
numColumns | Integer | Die Anzahl der zurückzugebenden Spalten. |
Return
Range
: Ein Bereich, der dem angegebenen Bereich entspricht.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(a1Notation)
Gibt den Bereich in der A1- oder R1C1-Notation zurück.
// Get a range A1:D4 on sheet titled "Invoices" var ss = SpreadsheetApp.getActiveSpreadsheet(); var range = ss.getRange("Invoices!A1:D4"); // Get cell A1 on the first sheet var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1");
Parameter
Name | Typ | Beschreibung |
---|---|---|
a1Notation | String | Der zurückzugebende Bereich, wie in A1- oder R1C1-Notation angegeben. |
Return
Range
: der Bereich am festgelegten Ort
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRangeList(a1Notations)
Gibt die Sammlung RangeList
zurück, die die Bereiche im selben Tabellenblatt darstellt, die durch eine nicht leere Liste von A1- oder R1C1-Notationen angegeben werden.
// Get a list of ranges A1:D4, F1:H4. var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);
Parameter
Name | Typ | Beschreibung |
---|---|---|
a1Notations | String[] | Die Liste der zurückzugebenden Bereiche gemäß A1- oder R1C1-Notation. |
Return
RangeList
: die Bereichsliste an dem angegebenen Standort
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroup(rowIndex, groupDepth)
Gibt die Zeilengruppe mit dem angegebenen Index und der angegebenen Gruppentiefe zurück.
var 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. var rowGroup = sheet.getRowGroup(2, 1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
rowIndex | Integer | Der Zeilenindex der Ein-/Aus-Schaltfläche für die Gruppensteuerung oder ein Index innerhalb der Gruppe. |
groupDepth | Integer | Die Tiefe der Gruppe. |
Return
Group
: Die Zeilengruppe am Kontrollindex und in der Tiefe oder löst eine Ausnahme aus, wenn die Gruppe nicht vorhanden ist.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupControlPosition()
Gibt das GroupControlTogglePosition
für alle Zeilengruppen im Tabellenblatt zurück.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the row grouping control toggle is shown after the // group. var rowGroupControlPosition = sheet.getRowGroupControlPosition();
Return
GroupControlTogglePosition
: true
, wenn die Ein-/Aus-Schaltfläche für die Zeilengruppierung nach der Gruppe auf diesem Tabellenblatt angezeigt wird, andernfalls false
.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupDepth(rowIndex)
Gibt die Gruppentiefe der Zeile beim angegebenen Index zurück.
Die Gruppentiefe gibt an, wie viele Gruppen sich mit der Zeile überschneiden. Diese kann zwischen 0 und 8 liegen.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over rows 1 through 3 var groupDepth = sheet.getRowGroupDepth(1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
rowIndex | Integer | Der Index der Zeile. |
Return
Integer
: Die Gruppentiefe der Zeile beim angegebenen Index.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowHeight(rowPosition)
Ruft die Höhe einer gegebenen Zeile in Pixeln ab.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
Parameter
Name | Typ | Beschreibung |
---|---|---|
rowPosition | Integer | Die Position der zu untersuchenden Zeile. |
Return
Integer
: Zeilenhöhe in Pixeln
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSelection()
Gibt die aktuelle Selection
in der Tabelle zurück.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Return
Selection
– die aktuelle Auswahl
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetId()
Gibt die ID des durch dieses Objekt dargestellten Tabellenblatts zurück
Dies ist eine eindeutige ID für das Tabellenblatt. Die ID ist eine kontinuierlich ansteigende Ganzzahl, die beim Erstellen des Tabellenblatts zugewiesen wird und unabhängig von der Position des Tabellenblatts ist. Dies ist in Verbindung mit Methoden wie Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
nützlich, die einen gridId
-Parameter anstelle einer Sheet
-Instanz verwenden.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Return
Integer
: die eindeutige ID des Arbeitsblatts in der Tabelle
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetName()
Gibt den Namen des Tabellenblatts zurück
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Return
String
: der Name des Tabellenblatts
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(startRow, startColumn, numRows, numColumns)
Gibt das rechteckige Werteraster für diesen Bereich zurück, beginnend bei den angegebenen Koordinaten. Ein -1-Wert für die Zeilen- oder Spaltenposition entspricht dem Abrufen der letzten Zeile oder Spalte mit Daten im Tabellenblatt.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var 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. |
Return
Object[][]
: ein zweidimensionales Array von Werten
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSlicers()
Gibt ein Array von Datenschnitten im Tabellenblatt zurück.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all slicers in the spreadsheet. const slicers = sheet.getSlicers(); // Logs the slicer titles to the console. for (const slicer of slicers) { console.log(slicer.getTitle()); }
Return
Slicer[]
: Die Liste der Datenschnitte auf diesem Tabellenblatt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTabColorObject()
Ruft die Tabfarbe des Tabellenblatts ab oder null
, wenn der Tab des Tabellenblatts keine Farbe hat
// This example assumes there is a sheet named "Sheet1" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("Sheet1"); var color = first.getTabColorObject();
Return
Color
: die Tabfarbe des Tabellenblatts oder null
, wenn der Tab des Tabellenblatts keine Farbe hat
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getType()
Gibt den Typ des Tabellenblatts zurück.
Der Standardtyp des Tabellenblatts ist SheetType.GRID
. Ein Tabellenblatt, das ein einzelnes eingebettetes Objekt wie ein EmbeddedChart
enthält, ist ein SheetType.OBJECT
-Tabellenblatt.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getType());
Return
SheetType
: Der Typ des Tabellenblatts.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hasHiddenGridlines()
Gibt true
zurück, wenn die Gitternetzlinien des Tabellenblatts ausgeblendet sind. Andernfalls wird false
zurückgegeben.
Gitternetzlinien 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());
Return
Boolean
: true
, wenn die Gitternetzlinien ausgeblendet sind; andernfalls false
.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumn(column)
Blendet die Spalte(n) im angegebenen Bereich aus.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // This hides the first column let range = sheet.getRange("A1"); sheet.hideColumn(range); // This hides the first 3 columns let range = sheet.getRange("A:C"); sheet.hideColumn(range);
Parameter
Name | Typ | Beschreibung |
---|---|---|
column | Range | Der Spaltenbereich, der ausgeblendet werden soll. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex)
Blendet eine einzelne Spalte beim angegebenen Index aus. Verwenden Sie für diese Methode den 1-Index.
Verwenden Sie hideColumns(columnIndex, numColumns)
, um mehrere Spalten mithilfe eines Index auszublenden.
Um mehrere Spalten mithilfe eines Bereichs auszublenden, verwenden Sie hideColumn()
.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex, numColumns)
Blendet eine oder mehrere aufeinanderfolgende Spalten ab dem angegebenen Index aus. Verwenden Sie für diese Methode den 1-Index.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three columns sheet.hideColumns(1, 3);
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnIndex | Integer | Der Startindex der Spalten, die ausgeblendet werden sollen. |
numColumns | Integer | Die Anzahl der Spalten, die ausgeblendet werden sollen. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRow(row)
Blendet die Zeilen im angegebenen Bereich aus.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This hides the first row var range = sheet.getRange("A1"); sheet.hideRow(range);
Parameter
Name | Typ | Beschreibung |
---|---|---|
row | Range | Der Zeilenbereich, der ausgeblendet werden soll. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex)
Blendet die Zeile beim angegebenen Index aus.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex, numRows)
Blendet eine oder mehrere aufeinanderfolgende Zeilen ab dem angegebenen Index aus.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three rows sheet.hideRows(1, 3);
Parameter
Name | Typ | Beschreibung |
---|---|---|
rowIndex | Integer | Der Startindex der Zeilen, die ausgeblendet werden sollen. |
numRows | Integer | Die Anzahl der Zeilen, die ausgeblendet werden sollen. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideSheet()
Blendet dieses Tabellenblatt aus. Dies hat keine Auswirkungen, wenn das Tabellenblatt bereits ausgeblendet ist. Wird diese Methode auf dem einzigen sichtbaren Tabellenblatt aufgerufen, wird eine Ausnahme ausgelöst.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.hideSheet();
Return
Sheet
: Das aktuelle Tabellenblatt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertChart(chart)
Fügt diesem Tabellenblatt ein neues Diagramm hinzu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This creates a simple bar chart from the first three rows // of the first two columns of the spreadsheet var 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnAfter(afterPosition)
Fügt eine Spalte nach der angegebenen Spaltenposition ein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column after the first column position sheet.insertColumnAfter(1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
afterPosition | Integer | Spalte, nach der die neue Spalte hinzugefügt werden soll. |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnBefore(beforePosition)
Fügt eine Spalte vor der angegebenen Spaltenposition ein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex)
Fügt an der angegebenen Stelle eine leere Spalte in ein Tabellenblatt ein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex, numColumns)
Fügt eine oder mehrere aufeinanderfolgende leere Spalten in ein Tabellenblatt ein, beginnend an der angegebenen Position.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsAfter(afterPosition, howMany)
Fügt eine bestimmte Anzahl von Spalten nach der angegebenen Spaltenposition ein.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let 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 | Spalte, nach der die neue Spalte hinzugefügt werden soll. |
howMany | Integer | Die Anzahl der einzufügenden Spalten. |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsBefore(beforePosition, howMany)
Fügt eine bestimmte Anzahl von Spalten vor der angegebenen Spaltenposition ein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row)
Fügt ein BlobSource
als Bild in das Dokument bei einer bestimmten Zeile und Spalte ein. Die Bildgröße wird aus dem Blob-Inhalt abgerufen. Blobs dürfen maximal 2 MB groß sein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
blobSource | BlobSource | Das Blob mit dem Bildinhalt, dem MIME-Typ und (optional) dem Namen. |
column | Integer | Die Spaltenposition. |
row | Integer | Die Zeilenposition. |
Return
OverGridImage
: Das eingefügte Bild.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row, offsetX, offsetY)
Fügt im Dokument an einer bestimmten Zeile und Spalte ein BlobSource
als Bild mit Pixelversatz ein. Die Bildgröße wird aus dem Blob-Inhalt abgerufen. Blobs dürfen maximal 2 MB groß sein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
Parameter
Name | Typ | Beschreibung |
---|---|---|
blobSource | BlobSource | Das Blob mit dem Bildinhalt, dem MIME-Typ und (optional) dem Namen. |
column | Integer | Die Spaltenposition. |
row | Integer | Die Zeilenposition. |
offsetX | Integer | Der horizontale Versatz von der Ecke der Zelle in Pixeln. |
offsetY | Integer | Vertikaler Abstand von der Zellenecke in Pixel |
Return
OverGridImage
: Das eingefügte Bild.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row)
Fügt in einer bestimmten Zeile und Spalte ein Bild in das Dokument ein.
Die angegebene URL muss öffentlich zugänglich sein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Return
OverGridImage
: Das eingefügte Bild.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row, offsetX, offsetY)
Fügt im Dokument ein Bild mit einem Pixelversatz in einer bestimmten Zeile und Spalte ein.
Die angegebene URL muss öffentlich zugänglich sein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 Versatz von der Ecke der Zelle in Pixeln. |
offsetY | Integer | Vertikaler Abstand von der Zellenecke in Pixel |
Return
OverGridImage
: Das eingefügte Bild.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowAfter(afterPosition)
Fügt eine Zeile nach der angegebenen Zeilenposition ein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
afterPosition | Integer | Zeile, nach der die neue Zeile eingefügt werden soll |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowBefore(beforePosition)
Fügt eine Zeile vor der angegebenen Zeilenposition ein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
beforePosition | Integer | Zeile, vor der die neue Zeile eingefügt werden soll |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex)
Fügt an der angegebenen Position in ein Tabellenblatt eine leere Zeile ein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex, numRows)
Fügt eine oder mehrere aufeinanderfolgende leere Zeilen in ein Tabellenblatt ein, beginnend an der angegebenen Position.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsAfter(afterPosition, howMany)
Fügt eine bestimmte Anzahl von Zeilen nach der angegebenen Zeilenposition ein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 hinzugefügt werden sollen. |
howMany | Integer | Die Anzahl der einzufügenden Zeilen. |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsBefore(beforePosition, howMany)
Fügt eine bestimmte Anzahl von Zeilen vor der angegebenen Zeilenposition ein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSlicer(range, anchorRowPos, anchorColPos)
Fügt diesem Tabellenblatt einen neuen Datenschnitt 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, in dem der Datenschnitt erstellt wird. |
anchorRowPos | Integer | Die obere Seite des Datenschnitts ist in dieser Zeile verankert. |
anchorColPos | Integer | Die obere Seite des Datenschnitts ist in dieser Spalte verankert. |
Return
Slicer
: Der neu eingefügte Datenschnitt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)
Fügt diesem Tabellenblatt einen neuen Datenschnitt 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, in dem der Datenschnitt erstellt wird. |
anchorRowPos | Integer | Die obere Seite des Datenschnitts ist in dieser Zeile verankert. |
anchorColPos | Integer | Die obere Seite des Datenschnitts ist in dieser Spalte verankert. |
offsetX | Integer | Der horizontale Versatz von der Ecke der Zelle in Pixeln. |
offsetY | Integer | Vertikaler Abstand von der Zellenecke in Pixel |
Return
Slicer
: Der neu eingefügte Datenschnitt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isColumnHiddenByUser(columnPosition)
Gibt zurück, ob die angegebene Spalte vom Nutzer ausgeblendet wurde.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.isColumnHiddenByUser(1));
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnPosition | Integer | Die Position der zu untersuchenden Spalte. |
Return
Boolean
: true
, wenn die Spalte ausgeblendet ist, andernfalls false
.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRightToLeft()
Gibt true
zurück, wenn das Tabellenblatt von rechts nach links angeordnet ist. Gibt false
zurück, wenn das Tabellenblatt das Standardlayout für die rechtsläufige Schreibrichtung verwendet.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets 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());
Return
Boolean
: bei linksläufiger Schreibrichtung true
; andernfalls false
.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByFilter(rowPosition)
Gibt zurück, ob die angegebene Zeile durch einen Filter (nicht durch eine Filteransicht) ausgeblendet wurde.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
Parameter
Name | Typ | Beschreibung |
---|---|---|
rowPosition | Integer | Die Position der zu untersuchenden Zeile. |
Return
Boolean
: true
, wenn die Zeile ausgeblendet ist, andernfalls false
.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByUser(rowPosition)
Gibt zurück, ob die angegebene Zeile vom Nutzer ausgeblendet wurde.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByUser(1));
Parameter
Name | Typ | Beschreibung |
---|---|---|
rowPosition | Integer | Die Position der zu untersuchenden Zeile. |
Return
Boolean
: true
, wenn die Zeile ausgeblendet ist, andernfalls false
.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isSheetHidden()
Gibt true
zurück, wenn das Tabellenblatt gerade ausgeblendet ist.
var sheet = SpreadsheetApp.getActiveSheet(); if (sheet.isSheetHidden()) { // do something... }
Return
Boolean
: true
, wenn das Tabellenblatt ausgeblendet ist, andernfalls false
.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveColumns(columnSpec, destinationIndex)
Verschiebt die durch den angegebenen Bereich ausgewählten Spalten an die durch destinationIndex
angegebene Position. Der columnSpec
selbst muss nicht genau eine ganze Spalte oder Gruppe von Spalten darstellen, die verschoben werden soll. Es werden alle Spalten ausgewählt, die sich über den Bereich erstrecken.
// The code below moves rows A-B to destination index 5. // This results in those columns becoming columns C-D. var sheet = SpreadsheetApp.getActiveSheet(); // Selects column A and column B to be moved. var 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, in den die Spalten verschoben werden sollen. Beachten Sie, dass dieser Index auf den Koordinaten vor dem Verschieben der Spalten basiert. Vorhandene Daten werden nach rechts verschoben, um Platz für die verschobenen Spalten zu schaffen, während die Quellspalten aus dem Raster entfernt werden. Aus diesem Grund können die Daten in einem anderen Index landen als ursprünglich angegeben. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveRows(rowSpec, destinationIndex)
Verschiebt die durch den angegebenen Bereich ausgewählten Zeilen an die durch destinationIndex
angegebene Position. Der rowSpec
selbst muss nicht genau eine ganze Zeile oder Gruppe von Zeilen darstellen, die verschoben werden soll. Es werden alle Zeilen ausgewählt, die sich über den Bereich erstrecken.
// The code below moves rows 1-2 to destination index 5. // This results in those rows becoming rows 3-4. var sheet = SpreadsheetApp.getActiveSheet(); // Selects row 1 and row 2 to be moved. var 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 | Index, in den die Zeilen verschoben werden sollen. Beachten Sie, dass dieser Index auf den Koordinaten vor dem Verschieben der Zeilen basiert. Vorhandene Daten werden nach unten verschoben, um Platz für die verschobenen Zeilen zu schaffen, während die Quellzeilen aus dem Raster entfernt werden. Daher können die Daten bei einem anderen Index als ursprünglich angegeben landen. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
newChart()
Gibt einen Builder zurück, um ein neues Diagramm für dieses Tabellenblatt zu erstellen.
In diesem Beispiel wird gezeigt, wie Sie ein neues Diagramm erstellen:
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B8"); var chartBuilder = sheet.newChart(); chartBuilder.addRange(range) .setChartType(Charts.ChartType.LINE) .setPosition(2, 2, 0, 0) .setOption('title', 'My Line Chart!'); sheet.insertChart(chartBuilder.build());
Return
EmbeddedChartBuilder
: Ein Builder zum Erstellen eines neuen Diagramms.
protect()
Erstellt ein Objekt, das verhindern kann, dass das Tabellenblatt bearbeitet wird, außer von Nutzern mit entsprechender Berechtigung. Bis das Skript die Liste der Bearbeiter für das Tabellenblatt tatsächlich ändert (durch Aufrufen von Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
oder Festlegen eines neuen Werts für Protection.setDomainEdit(editable)
), entsprechen die Berechtigungen denen der Tabelle selbst. Das bedeutet, dass das Tabellenblatt 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. var sheet = SpreadsheetApp.getActiveSheet(); var 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. var me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
Return
Protection
: Ein Objekt, das die Schutzeinstellungen darstellt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeChart(chart)
Entfernt ein Diagramm aus dem übergeordneten Tabellenblatt.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This removes all the embedded charts from the spreadsheet var charts = sheet.getCharts(); for (var i in charts) { sheet.removeChart(charts[i]); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
chart | EmbeddedChart | Das zu entfernende Diagramm. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRange(range)
Legt den angegebenen Bereich als active range
im aktiven Tabellenblatt fest, wobei die linke obere Zelle im Bereich als current cell
festgelegt ist.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var range = sheet.getRange('A1:D4'); sheet.setActiveRange(range); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D4 var activeRange = selection.getActiveRange();
Parameter
Name | Typ | Beschreibung |
---|---|---|
range | Range | Bereich, der als aktiver Bereich festgelegt werden soll. |
Return
Range
: der neue aktive Bereich
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRangeList(rangeList)
Legt die angegebene Liste von Bereichen als active ranges
im aktiven Tabellenblatt fest. Der letzte Bereich in der Liste ist als active range
festgelegt.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); sheet.setActiveRangeList(rangeList); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Parameter
Name | Typ | Beschreibung |
---|---|---|
rangeList | RangeList | Die Liste der auszuwählenden Bereiche. |
Return
RangeList
: die neu ausgewählte Liste von Bereichen
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(range)
Legt den aktiven Auswahlbereich für dieses Tabellenblatt fest.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D4"); sheet.setActiveSelection(range);
Parameter
Name | Typ | Beschreibung |
---|---|---|
range | Range | Der Bereich, der als aktive Auswahl festgelegt werden soll. |
Return
Range
: der neue aktive Bereich
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(a1Notation)
Legt die aktive Auswahl wie in der A1- oder R1C1-Notation angegeben fest.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.setActiveSelection("A1:D4");
Parameter
Name | Typ | Beschreibung |
---|---|---|
a1Notation | String | Der Bereich, der als aktiv festgelegt werden soll, wie in der A1- oder R1C1-Notation angegeben. |
Return
Range
: der neue aktive Bereich
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnGroupControlPosition(position)
Legt die Position der Ein-/Aus-Schaltfläche für die Spaltengruppensteuerung auf dem Tabellenblatt fest.
var 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. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidth(columnPosition, width)
Legt die Breite der angegebenen Spalte in Pixeln fest.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 angegebenen Spalte, die festgelegt werden soll. |
width | Integer | Die Breite in Pixeln, auf die sie festgelegt werden soll. |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidths(startColumn, numColumns, width)
Legt die Breite der angegebenen Spalten in Pixeln fest.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 zu ändernde Anfangsposition der Spalte. |
numColumns | Integer | Die Anzahl der zu ändernden Spalten. |
width | Integer | Die Breite in Pixeln, auf die sie festgelegt werden soll. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setConditionalFormatRules(rules)
Alle derzeit vorhandenen Regeln für die bedingte Formatierung im Tabellenblatt werden durch die Eingaberegeln ersetzt. Regeln werden in der Eingabereihenfolge ausgewertet.
// Remove one of the existing conditional format rules. var sheet = SpreadsheetApp.getActiveSheet(); var 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setCurrentCell(cell)
Legt die angegebene Zelle als current cell
fest.
Wenn die angegebene Zelle in einem bereits ausgewählten Bereich vorhanden ist, wird dieser Bereich zum aktiven Bereich mit der Zelle als aktuelle Zelle.
Wenn die angegebene Zelle in keinem der ausgewählten Bereiche vorhanden ist, wird die vorhandene Auswahl entfernt und die Zelle wird zur aktuellen Zelle und zum aktiven Bereich.
Hinweis:Der angegebene Range
muss aus einer Zelle bestehen. Andernfalls wird eine Ausnahme ausgelöst.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); var selection = sheet.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
Parameter
Name | Typ | Beschreibung |
---|---|---|
cell | Range | Zelle, die als aktuelle Zelle festgelegt werden soll |
Return
Range
: die neu festgelegte aktuelle Zelle
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenColumns(columns)
Fixiert die angegebene Anzahl von Spalten. Wenn Null, sind keine Spalten fixiert.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenRows(rows)
Fixiert die angegebene Anzahl von Zeilen. Wenn null, werden keine Zeilen fixiert.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first row sheet.setFrozenRows(1);
Parameter
Name | Typ | Beschreibung |
---|---|---|
rows | Integer | Die Anzahl der zu fixierenden Zeilen. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 | Bei true werden die Gitternetzlinien in diesem Tabellenblatt ausgeblendet. Andernfalls werden die Gitternetzlinien angezeigt. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
Legt den Namen des Tabellenblatts fest.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setName("not first anymore");
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | Der neue Name für das Tabellenblatt. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRightToLeft(rightToLeft)
Legt fest, dass das Tabellenblatt von rechts nach links ausgerichtet 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'); // 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 wird das Tabellenblattlayout auf linksläufig festgelegt, mit Zelle A1 oben rechts. Wenn false , wird das Tabellenblatt-Layout auf die Standardeinstellung von links nach rechts festgelegt, mit Zelle A1 oben links. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowGroupControlPosition(position)
Legt die Position der Ein-/Aus-Schaltfläche für die Zeilengruppe auf dem Tabellenblatt fest.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setRowGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
Parameter
Name | Typ | Beschreibung |
---|---|---|
position | GroupControlTogglePosition | Die Position der Ein-/Aus-Schaltfläche für die Zeilengruppensteuerung. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeight(rowPosition, height)
Legt die Zeilenhöhe der angegebenen Zeile in Pixeln fest. Standardmäßig passen Zeilen an den Zelleninhalt an. Wenn Sie Zeilen auf eine bestimmte Höhe erzwingen möchten, verwenden Sie setRowHeightsForced(startRow, numRows, height)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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, auf die sie festgelegt werden soll. |
Return
Sheet
: Das Tabellenblatt, das für die Verkettung von Methoden nützlich ist.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeights(startRow, numRows, height)
Legt die Höhe der angegebenen Zeilen in Pixeln fest. Standardmäßig passen Zeilen an den Zelleninhalt an. Wenn Sie Zeilen auf eine bestimmte Höhe erzwingen möchten, verwenden Sie setRowHeightsForced(startRow, numRows, height)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 zu ändernde Startzeilenposition. |
numRows | Integer | Die Anzahl der zu ändernden Zeilen. |
height | Integer | Die Höhe in Pixeln, auf die sie festgelegt werden soll. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeightsForced(startRow, numRows, height)
Legt die Höhe der angegebenen Zeilen in Pixeln fest. Standardmäßig passen Zeilen an den Zelleninhalt an. Wenn Sie setRowHeightsForced
verwenden, wird die angegebene Höhe der Zeilen auch dann erzwungen, wenn der Zelleninhalt größer als die Zeilenhöhe ist.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 zu ändernde Startzeilenposition. |
numRows | Integer | Die Anzahl der zu ändernden Zeilen. |
height | Integer | Die Höhe in Pixeln, auf die sie festgelegt werden soll. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColor(color)
Legt die Farbe der Registerkarte für das Tabellenblatt fest.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setTabColor("ff0000"); // Set the color to red. first.setTabColor(null); // Unset the color.
Parameter
Name | Typ | Beschreibung |
---|---|---|
color | String | Ein Farbcode in CSS-Notation (z. B. '#ffffff' oder 'white' ) oder null , um die Tabfarbe zurückzusetzen. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColorObject(color)
Legt die Farbe der Registerkarte für das Tabellenblatt fest.
// This example assumes there is a sheet named "Sheet1" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("Sheet1"); var 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 Registerkartenfarbe des Tabellenblatts, die festgelegt werden soll. |
Return
Sheet
: Dieses Tabellenblatt für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex)
Blendet die Spalte beim angegebenen Index ein
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex, numColumns)
Blendet eine oder mehrere aufeinanderfolgende Spalten ab dem angegebenen Index ein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 eingeblendet werden sollen. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex)
Blendet die Zeile beim angegebenen Index ein
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex, numRows)
Blendet eine oder mehrere aufeinanderfolgende Zeilen ab dem angegebenen Index ein.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first three rows sheet.showRows(1, 3);
Parameter
Name | Typ | Beschreibung |
---|---|---|
rowIndex | Integer | Der Startindex der Zeilen, die eingeblendet werden sollen. |
numRows | Integer | Die Anzahl der Zeilen, die eingeblendet werden sollen. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showSheet()
Macht das Tabellenblatt sichtbar. Dies hat keine Auswirkungen, wenn das Tabellenblatt bereits sichtbar ist.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.showSheet();
Return
Sheet
: Das aktuelle Tabellenblatt.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition)
Sortiert ein Tabellenblatt aufsteigend nach Spalte.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition, ascending)
Sortiert ein Tabellenblatt nach Spalten. Verwendet einen Parameter, um aufsteigend oder absteigend anzugeben.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, descending sheet.sort(1, false);
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnPosition | Integer | Die Spalte, nach der sortiert werden soll. |
ascending | Boolean | true für aufsteigende, false für absteigende Sortierungen. |
Return
Sheet
– das Tabellenblatt, das für die Verkettung von Methoden nützlich ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideColumn(column)
Blendet die Spalte im angegebenen Bereich ein
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first column if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideColumn(range);
Parameter
Name | Typ | Beschreibung |
---|---|---|
column | Range | Einzublendender Bereich, falls ausgeblendet. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideRow(row)
Blendet die Zeile im angegebenen Bereich ein
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first row if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideRow(range);
Parameter
Name | Typ | Beschreibung |
---|---|---|
row | Range | Einzublendender Bereich, falls ausgeblendet. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
updateChart(chart)
Aktualisiert das Diagramm auf diesem Tabellenblatt.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This code is going to loop through all the charts and change them to // column charts var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; var newChart = chart .modify() .setChartType(Charts.ChartType.COLUMN) .build(); sheet.updateChart(newChart); }
Parameter
Name | Typ | Beschreibung |
---|---|---|
chart | EmbeddedChart | Das zu aktualisierende Diagramm. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets