Diese Seite wurde von der Cloud Translation API übersetzt.

Class Spreadsheet

Auf Google Tabellen-Dateien zugreifen und sie bearbeiten Gängige Vorgänge sind das Hinzufügen neuer Tabellenblätter und das Hinzufügen von Mitbearbeitern.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`addDeveloperMetadata(key)`	`Spreadsheet`	Fügt der Tabelle auf oberster Ebene Entwicklermetadaten mit dem angegebenen Schlüssel hinzu.
`addDeveloperMetadata(key, visibility)`	`Spreadsheet`	Fügt der Tabelle Entwicklermetadaten mit dem angegebenen Schlüssel und der Sichtbarkeit hinzu.
`addDeveloperMetadata(key, value)`	`Spreadsheet`	Fügt der Tabelle Entwicklermetadaten mit dem angegebenen Schlüssel und Wert hinzu.
`addDeveloperMetadata(key, value, visibility)`	`Spreadsheet`	Fügt der Tabelle Entwicklermetadaten mit dem angegebenen Schlüssel, Wert und der Sichtbarkeit hinzu.
`addEditor(emailAddress)`	`Spreadsheet`	Fügt den angegebenen Nutzer der Liste der Bearbeiter für `Spreadsheet` hinzu.
`addEditor(user)`	`Spreadsheet`	Fügt den angegebenen Nutzer der Liste der Bearbeiter für `Spreadsheet` hinzu.
`addEditors(emailAddresses)`	`Spreadsheet`	Fügt das angegebene Array von Nutzern der Liste der Bearbeiter für `Spreadsheet` hinzu.
`addMenu(name, subMenus)`	`void`	Erstellt ein neues Menü in der Tabellen-UI.
`addViewer(emailAddress)`	`Spreadsheet`	Fügt den angegebenen Nutzer der Liste der Betrachter für `Spreadsheet` hinzu.
`addViewer(user)`	`Spreadsheet`	Fügt den angegebenen Nutzer der Liste der Betrachter für `Spreadsheet` hinzu.
`addViewers(emailAddresses)`	`Spreadsheet`	Fügt das angegebene Array von Nutzern der Liste der Betrachter für `Spreadsheet` hinzu.
`appendRow(rowContents)`	`Sheet`	Hängt am Ende des aktuellen Datenbereichs im Tabellenblatt eine Zeile an.
`autoResizeColumn(columnPosition)`	`Sheet`	Legt die Breite der angegebenen Spalte so fest, dass sie in den Inhalt passt.
`copy(name)`	`Spreadsheet`	Kopiert die Tabelle und gibt die neue zurück.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Gibt ein `DeveloperMetadataFinder` zurück, um Entwicklermetadaten im Bereich dieser Tabelle zu finden.
`createTextFinder(findText)`	`TextFinder`	Erstellt eine Textsuche für die Tabelle, mit der Text in der Tabelle gesucht und ersetzt werden kann.
`deleteActiveSheet()`	`Sheet`	Löscht das derzeit aktive Tabellenblatt.
`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.
`deleteSheet(sheet)`	`void`	Löscht das angegebene Tabellenblatt.
`duplicateActiveSheet()`	`Sheet`	Dupliziert das aktive Tabellenblatt und macht es zum aktiven Tabellenblatt.
`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.
`getActiveSheet()`	`Sheet`	Ruft das aktive Tabellenblatt in einer Tabellenkalkulation ab.
`getAs(contentType)`	`Blob`	Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde.
`getBandings()`	`Banding[]`	Gibt alle Bandings in dieser Tabellenkalkulation zurück.
`getBlob()`	`Blob`	Gibt die Daten in diesem Objekt als Blob zurück.
`getColumnWidth(columnPosition)`	`Integer`	Ruft die Breite der angegebenen Spalte in Pixeln 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.
`getDataSourceRefreshSchedules()`	`DataSourceRefreshSchedule[]`	Ruft die Aktualisierungspläne für diese Tabelle ab
`getDataSourceSheets()`	`DataSourceSheet[]`	Gibt alle Datenquellentabellen in der Tabelle zurück.
`getDataSourceTables()`	`DataSourceTable[]`	Ruft alle Datenquellentabellen ab.
`getDataSources()`	`DataSource[]`	Gibt alle Datenquellen in der Tabelle zurück.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Ruft die mit der Tabelle auf oberster Ebene verknüpften Entwicklermetadaten ab.
`getEditors()`	`User[]`	Ruft die Liste der Bearbeiter für diesen `Spreadsheet` ab.
`getFormUrl()`	`String`	Gibt die URL für das Formular zurück, das die Antworten an diese Tabelle sendet, oder `null`, wenn dieser Tabelle kein Formular zugeordnet ist
`getFrozenColumns()`	`Integer`	Gibt die Anzahl der fixierten Spalten zurück
`getFrozenRows()`	`Integer`	Gibt die Anzahl der fixierten Zeilen zurück
`getId()`	`String`	Ruft eine eindeutige ID für diese Tabelle ab.
`getImages()`	`OverGridImage[]`	Gibt alle über das Raster gelegten Bilder im Tabellenblatt zurück.
`getIterativeCalculationConvergenceThreshold()`	`Number`	Gibt den Grenzwert zurück, der während der iterativen Berechnung verwendet wird.
`getLastColumn()`	`Integer`	Gibt die Position der letzten Spalte mit Inhalt zurück.
`getLastRow()`	`Integer`	Gibt die Position der letzten Zeile mit Inhalt zurück.
`getMaxIterativeCalculationCycles()`	`Integer`	Gibt die maximale Anzahl der Iterationen für die iterative Berechnung zurück.
`getName()`	`String`	Ruft den Namen des Dokuments ab.
`getNamedRanges()`	`NamedRange[]`	Ruft alle benannten Bereiche in dieser Tabelle ab.
`getNumSheets()`	`Integer`	Gibt die Anzahl der Tabellenblätter in dieser Tabelle zurück.
`getOwner()`	`User`	Gibt den Eigentümer des Dokuments oder `null` für ein Dokument in einer geteilten Ablage zurück
`getPredefinedSpreadsheetThemes()`	`SpreadsheetTheme[]`	Gibt die Liste der vordefinierten Themen zurück
`getProtections(type)`	`Protection[]`	Ruft ein Array mit Objekten ab, die alle geschützten Bereiche oder Tabellenblätter in der Tabelle darstellen.
`getRange(a1Notation)`	`Range`	Gibt den Bereich in der A1- oder R1C1-Notation zurück.
`getRangeByName(name)`	`Range`	Gibt einen benannten Bereich oder `null` zurück, wenn kein Bereich mit dem angegebenen Namen gefunden wird.
`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.
`getRecalculationInterval()`	`RecalculationInterval`	Gibt das Berechnungsintervall für diese Tabellenkalkulation 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.
`getSheetByName(name)`	`Sheet`	Gibt ein Tabellenblatt mit dem angegebenen Namen 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.
`getSheets()`	`Sheet[]`	Ruft alle Tabellenblätter in dieser Tabelle ab.
`getSpreadsheetLocale()`	`String`	Ruft das Gebietsschema für die Tabelle ab.
`getSpreadsheetTheme()`	`SpreadsheetTheme`	Gibt das aktuelle Design der Tabelle zurück oder `null`, wenn kein Design angewendet wird.
`getSpreadsheetTimeZone()`	`String`	Zeitzone der Tabelle abrufen.
`getUrl()`	`String`	Gibt die URL für die angegebene Tabelle zurück.
`getViewers()`	`User[]`	Liste der Betrachter und Kommentatoren für diesen `Spreadsheet` abrufen
`hideColumn(column)`	`void`	Blendet die Spalte(n) im angegebenen Bereich aus.
`hideRow(row)`	`void`	Blendet die Zeilen im angegebenen Bereich aus.
`insertColumnAfter(afterPosition)`	`Sheet`	Fügt eine Spalte nach der angegebenen Spaltenposition ein.
`insertColumnBefore(beforePosition)`	`Sheet`	Fügt eine Spalte vor der angegebenen Spaltenposition ein.
`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.
`insertDataSourceSheet(spec)`	`DataSourceSheet`	Fügt eine neue `DataSourceSheet` in die Tabelle ein und startet die Datenausführung.
`insertImage(blobSource, column, row)`	`OverGridImage`	Fügt ein `Spreadsheet` 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 `Spreadsheet` 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.
`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.
`insertSheet()`	`Sheet`	Fügt ein neues Tabellenblatt unter Verwendung eines Standardtabellennamens in die Tabellenkalkulation ein.
`insertSheet(sheetIndex)`	`Sheet`	Fügt beim angegebenen Index ein neues Tabellenblatt in die Tabellenkalkulation ein.
`insertSheet(sheetIndex, options)`	`Sheet`	Fügt am angegebenen Index ein neues Tabellenblatt in die Tabelle ein und verwendet optionale erweiterte Argumente.
`insertSheet(options)`	`Sheet`	Fügt ein neues Tabellenblatt in die Tabelle ein. Dabei werden ein Standardtabellenname und optionale erweiterte Argumente verwendet.
`insertSheet(sheetName)`	`Sheet`	Fügt in der Tabelle ein neues Tabellenblatt mit dem angegebenen Namen ein.
`insertSheet(sheetName, sheetIndex)`	`Sheet`	Fügt ein neues Tabellenblatt mit dem angegebenen Namen am angegebenen Index in die Tabellenkalkulation ein.
`insertSheet(sheetName, sheetIndex, options)`	`Sheet`	Fügt in die Tabelle ein neues Tabellenblatt mit dem angegebenen Namen am angegebenen Index ein und verwendet optionale erweiterte Argumente.
`insertSheet(sheetName, options)`	`Sheet`	Fügt in die Tabelle ein neues Tabellenblatt mit dem angegebenen Namen ein und verwendet optionale erweiterte Argumente.
`insertSheetWithDataSourceTable(spec)`	`Sheet`	Fügt ein neues Tabellenblatt in die Tabelle ein, erstellt eine `DataSourceTable`, die das gesamte Tabellenblatt mit der angegebenen Datenquellenspezifikation umfasst, und startet die Datenausführung.
`isColumnHiddenByUser(columnPosition)`	`Boolean`	Gibt zurück, ob die angegebene Spalte vom Nutzer ausgeblendet wurde.
`isIterativeCalculationEnabled()`	`Boolean`	Gibt zurück, ob die iterative Berechnung in dieser Tabellenkalkulation aktiviert 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.
`moveActiveSheet(pos)`	`void`	Verschiebt das aktive Tabellenblatt an die angegebene Position in der Liste der Tabellenblätter.
`moveChartToObjectSheet(chart)`	`Sheet`	Erstellt ein neues `SheetType.OBJECT`-Tabellenblatt und verschiebt das angegebene Diagramm dorthin.
`refreshAllDataSources()`	`void`	Es werden alle unterstützten Datenquellen und die zugehörigen verknüpften Datenquellenobjekte aktualisiert. Ungültige Datenquellenobjekte werden dabei übersprungen.
`removeEditor(emailAddress)`	`Spreadsheet`	Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für `Spreadsheet`.
`removeEditor(user)`	`Spreadsheet`	Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für `Spreadsheet`.
`removeMenu(name)`	`void`	Entfernt eine Speisekarte, die von `addMenu(name, subMenus)` hinzugefügt wurde.
`removeNamedRange(name)`	`void`	Löscht einen benannten Bereich mit dem angegebenen Namen.
`removeViewer(emailAddress)`	`Spreadsheet`	Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für `Spreadsheet`.
`removeViewer(user)`	`Spreadsheet`	Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für `Spreadsheet`.
`rename(newName)`	`void`	Benennt das Dokument um.
`renameActiveSheet(newName)`	`void`	Benennt das aktuell aktive Tabellenblatt in den angegebenen neuen Namen um.
`resetSpreadsheetTheme()`	`SpreadsheetTheme`	Das angewendete Design wird entfernt und das Standarddesign der Tabelle festgelegt.
`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.
`setActiveSheet(sheet)`	`Sheet`	Legt fest, dass das angegebene Tabellenblatt als aktives Tabellenblatt in der Tabelle festgelegt wird.
`setActiveSheet(sheet, restoreSelection)`	`Sheet`	Setzt das angegebene Tabellenblatt als aktives Blatt in der Tabelle und bietet eine Option zum Wiederherstellen der zuletzt ausgewählten Auswahl in diesem Tabellenblatt.
`setColumnWidth(columnPosition, width)`	`Sheet`	Legt die Breite der angegebenen Spalte in Pixeln fest.
`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.
`setIterativeCalculationConvergenceThreshold(minThreshold)`	`Spreadsheet`	Legt den Mindestgrenzwert für die iterative Berechnung fest.
`setIterativeCalculationEnabled(isEnabled)`	`Spreadsheet`	Legt fest, ob die iterative Berechnung in dieser Tabelle aktiviert ist.
`setMaxIterativeCalculationCycles(maxIterations)`	`Spreadsheet`	Legt die maximale Anzahl der Berechnungsiterationen fest, die während der iterativen Berechnung ausgeführt werden sollen.
`setNamedRange(name, range)`	`void`	Benennt einen Bereich.
`setRecalculationInterval(recalculationInterval)`	`Spreadsheet`	Legt fest, wie oft diese Tabelle neu berechnet werden soll.
`setRowHeight(rowPosition, height)`	`Sheet`	Legt die Zeilenhöhe der angegebenen Zeile in Pixeln fest.
`setSpreadsheetLocale(locale)`	`void`	Legt das Gebietsschema für die Tabelle fest.
`setSpreadsheetTheme(theme)`	`SpreadsheetTheme`	Legt ein Design für die Tabelle fest.
`setSpreadsheetTimeZone(timezone)`	`void`	Legt die Zeitzone für die Tabelle fest.
`show(userInterface)`	`void`	Zeigt eine benutzerdefinierte UI-Komponente in einem Dialogfeld an, das im Darstellungsbereich des Nutzers zentriert ist.
`sort(columnPosition)`	`Sheet`	Sortiert ein Tabellenblatt aufsteigend nach Spalte.
`sort(columnPosition, ascending)`	`Sheet`	Sortiert ein Tabellenblatt nach Spalten.
`toast(msg)`	`void`	Zeigt unten rechts in der Tabelle ein Pop-up-Fenster mit der jeweiligen Nachricht an.
`toast(msg, title)`	`void`	Zeigt unten rechts in der Tabelle ein Pop-up-Fenster mit der angegebenen Nachricht und dem Titel an.
`toast(msg, title, timeoutSeconds)`	`void`	Zeigt in der rechten unteren Ecke der Tabelle ein Pop-up-Fenster mit dem angegebenen Titel und der Nachricht an, das für einen bestimmten Zeitraum sichtbar bleibt.
`unhideColumn(column)`	`void`	Blendet die Spalte im angegebenen Bereich ein
`unhideRow(row)`	`void`	Blendet die Zeile im angegebenen Bereich ein
`updateMenu(name, subMenus)`	`void`	Aktualisiert eine Speisekarte, die von `addMenu(name, subMenus)` hinzugefügt wurde.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	Wartet, bis alle aktuellen Ausführungen in der Tabelle abgeschlossen sind, und endet nach der angegebenen Anzahl von Sekunden.

Verworfene Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getSheetProtection()`	`PageProtection`	Gibt eine `PageProtection`-Instanz zurück, die die Berechtigungen für das aktuelle Tabellenblatt beschreibt.
`isAnonymousView()`	`Boolean`	Gibt an, ob das Dokument die anonyme Anzeige zulässt.
`isAnonymousWrite()`	`Boolean`	Gibt an, ob das Dokument Änderungen von anonymen Nutzern zulässt.
`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`	`void`	Legt die Richtlinie des Dokuments für anonymes Lesen und Schreiben fest.
`setSheetProtection(permissions)`	`void`	Legt die Berechtigungen für das aktuelle Tabellenblatt fest.

Detaillierte Dokumentation

`addDeveloperMetadata(key)`

Fügt der Tabelle auf oberster Ebene 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');

// Adds the key 'NAME' in the developer metadata for the spreadsheet.
ss.addDeveloperMetadata('NAME')

// Gets the first developer metadata object and logs its key.
const developerMetaData = ss.getDeveloperMetadata()[0]
console.log(developerMetaData.getKey())

Parameter

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

Return

Spreadsheet: Diese Tabelle 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 der Tabelle Entwicklermetadaten mit dem angegebenen Schlüssel und der Sichtbarkeit hinzu.

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

// Adds the key 'NAME' in the developer metadata for the spreadsheet and sets the visibility
// to the developer project that created the metadata.
ss.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

// Gets the first developer metadata object and logs its key and visibility setting.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(`Key: ${developerMetaData.getKey()},
.             Visibility: ${developerMetaData.getVisibility()}`);

Parameter

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

Return

Spreadsheet: Diese Tabelle 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 der Tabelle 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');

// Adds the key 'NAME' and sets the value to 'GOOGLE' in the developer metadata for the
// spreadsheet.
ss.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the first developer metadata object and logs its key and value.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(`Key: ${developerMetaData.getKey()}, Value: ${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

Spreadsheet: Diese Tabelle 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 der Tabelle 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');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to any developer project with document access.
ss.addDeveloperMetadata('NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

// Gets the first developer metadata object and logs its key, value, and visibility setting.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(`Key: ${developerMetaData.getKey()},
             Value: ${developerMetaData.getValue()},
             Visibility: ${developerMetaData.getVisibility()}`);

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

Spreadsheet: Diese Tabelle 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

`addEditor(emailAddress)`

Fügt den angegebenen Nutzer der Liste der Bearbeiter für Spreadsheet hinzu. Wenn der Nutzer bereits in der Liste der Betrachter enthalten war, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.

Parameter

Name	Typ	Beschreibung
`emailAddress`	`String`	Die E-Mail-Adresse des Nutzers, der hinzugefügt werden soll.

Return

Spreadsheet: Dieses Spreadsheet 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

`addEditor(user)`

Parameter

Name	Typ	Beschreibung
`user`	`User`	Eine Darstellung des hinzuzufügenden Nutzers.

Return

Spreadsheet: Dieses Spreadsheet 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

`addEditors(emailAddresses)`

Fügt das angegebene Array von Nutzern der Liste der Bearbeiter für Spreadsheet hinzu. Wenn einer der Nutzer bereits in der Liste der Betrachter enthalten war, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.

Parameter

Name	Typ	Beschreibung
`emailAddresses`	`String[]`	Ein Array mit E-Mail-Adressen der hinzuzufügenden Nutzer.

Return

Spreadsheet: Dieses Spreadsheet 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

`addMenu(name, subMenus)`

Erstellt ein neues Menü in der Tabellen-UI.

Jeder Menüeintrag führt eine benutzerdefinierte Funktion aus. Normalerweise wird es über die Funktion onOpen() aufgerufen, damit das Menü beim Laden der Tabelle automatisch erstellt wird.

// The onOpen function is executed automatically every time a Spreadsheet is loaded
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var menuEntries = [];
  // When the user clicks on "addMenuExample" then "Menu Entry 1", the function function1 is
  // executed.
  menuEntries.push({name: "Menu Entry 1", functionName: "function1"});
  menuEntries.push(null); // line separator
  menuEntries.push({name: "Menu Entry 2", functionName: "function2"});

  ss.addMenu("addMenuExample", menuEntries);
}

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name des zu erstellenden Menüs.
`subMenus`	`Object[]`	Ein Array von JavaScript-Zuordnungen mit den Parametern `name` und `functionName`. Sie können Funktionen aus enthaltenen Bibliotheken wie `Library.libFunction1` verwenden.

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

`addViewer(emailAddress)`

Fügt den angegebenen Nutzer der Liste der Betrachter für Spreadsheet hinzu. Wenn sich der Nutzer bereits in der Liste der Bearbeiter befand, hat diese Methode keine Auswirkungen.

Parameter

Name	Typ	Beschreibung
`emailAddress`	`String`	Die E-Mail-Adresse des Nutzers, der hinzugefügt werden soll.

Return

Spreadsheet: Dieses Spreadsheet 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

`addViewer(user)`

Fügt den angegebenen Nutzer der Liste der Betrachter für Spreadsheet hinzu. Wenn sich der Nutzer bereits in der Liste der Bearbeiter befand, hat diese Methode keine Auswirkungen.

Parameter

Name	Typ	Beschreibung
`user`	`User`	Eine Darstellung des hinzuzufügenden Nutzers.

Return

Spreadsheet: Dieses Spreadsheet 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

`addViewers(emailAddresses)`

Fügt das angegebene Array von Nutzern der Liste der Betrachter für Spreadsheet hinzu. Wenn sich Nutzer bereits in der Liste der Bearbeiter befanden, hat diese Methode keine Auswirkungen auf sie.

Parameter

Name	Typ	Beschreibung
`emailAddresses`	`String[]`	Ein Array mit E-Mail-Adressen der hinzuzufügenden Nutzer.

Return

Spreadsheet: Dieses Spreadsheet 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

`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

`copy(name)`

Kopiert die Tabelle und gibt die neue zurück.

// This code makes a copy of the current spreadsheet and names it appropriately
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.copy("Copy of " + ss.getName());

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name der Kopie.

Return

Spreadsheet: Diese Tabelle 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. Standardmäßig werden dabei alle mit der Tabelle, Tabellen, Zeilen und Spalten verknüpften Metadaten berücksichtigt.

// 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');

// Adds developer metadata to the spreadsheet.
ss.addDeveloperMetadata('NAME', 'CHARLIE');
ss.addDeveloperMetadata('COMPANY', 'EXAMPLE ORGANIZATION');
ss.addDeveloperMetadata('TECHNOLOGY', 'JAVASCRIPT');

// Creates a developer metadata finder.
const developerMetadataFinder = ss.createDeveloperMetadataFinder();

// Finds the developer metadata objects with 'COMPANY' as the key.
const googleMetadataFromSpreadsheet = developerMetadataFinder.withKey('COMPANY').find();

// Gets the first result of developer metadata that has the key 'COMPANY' and logs its value.
console.log(googleMetadataFromSpreadsheet[0].getValue());

Return

DeveloperMetadataFinder: Ein Finder für Entwicklermetadaten zum Suchen nach Metadaten im Rahmen dieser Tabelle.

`createTextFinder(findText)`

Erstellt eine Textsuche für die Tabelle, mit der Text in der Tabelle gesucht und ersetzt werden kann. Die Suche beginnt mit dem ersten Tabellenblatt der Tabelle.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

// Creates  a text finder.
var textFinder = spreadsheet.createTextFinder('dog');

// Returns the first occurrence of 'dog' in the spreadsheet.
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 die Tabelle.

`deleteActiveSheet()`

Löscht das derzeit aktive Tabellenblatt.

// The code below deletes the currently active sheet and stores the new active sheet in a
// variable
var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();

Return

Sheet: Das neue aktive 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

`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

`deleteSheet(sheet)`

Löscht das angegebene Tabellenblatt.

// The code below deletes the specified sheet.
var ss = SpreadsheetApp.getActive();
var sheet = ss.getSheetByName('My Sheet');
ss.deleteSheet(sheet);

Parameter

Name	Typ	Beschreibung
`sheet`	`Sheet`	Das zu löschende 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

`duplicateActiveSheet()`

Dupliziert das aktive Tabellenblatt und macht es zum aktiven Tabellenblatt.

// The code below makes a duplicate of the active sheet
SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();

Return

Sheet: Das neue 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

`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

setActiveRange(range)

`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

setActiveRangeList(rangeList)

`getActiveSheet()`

Ruft das aktive Tabellenblatt in einer Tabellenkalkulation ab.

Das aktive Tabellenblatt in einer Tabellenkalkulation ist das Tabellenblatt, das auf der Tabellen-UI angezeigt wird.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();

Return

Sheet: Das aktive Tabellenblatt in der Tabelle.

`getAs(contentType)`

Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. "myfile.pdf". Dabei wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden sollte. Aus „ShoppingList.12.25.2014“ wird dann „ShoppingList.12.25.pdf“.

Informationen zu den Tageskontingenten für Conversions finden Sie unter Kontingente für Google-Dienste. Für neu erstellte Google Workspace-Domains gelten möglicherweise vorübergehend strengere Kontingente.

Parameter

Name	Typ	Beschreibung
`contentType`	`String`	Der MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist `'application/pdf'` die einzige gültige Option. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format sind auch `'image/bmp'`, `'image/gif'`, `'image/jpeg'` oder `'image/png'` gültig.

Return

Blob: Die Daten als Blob.

`getBandings()`

Gibt alle Bandings in dieser Tabellenkalkulation 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 an array of the bandings in the spreadsheet.
const bandings = ss.getBandings();

// Logs the range of the first banding in the spreadsheet to the console.
console.log(bandings[0].getRange().getA1Notation());

Return

Banding[]: Die Streifen in dieser 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

`getBlob()`

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

Return

Blob: Die Daten als Blob.

`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

`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

`getDataSourceRefreshSchedules()`

Ruft die Aktualisierungspläne für diese Tabelle ab

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

// Activates BigQuery operations for the connected spreadsheet.
SpreadsheetApp.enableBigQueryExecution();

// Gets the frequency type of the first referesh schedule in the array.
const frequencyType = ss.getDataSourceRefreshSchedules()[0]
                        .getFrequency()
                        .getFrequencyType()
                        .toString();

// Logs the frequency type to the console.
console.log(frequencyType);

Return

DataSourceRefreshSchedule[]: Die Zeitpläne für die Aktualisierung dieser 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

`getDataSourceSheets()`

Gibt alle Datenquellentabellen in der Tabelle zurück.

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// 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 the first data source sheet in the spreadsheet.
const dataSource = ss.getDataSourceSheets()[0];

// Gets the name of the data source sheet.
console.log(dataSource.asSheet().getName());

Return

DataSourceSheet[]: Ein Array aller Tabellenblätter 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

`getDataSources()`

Gibt alle Datenquellen in der Tabelle zurück.

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// 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 the data sources on the spreadsheet.
const dataSources = ss.getDataSources();

// Logs the name of the first column on the first data source.
console.log(dataSources[0].getColumns()[0].getName());

Return

DataSource[]: Ein Array aller Datenquellen.

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

Ruft die mit der Tabelle auf oberster Ebene verknüpften Entwicklermetadaten ab.

// 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');

// Adds 'Google' as a key to the spreadsheet metadata.
ss.addDeveloperMetadata('Google');

// Gets the spreadsheet's metadata.
const ssMetadata = ss.getDeveloperMetadata();

// Gets the first set of the spreadsheet's metadata and logs the key to the console.
console.log(ssMetadata[0].getKey());

Return

DeveloperMetadata[]: Die mit diesem Bereich 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

`getEditors()`

Ruft die Liste der Bearbeiter für diesen Spreadsheet ab.

Return

User[]: Ein Array von Nutzern mit Bearbeitungsberechtigung.

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 die Antworten an diese Tabelle sendet, oder null, wenn dieser Tabelle kein Formular zugeordnet ist Wenn Antworten von mehreren Formularen an diese Tabelle gesendet werden, ist die zurückgegebene Formular-URL unbestimmt. Alternativ können URL-Verknüpfungen pro Tabellenblatt über die Methode Sheet.getFormUrl() abgerufen werden.

// 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 the form URL from the spreadsheet.
const formUrl = ss.getFormUrl();

// Logs the form URL to the console.
console.log(formUrl);

Return

String: Die URL für das Formular, über das die Antworten in diese Tabelle eingefügt werden, oder null, wenn es kein zugehöriges Formular gibt.

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

`getId()`

Ruft eine eindeutige ID für diese Tabelle ab. Eine Tabellen-ID kann aus ihrer URL extrahiert werden. Die Tabellen-ID in der URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 lautet beispielsweise "abc1234567".

// The code below logs the ID for the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getId());

Return

String: Die eindeutige ID (oder der Schlüssel) der Tabelle.

`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

`getIterativeCalculationConvergenceThreshold()`

Gibt den Grenzwert zurück, der während der iterativen Berechnung verwendet wird. Wenn die Ergebnisse einer sukzessiven Berechnung um weniger als dieser Wert abweichen, wird die iterative Berechnung beendet.

// 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');

// Sets the iterative calculation convergence threshold for the spreadsheet.
ss.setIterativeCalculationConvergenceThreshold(2);

// Logs the threshold to the console.
console.log(ss.getIterativeCalculationConvergenceThreshold());

Return

Number: Der Konvergenzschwellenwert.

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

`getMaxIterativeCalculationCycles()`

Gibt die maximale Anzahl der Iterationen für die iterative Berechnung 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');

// Sets the max iterative calculation cycles for the spreadsheet.
ss.setMaxIterativeCalculationCycles(10);

// Logs the max iterative calculation cycles to the console.
console.log(ss.getMaxIterativeCalculationCycles());

Return

Integer: Die maximale Anzahl der Berechnungsdurchläufe.

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

Ruft den Namen des Dokuments ab.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getName());

Return

String: Der Name 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

`getNamedRanges()`

Ruft alle benannten Bereiche in dieser Tabelle ab.

// The code below logs the name of the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
  Logger.log(namedRanges[i].getName());
}

Return

NamedRange[]: Ein Array aller benannten Bereiche 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

`getNumSheets()`

Gibt die Anzahl der Tabellenblätter in dieser Tabelle zurück.

// The code below logs the number of sheets in the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());

Return

Integer: Die Anzahl der Tabellenblätter in der Tabelle.

`getOwner()`

Gibt den Eigentümer des Dokuments oder null für ein Dokument in einer geteilten Ablage zurück

var ss = SpreadsheetApp.getActiveSpreadsheet();
var owner = ss.getOwner();
Logger.log(owner.getEmail());

Return

User: Der Eigentümer des Dokuments oder null, wenn sich das Dokument in einer geteilten Ablage befindet.

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

`getPredefinedSpreadsheetThemes()`

Gibt die Liste der vordefinierten Themen zurück

// The code below returns the list of predefined themes.
var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet()
                               .getPredefinedSpreadsheetThemes();

Return

SpreadsheetTheme[]: Liste vordefinierter Themen.

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 oder Tabellenblätter in der Tabelle darstellen.

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

// Remove all sheet protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (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 oder Tabellenblätter in der Tabelle darstellen

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

`getRangeByName(name)`

Gibt einen benannten Bereich oder null zurück, wenn kein Bereich mit dem angegebenen Namen gefunden wird. Wenn mehrere Tabellenblätter der Tabelle denselben Bereichsnamen haben, geben Sie den Namen des Tabellenblatts ohne zusätzliche Anführungszeichen an, z. B. getRangeByName('TaxRates') oder getRangeByName('Sheet Name!TaxRates'), aber nicht getRangeByName('"Sheet Name"!TaxRates').

// Log the number of columns for the range named 'TaxRates' in the active spreadsheet.
var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates');
if (range != null) {
  Logger.log(range.getNumColumns());
}

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name des abzurufenden Bereichs.

Return

Range: Zellenbereich mit dem angegebenen Namen.

`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

`getRecalculationInterval()`

Gibt das Berechnungsintervall für diese Tabellenkalkulation 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');

// Logs the calculation interval for the spreadsheet to the console.
console.log(ss.getRecalculationInterval().toString());

Return

RecalculationInterval: Das Berechnungsintervall für diese 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

`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

`getSheetByName(name)`

Gibt ein Tabellenblatt mit dem angegebenen Namen zurück.

Wenn mehrere Tabellenblätter denselben Namen haben, wird dasjenige ganz links zurückgegeben. Gibt null zurück, wenn kein Tabellenblatt mit dem angegebenen Namen vorhanden ist.

// The code below logs the index of a sheet named "Expenses"
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Expenses");
if (sheet != null) {
  Logger.log(sheet.getIndex());
}

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name des abzurufenden Tabellenblatts.

Return

Sheet: Das Tabellenblatt mit dem angegebenen Namen.

`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

`getSheets()`

Ruft alle Tabellenblätter in dieser Tabelle ab.

// The code below logs the name of the second sheet
var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();
if (sheets.length > 1) {
  Logger.log(sheets[1].getName());
}

Return

Sheet[]: ein Array aller Tabellenblätter in der Tabelle.

`getSpreadsheetLocale()`

Ruft das Gebietsschema für die Tabelle ab.

// 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 the spreadsheet locale.
const ssLocale = ss.getSpreadsheetLocale();

// Logs the locale to the console.
console.log(ssLocale);

Return

String: Das Gebietsschema 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

`getSpreadsheetTheme()`

Gibt das aktuelle Design der Tabelle zurück oder null, wenn kein Design angewendet wird.

// The code below returns the current theme of the spreadsheet.
var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();

Return

SpreadsheetTheme: Das aktuell angewendete Design.

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

`getSpreadsheetTimeZone()`

Zeitzone der Tabelle abrufen.

// 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');

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

Return

String: Die Zeitzone im „long“-Format (z. B. „America/New_York“, wie auf Joda.org aufgeführt).

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

`getUrl()`

Gibt die URL für die angegebene Tabelle zurück.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getUrl());

Return

String: Die URL der angegebenen 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

`getViewers()`

Liste der Betrachter und Kommentatoren für diesen Spreadsheet abrufen

Return

User[]: ein Array von Nutzern mit Lese- oder Kommentarberechtigung.

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

`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

`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

`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

`insertDataSourceSheet(spec)`

Fügt eine neue DataSourceSheet in die Tabelle ein und startet die Datenausführung. Dadurch wird das neue Tabellenblatt auch zum aktiven Tabellenblatt.

Löst eine Ausnahme aus, wenn der Typ der Datenquelle nicht aktiviert ist. Verwenden Sie SpreadsheetApp#enable...Execution()-Methoden, um die Datenausführung für einen bestimmten Datenquellentyp zu ermöglichen.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// 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');

// Builds a data source specification.
// TODO (developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
 .asBigQuery()
 .setProjectId('project-id-1')
 .setTableProjectId('bigquery-public-data')
 .setDatasetId('ncaa_basketball')
 .setTableId('mbb_historical_teams_games')
 .build();

// Adds the data source and its data to the spreadsheet.
ss.insertDataSourceSheet(dataSourceSpec);

Parameter

Name	Typ	Beschreibung
`spec`	`DataSourceSpec`	Die Datenquellenspezifikation, die eingefügt werden soll.

Return

DataSourceSheet: Das neue Datenquellenblatt.

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

`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

`insertSheet()`

Fügt ein neues Tabellenblatt unter Verwendung eines Standardtabellennamens in die Tabellenkalkulation ein. Das neue Tabellenblatt wird zum aktiven Tabellenblatt.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet();

Return

Sheet: Das neue 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

`insertSheet(sheetIndex)`

Fügt beim angegebenen Index ein neues Tabellenblatt in die Tabellenkalkulation ein. Das neue Tabellenblatt wird zum aktiven Tabellenblatt.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet(1);

Parameter

Name	Typ	Beschreibung
`sheetIndex`	`Integer`	Der Index des neu erstellten Tabellenblatts. Wenn Sie ein Tabellenblatt als erstes in die Tabelle einfügen möchten, setzen Sie den Wert auf „0“.

Return

Sheet: Das neue 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

`insertSheet(sheetIndex, options)`

Fügt am angegebenen Index ein neues Tabellenblatt in die Tabelle ein und verwendet optionale erweiterte Argumente. Das neue Tabellenblatt wird zum aktiven Tabellenblatt.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet(1, {template: templateSheet});

Parameter

Name	Typ	Beschreibung
`sheetIndex`	`Integer`	Der Index des neu erstellten Tabellenblatts. Wenn Sie ein Tabellenblatt als erstes in die Tabelle einfügen möchten, setzen Sie den Wert auf „0“.
`options`	`Object`	Optionale erweiterte JavaScript-Argumente.

Erweiterte Parameter

Name	Typ	Beschreibung
`template`	`Sheet`	Alle Daten aus dem Vorlagentabellenobjekt werden in das neue Tabellenblatt kopiert. Die Tabellenblattvorlage muss eines der Tabellenblätter des Objekts „Tabellen“ sein.

Return

Sheet: Das neue 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

`insertSheet(options)`

Fügt ein neues Tabellenblatt in die Tabelle ein. Dabei werden ein Standardtabellenname und optionale erweiterte Argumente verwendet. Das neue Tabellenblatt wird zum aktiven Tabellenblatt.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet({template: templateSheet});

Parameter

Name	Typ	Beschreibung
`options`	`Object`	Optionale erweiterte JavaScript-Argumente (siehe unten).

Erweiterte Parameter

Name	Typ	Beschreibung
`template`	`Sheet`	Alle Daten aus dem Vorlagentabellenobjekt werden in das neue Tabellenblatt kopiert. Die Tabellenblattvorlage muss eines der Tabellenblätter dieses Tabellenobjekts sein.

Return

Sheet: Das neue 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

`insertSheet(sheetName)`

Fügt in der Tabelle ein neues Tabellenblatt mit dem angegebenen Namen ein. Das neue Tabellenblatt wird zum aktiven Tabellenblatt.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet');

Parameter

Name	Typ	Beschreibung
`sheetName`	`String`	Der Name des neuen Tabellenblatts.

Return

Sheet: Das neue 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

`insertSheet(sheetName, sheetIndex)`

Fügt ein neues Tabellenblatt mit dem angegebenen Namen am angegebenen Index in die Tabellenkalkulation ein. Das neue Tabellenblatt wird zum aktiven Tabellenblatt.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet', 1);

Parameter

Name	Typ	Beschreibung
`sheetName`	`String`	Der Name des neuen Tabellenblatts.
`sheetIndex`	`Integer`	Der Index des neu erstellten Tabellenblatts. Wenn Sie ein Tabellenblatt als erstes in die Tabelle einfügen möchten, setzen Sie den Wert auf „0“.

Return

Sheet: Das neue 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

`insertSheet(sheetName, sheetIndex, options)`

Fügt in die Tabelle ein neues Tabellenblatt mit dem angegebenen Namen am angegebenen Index ein und verwendet optionale erweiterte Argumente. Das neue Tabellenblatt wird zum aktiven Tabellenblatt.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', 1, {template: templateSheet});

Parameter

Name	Typ	Beschreibung
`sheetName`	`String`	Der Name des neuen Tabellenblatts.
`sheetIndex`	`Integer`	Index des neu eingefügten Tabellenblatts Wenn Sie ein Tabellenblatt als erstes in eine Tabelle einfügen möchten, setzen Sie den Wert auf 0.
`options`	`Object`	Optionale erweiterte JavaScript-Argumente.

Erweiterte Parameter

Name	Typ	Beschreibung
`template`	`Sheet`	Alle Daten aus dem Vorlagentabellenobjekt werden in das neue Tabellenblatt kopiert. Die Tabellenblattvorlage muss eines der Tabellenblätter des Objekts „Tabellen“ sein.

Return

Sheet: Das neue 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

`insertSheet(sheetName, options)`

Fügt in die Tabelle ein neues Tabellenblatt mit dem angegebenen Namen ein und verwendet optionale erweiterte Argumente. Das neue Tabellenblatt wird zum aktiven Tabellenblatt.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', {template: templateSheet});

Parameter

Name	Typ	Beschreibung
`sheetName`	`String`	Der Name des neuen Tabellenblatts.
`options`	`Object`	Optionale erweiterte JavaScript-Argumente.

Erweiterte Parameter

Name	Typ	Beschreibung
`template`	`Sheet`	Alle Daten aus dem Vorlagentabellenobjekt werden in das neue Tabellenblatt kopiert. Die Tabellenblattvorlage muss eines der Tabellenblätter des Objekts „Tabellen“ sein.

Return

Sheet: Das neue 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

`insertSheetWithDataSourceTable(spec)`

Fügt ein neues Tabellenblatt in die Tabelle ein, erstellt eine DataSourceTable, die das gesamte Tabellenblatt mit der angegebenen Datenquellenspezifikation umfasst, und startet die Datenausführung. Dadurch wird das neue Tabellenblatt zum aktiven Tabellenblatt.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// 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');

// Adds a sheet and sets cell A1 as the parameter cell.
const parameterCell = ss.insertSheet('parameterSheet').getRange('A1');

// Sets the value of the parameter cell to 'Duke'.
parameterCell.setValue('Duke');

const query = 'select * from `bigquery-public-data`.`ncaa_basketball`.' +
  '`mbb_historical_tournament_games` WHERE win_school_ncaa = @SCHOOL';

// Adds a data source with a query parameter.
// TODO(developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
 .asBigQuery()
 .setProjectId('project-id-1')
 .setRawQuery(query)
 .setParameterFromCell('SCHOOL', 'parameterSheet!A1')
 .build();

// Adds sheets for the data source and data source table to the spreadsheet.
ss.insertSheetWithDataSourceTable(dataSourceSpec);

Parameter

Name	Typ	Beschreibung
`spec`	`DataSourceSpec`	Die Datenquellenspezifikation, die eingefügt werden soll.

Return

Sheet: Das neue 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

`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

`isIterativeCalculationEnabled()`

Gibt zurück, ob die iterative Berechnung in dieser Tabellenkalkulation aktiviert ist.

// 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');

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

Return

Boolean: true, wenn die iterative Berechnung aktiviert 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

`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

`moveActiveSheet(pos)`

Verschiebt das aktive Tabellenblatt an die angegebene Position in der Liste der Tabellenblätter. Löst eine Ausnahme aus, wenn die Position negativ oder größer als die Anzahl der Tabellenblätter ist.

// This example assumes that there are 2 sheets in the current
// active spreadsheet: one named "first" in position 1 and another named "second"
// in position 2.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// Gets the "first" sheet and activates it.
var sheet = spreadsheet.getSheetByName("first").activate();

// Logs 'Current index of sheet: 1'
console.log("Current index of sheet: %s", sheet.getIndex());

spreadsheet.moveActiveSheet(2);

// Logs 'New index of sheet: 2'
console.log("New index of sheet: %s", sheet.getIndex());

Parameter

Name	Typ	Beschreibung
`pos`	`Integer`	Die 1-Index-Position, zu der das aktive Tabellenblatt in der Liste der Tabellenblätter verschoben 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

`moveChartToObjectSheet(chart)`

Erstellt ein neues SheetType.OBJECT-Tabellenblatt und verschiebt das angegebene Diagramm dorthin. Wenn sich das Diagramm bereits auf einem eigenen Tabellenblatt befindet, wird dieses Tabellenblatt zurückgegeben, ohne ein neues zu erstellen.

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.newChart().setPosition(1, 1, 0, 0).build();
sheet.insertChart(chart);
var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);

Parameter

Name	Typ	Beschreibung
`chart`	`EmbeddedChart`	Das zu verschiebende Diagramm

Return

Sheet: Das Tabellenblatt, auf dem sich das Diagramm befindet.

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

`refreshAllDataSources()`

Es werden alle unterstützten Datenquellen und die zugehörigen verknüpften Datenquellenobjekte aktualisiert. Ungültige Datenquellenobjekte werden dabei übersprungen.

Verwenden Sie SpreadsheetApp#enable...Execution()-Methoden, um die Datenausführung für einen bestimmten Datenquellentyp zu ermöglichen.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// 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 the first data source sheet on the spreadsheet.
const dataSheet = ss.getDataSourceSheets()[0];

// Refreshes all data sources on the spreadsheet.
ss.refreshAllDataSources();

// Logs the last refreshed time of the first data source sheet.
console.log(`Last refresh time: ${dataSheet.getStatus().getLastRefreshedTime()}`);

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

`removeEditor(emailAddress)`

Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Spreadsheet. Diese Methode verhindert nicht, dass Nutzer auf Spreadsheet zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinen Zugriff gehören. Das ist z. B. der Fall, wenn Spreadsheet für die gesamte Domain des Nutzers freigegeben ist oder wenn sich Spreadsheet in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer auch aus der Liste der Viewer entfernt.

Parameter

Name	Typ	Beschreibung
`emailAddress`	`String`	Die E-Mail-Adresse des Nutzers, der entfernt werden soll.

Return

Spreadsheet: Dieses Spreadsheet 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

`removeEditor(user)`

Bei Drive-Dateien wird der Nutzer auch aus der Liste der Viewer entfernt.

Parameter

Name	Typ	Beschreibung
`user`	`User`	Eine Darstellung des Nutzers, der entfernt werden soll.

Return

Spreadsheet: Dieses Spreadsheet 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

`removeMenu(name)`

Entfernt eine Speisekarte, die von addMenu(name, subMenus) hinzugefügt wurde. Das Argument name muss denselben Wert wie der entsprechende Aufruf von addMenu(name, subMenus) haben.

// The onOpen function is executed automatically every time a Spreadsheet is loaded
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.addMenu("badMenu", [{name: "remove bad menu", functionName: "removeBadMenu"},
                                       {name: "foo", functionName: "foo"}]);
}
function removeBadMenu() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.removeMenu("badMenu");  // name must match the name used when added the menu
}
function foo(){
// Do nothing
}

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name des Menüs, das entfernt 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

`removeNamedRange(name)`

Löscht einen benannten Bereich mit dem angegebenen Namen. Löst eine Ausnahme aus, wenn kein Bereich mit dem angegebenen Namen in der Tabelle gefunden wird.

// The code below creates a new named range "foo", and then remove it.
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange("foo", ss.getActiveRange());
ss.removeNamedRange("foo");

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Bereichsname.

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

`removeViewer(emailAddress)`

Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Spreadsheet. Diese Methode hat keine Auswirkungen, wenn der Nutzer Bearbeiter und kein Betrachter oder Kommentator ist. Außerdem wird durch diese Methode nicht verhindert, dass Nutzer auf Spreadsheet zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn die Spreadsheet für die gesamte Domain des Nutzers freigegeben ist oder wenn sich Spreadsheet in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer auch aus der Liste der Bearbeiter entfernt.

Parameter

Name	Typ	Beschreibung
`emailAddress`	`String`	Die E-Mail-Adresse des Nutzers, der entfernt werden soll.

Return

Spreadsheet: Spreadsheet für Verkettung.

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

`removeViewer(user)`

Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Spreadsheet. Diese Methode hat keine Auswirkungen, wenn der Nutzer Bearbeiter und kein Betrachter ist. Außerdem verhindert diese Methode nicht, dass Nutzer auf Spreadsheet zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn Spreadsheet für die gesamte Domain des Nutzers freigegeben ist oder wenn sich Spreadsheet in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer auch aus der Liste der Bearbeiter entfernt.

Parameter

Name	Typ	Beschreibung
`user`	`User`	Eine Darstellung des Nutzers, der entfernt werden soll.

Return

Spreadsheet: Spreadsheet 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

`rename(newName)`

Benennt das Dokument um.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.rename("This is the new name");

Parameter

Name	Typ	Beschreibung
`newName`	`String`	Der neue Name des Dokuments.

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

`renameActiveSheet(newName)`

Benennt das aktuell aktive Tabellenblatt in den angegebenen neuen Namen um.

// The code below renames the active sheet to "Hello world"
SpreadsheetApp.getActiveSpreadsheet().renameActiveSheet("Hello world");

Parameter

Name	Typ	Beschreibung
`newName`	`String`	Der neue Name für das aktuell aktive 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

`resetSpreadsheetTheme()`

Das angewendete Design wird entfernt und das Standarddesign der Tabelle festgelegt.

// The code below applies default theme on the spreadsheet.
SpreadsheetApp.getActiveSpreadsheet().resetSpreadsheetTheme();

Return

SpreadsheetTheme: Das Standarddesign.

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

`setActiveSheet(sheet)`

Legt fest, dass das angegebene Tabellenblatt als aktives Tabellenblatt in der Tabelle festgelegt wird. In der Google Tabellen-UI wird das ausgewählte Tabellenblatt angezeigt, sofern es nicht zu einer anderen Tabelle gehört.

// The code below makes the first sheet active in the active spreadsheet.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
spreadsheet.setActiveSheet(spreadsheet.getSheets()[0]);

Parameter

Name	Typ	Beschreibung
`sheet`	`Sheet`	Das Tabellenblatt, das als aktives Tabellenblatt festgelegt werden soll.

Return

Sheet: Das aktive 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

`setActiveSheet(sheet, restoreSelection)`

Setzt das angegebene Tabellenblatt als aktives Blatt in der Tabelle und bietet eine Option zum Wiederherstellen der zuletzt ausgewählten Auswahl in diesem Tabellenblatt. In der Benutzeroberfläche von Google Tabellen wird das ausgewählte Tabellenblatt angezeigt, es sei denn, es gehört zu einer anderen Tabelle.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var firstSheet = spreadsheet.getSheets()[0];
var secondSheet = spreadsheet.getSheets()[1];
// Set the first sheet as the active sheet and select the range D4:F4.
spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate();

// Switch to the second sheet to do some work.
spreadsheet.setActiveSheet(secondSheet);
// Switch back to first sheet, and restore its selection.
spreadsheet.setActiveSheet(firstSheet, true);

// The selection of first sheet is restored, and it logs D4:F4
var range = spreadsheet.getActiveSheet().getSelection().getActiveRange();
Logger.log(range.getA1Notation());

Parameter

Name	Typ	Beschreibung
`sheet`	`Sheet`	Das neue aktive Tabellenblatt.
`restoreSelection`	`Boolean`	Wenn `true` aktiviert ist, wird die letzte Auswahl des neuen aktiven Tabellenblatts wieder ausgewählt, wenn das neue Tabellenblatt aktiv wird. Wenn `false`, wird das neue Tabellenblatt aktiv, ohne die aktuelle Auswahl zu ändern.

Return

Sheet: Das neue aktive 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

`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

`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

`setIterativeCalculationConvergenceThreshold(minThreshold)`

Legt den Mindestgrenzwert für die iterative Berechnung fest. Wenn die Ergebnisse einer sukzessiven Berechnung um weniger als dieser Wert abweichen, wird die iterative Berechnung beendet. Dieser Wert darf nicht negativ sein und ist standardmäßig auf 0, 05 festgelegt.

// 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');

// Sets the iterative calculation convergence threshold for the spreadsheet.
ss.setIterativeCalculationConvergenceThreshold(2);

// Logs the threshold to the console.
console.log(ss.getIterativeCalculationConvergenceThreshold());

Parameter

Name	Typ	Beschreibung
`minThreshold`	`Number`	Der minimale Konvergenzgrenzwert (darf nicht negativ sein).

Return

Spreadsheet: Diese Tabelle 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

`setIterativeCalculationEnabled(isEnabled)`

Legt fest, ob die iterative Berechnung in dieser Tabelle aktiviert ist. Wenn die maximale Anzahl von Berechnungszyklen und der Konvergenzgrenzwert beim Aktivieren der Berechnung nicht zuvor festgelegt wurden, werden standardmäßig 50 bzw.0,05 verwendet. Wenn einer der beiden Werte zuvor festgelegt wurde, werden die vorherigen Werte beibehalten.

// 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');

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

Parameter

Name	Typ	Beschreibung
`isEnabled`	`Boolean`	`true`, wenn die iterative Berechnung aktiviert werden soll, andernfalls `false`.

Return

Spreadsheet: Diese Tabelle 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

`setMaxIterativeCalculationCycles(maxIterations)`

Legt die maximale Anzahl der Berechnungsiterationen fest, die während der iterativen Berechnung ausgeführt werden sollen. Dieser Wert muss zwischen 1 und 10.000 (einschließlich) liegen. Der Standardwert ist 50.

// 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');

// Sets the max iterative calculation cycles for the spreadsheet.
ss.setMaxIterativeCalculationCycles(10);

// Logs the max iterative calculation cycles to the console.
console.log(ss.getMaxIterativeCalculationCycles());

Parameter

Name	Typ	Beschreibung
`maxIterations`	`Integer`	Die maximale Anzahl der Berechnungsdurchläufe (zwischen 1 und 10.000).

Return

Spreadsheet: Diese Tabelle 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

`setNamedRange(name, range)`

Benennt einen Bereich.

// The code below creates a new named range "TaxRates" in the active spreadsheet
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange("TaxRates", SpreadsheetApp.getActiveRange());

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name für den Bereich.
`range`	`Range`	Die Bereichsspezifikation.

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

`setRecalculationInterval(recalculationInterval)`

Legt fest, wie oft diese Tabelle neu berechnet werden soll.

// 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');

// Sets the  calculation interval for the spreadsheet to 'ON_CHANGE'.
const interval = ss.setRecalculationInterval(SpreadsheetApp.RecalculationInterval.ON_CHANGE);

// Logs the calculation interval to the console.
console.log(interval);

Parameter

Name	Typ	Beschreibung
`recalculationInterval`	`RecalculationInterval`	Das neue Neuberechnungsintervall.

Return

Spreadsheet: Diese Tabelle 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 Sheet.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

`setSpreadsheetLocale(locale)`

Legt das Gebietsschema für die Tabelle fest.

// 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');

// Sets the spreadsheet locale.
ss.setSpreadsheetLocale('fr');

// Gets the spreadsheet locale.
const ssLocale = ss.getSpreadsheetLocale();

// Logs the locale to the console.
console.log(ssLocale);

Parameter

Name	Typ	Beschreibung
`locale`	`String`	Der zu verwendende Gebietsschemacode (z. B. „en“, „fr“ oder „en_US“).

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

`setSpreadsheetTheme(theme)`

Legt ein Design für die Tabelle fest.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// The code below sets the second predefined theme as the current theme of the spreadsheet.
var predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes();
spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);

Parameter

Name	Typ	Beschreibung
`theme`	`SpreadsheetTheme`	Das anzuwendende Design.

Return

SpreadsheetTheme: Das neue aktuelle Design.

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

`setSpreadsheetTimeZone(timezone)`

Legt die Zeitzone für die Tabelle fest.

// 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');

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

Parameter

Name	Typ	Beschreibung
`timezone`	`String`	Die Zeitzone im „long“-Format (z. B. „America/New_York“, wie auf Joda.org aufgeführt).

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

`show(userInterface)`

Zeigt eine benutzerdefinierte UI-Komponente in einem Dialogfeld an, das im Darstellungsbereich des Nutzers zentriert ist. Die Ausführung des serverseitigen Skripts wird nicht unterbrochen. Zur Kommunikation mit der Serverseite muss die Komponente der Benutzeroberfläche asynchrone Callbacks an das serverseitige Skript vornehmen.

Wenn durch das serverseitige Skript zuvor ein Dialogfeld angezeigt wurde, das noch nicht geschlossen wurde, wird das vorhandene Dialogfeld durch die Benutzeroberfläche des neu angeforderten Dialogfelds ersetzt.

Mit dem folgenden Code-Snippet wird eine einfache HtmlService-Anwendung in einem Dialogfeld mit dem angegebenen Titel, der Höhe und der Breite angezeigt:

var htmlApp = HtmlService
    .createHtmlOutput('<p>A change of speed, a change of style...</p>')
    .setTitle('My HtmlService Application')
    .setWidth(250)
    .setHeight(300);

SpreadsheetApp.getActiveSpreadsheet().show(htmlApp);

// The script resumes execution immediately after showing the dialog.

Parameter

Name	Typ	Beschreibung
`userInterface`	`Object`	Ein `HtmlOutput`.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

https://www.googleapis.com/auth/script.container.ui

`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

`toast(msg)`

Zeigt unten rechts in der Tabelle ein Pop-up-Fenster mit der jeweiligen Nachricht an.

// Show a popup with the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started');

Parameter

Name	Typ	Beschreibung
`msg`	`String`	Die Nachricht, die im Toast angezeigt 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

`toast(msg, title)`

Zeigt unten rechts in der Tabelle ein Pop-up-Fenster mit der angegebenen Nachricht und dem Titel an.

// Show a popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status');

Parameter

Name	Typ	Beschreibung
`msg`	`String`	Die Nachricht, die im Toast angezeigt werden soll.
`title`	`String`	Der optionale Titel des Toasts.

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

`toast(msg, title, timeoutSeconds)`

Zeigt in der rechten unteren Ecke der Tabelle ein Pop-up-Fenster mit dem angegebenen Titel und der Nachricht an, das für einen bestimmten Zeitraum sichtbar bleibt.

// Show a 3-second popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);

Parameter

Name	Typ	Beschreibung
`msg`	`String`	Die Nachricht, die im Toast angezeigt werden soll.
`title`	`String`	Der optionale Titel des Toasts.
`timeoutSeconds`	`Number`	Das Zeitlimit in Sekunden. Bei `null` wird der Toast standardmäßig auf 5 Sekunden eingestellt. Ist er negativ, bleibt der Toast bestehen, bis er geschlossen wird.

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

`updateMenu(name, subMenus)`

Aktualisiert eine Speisekarte, die von addMenu(name, subMenus) hinzugefügt wurde. Funktioniert genauso wie addMenu(name, subMenus).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var menuEntries = [];
menuEntries.push({name: "Lone Menu Entry", functionName: "function1"});
ss.updateMenu("addMenuExample", menuEntries);

Parameter

Name	Typ	Beschreibung
`name`	`String`	Der Name des Menüs, das aktualisiert werden soll.
`subMenus`	`Object[]`	Ein Array von JavaScript-Zuordnungen mit den Parametern `name` und `functionName`. Sie können Funktionen aus enthaltenen Bibliotheken wie `Library.libFunction1` verwenden.

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

`waitForAllDataExecutionsCompletion(timeoutInSeconds)`

Wartet, bis alle aktuellen Ausführungen in der Tabelle abgeschlossen sind, und endet nach der angegebenen Anzahl von Sekunden. Löst eine Ausnahme aus, wenn die Ausführungen bei einer Zeitüberschreitung nicht abgeschlossen sind, bricht die Datenausführungen jedoch nicht ab.

Parameter

Name	Typ	Beschreibung
`timeoutInSeconds`	`Integer`	Die Zeit in Sekunden, die auf Datenausführungen gewartet werden soll. Das Maximum beträgt 300 Sekunden.

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

Verworfene Methoden

`getSheetProtection()`

Veraltet. Verwenden Sie für Tabellen, die in der neueren Version von Google Tabellen erstellt wurden, Sheet.getProtections(type). Dadurch wird die leistungsfähigere Protection-Klasse zurückgegeben. Diese Methode wurde zwar eingestellt, bleibt aber aus Kompatibilitätsgründen mit der älteren Version von Google Tabellen verfügbar.

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

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

var permissions = sheet.getSheetProtection();

permissions.setProtected(true);
permissions.addUser("user@example.com");

// Logs the users that have access to edit this sheet. Note that this
// is different from access to the entire spreadsheet - getUsers()
// only returns users if permissions.isProtected() is set to true.
var users = permissions.getUsers();
Logger.log(users);

Return

PageProtection: ein Objekt, das Zugriffsberechtigungen für Tabellenblätter beschreibt

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

`isAnonymousView()`

Veraltet. Diese Funktion wurde im Januar 2014 eingestellt und ist in der neuen Version von Google Tabellen nicht mehr verfügbar.

Gibt an, ob das Dokument die anonyme Anzeige zulässt. Da dies in der neuen Version von Google Tabellen nicht mehr unterstützt wird, verwenden Sie stattdessen File.getSharingAccess() und File.getSharingPermission().

// Determine if the document allows anonymous viewing via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());
var access = file.getSharingAccess();
var permission = file.getSharingPermission();
var isAnonymousAccess =
    access == DriveApp.Access.ANYONE || access == DriveApp.Access.ANYONE_WITH_LINK;
var isAnonymousEdit = isAnonymousAccess && permission != DriveApp.Permission.NONE;

Return

Boolean: true, wenn das Dokument anonym angesehen werden kann, 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

Weitere Informationen

Drive-Dienst

`isAnonymousWrite()`

Veraltet. Diese Funktion wurde im Januar 2014 eingestellt und ist in der neuen Version von Google Tabellen nicht mehr verfügbar.

Gibt an, ob das Dokument Änderungen von anonymen Nutzern zulässt. Da dies in der neuen Version von Google Tabellen nicht mehr unterstützt wird, verwenden Sie stattdessen File.getSharingAccess() und File.getSharingPermission().

// Determine if the document allow anonymous edits via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());
var access = file.getSharingAccess();
var permission = file.getSharingPermission();
var isAnonymousAccess =
    access == DriveApp.Access.ANYONE || access == DriveApp.Access.ANYONE_WITH_LINK;
var isAnonymousEdit = isAnonymousAccess && permission == DriveApp.Permission.EDIT;

Return

Boolean: true, wenn das Dokument anonymes Bearbeiten zulässt, 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

Weitere Informationen

Drive-Dienst

`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`

Veraltet. Diese Funktion wurde im Januar 2014 eingestellt und ist in der neuen Version von Google Tabellen nicht mehr verfügbar.

Legt die Richtlinie des Dokuments für anonymes Lesen und Schreiben fest. Da dies in der neuen Version von Google Tabellen nicht mehr unterstützt wird, können Sie alternativ File.setSharing(accessType, permissionType) verwenden.

// Set the document's policy on anonymous reading and writing via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());

// Set anonymous read.
file.setSharing(DriveApi.Access.ANYONE, DriveApi.Permission.VIEW);

// Set anonymous write.
file.setSharing(DriveApi.Access.ANYONE, DriveApi.Permission.EDIT);

// Disable anonymous access.
file.setSharing(DriveApi.Access.PRIVATE, file.getSharingPermission());

Parameter

Name	Typ	Beschreibung
`anonymousReadAllowed`	`Boolean`	`true`, um anonyme Lesevorgänge zuzulassen, andernfalls `false`.
`anonymousWriteAllowed`	`Boolean`	`true`, um anonyme Lesevorgänge zuzulassen, 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

Weitere Informationen

isAnonymousView()
isAnonymousWrite()
Drive-Dienst

`setSheetProtection(permissions)`

Veraltet. Verwenden Sie für Tabellen, die in der neueren Version von Google Tabellen erstellt wurden, Sheet.protect(). Dadurch wird die leistungsfähigere Protection-Klasse zurückgegeben. Diese Methode wurde zwar eingestellt, bleibt aber aus Kompatibilitätsgründen mit der älteren Version von Google Tabellen verfügbar.

Legt die Berechtigungen für das aktuelle Tabellenblatt fest.

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

var permissions = sheet.getSheetProtection();

// This copies the permissions on the first sheet to the second sheet
var sheetToClonePermissionsTo = ss.getSheets()[1];
sheetToClonePermissionsTo.setSheetProtection(permissions);

Parameter

Name	Typ	Beschreibung
`permissions`	`PageProtection`	Das Objekt für Zugriffsberechtigungen, das auf diesem Tabellenblatt festgelegt 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