Modul Google Apps Script

Funktionen, die an bestimmte Google-Apps-Script-Dienste gebunden sind: Tabellen, Präsentationen, Admin SDK, Drive, Dokumente, Formulare, Netzwerkanfragen und die eingebauten Oberflächenklassen.

Die Markierung New kennzeichnet eine im jüngsten Release hinzugekommene Funktion, Deprecated eine, die in einem künftigen Release entfernt werden soll.

Basismethoden

Allgemeine Helfer, die die übrigen Google-Apps-Script-Module unten verwenden.

Funktion	Rückgabetyp	Kurzbeschreibung
`getByteSize`	`Number`	Gibt die Länge einer Zeichenkette in Codeeinheiten zurück.
`getTriggerById` New	`Trigger \\| null`	Findet einen Trigger des Projekts anhand seiner Id.

Methoden des Admin SDK Directory

Helfer für den Admin-SDK-Directory-Dienst.

Funktion	Rückgabetyp	Kurzbeschreibung
`isAdmin`	`Boolean`	Meldet, ob der aktuelle Nutzer ein Workspace-Administrator ist.
`nonAdmin` New	`Boolean`	Meldet, ob der aktuelle Nutzer kein Workspace-Administrator ist.
`requireAdmin` New	`void`	Bricht den Aufruf ab, sofern der aktuelle Nutzer kein Workspace-Administrator ist.

Methoden für Google Drive

Funktion	Rückgabetyp	Kurzbeschreibung
`createFolder` New	`Folder`	Legt einen Ordnerpfad in Drive an und nutzt bereits vorhandene Ordner weiter.

Methoden für Google Docs

Helfer für Google Docs. Noch nicht umgesetzt. Beiträge sind willkommen — siehe Contributing.

Methoden für Google Forms

Helfer für Google Forms. Noch nicht umgesetzt. Beiträge sind willkommen — siehe Contributing.

Methoden für Google Tabellen

Helfer zum Lesen, Schreiben und Prüfen von Tabellendaten: Zeilen und Spalten, Zerlegen der A1-Notation, GridRange-Vergleiche und Typprüfungen für Sheet-, Spreadsheet - und Range-Objekte.

Funktion	Rückgabetyp	Kurzbeschreibung
`appendColumn`	`Sheet`	Fügt eine Spalte hinter der letzten Spalte mit Daten an.
`appendColumns`	`Sheet`	Fügt Spalten hinter der letzten Spalte mit Daten an.
`appendRow`	`Sheet`	Fügt eine Zeile unter der letzten Zeile mit Daten an.
`appendRows`	`Sheet`	Fügt Zeilen unter der letzten Zeile mit Daten an.
`clearColumnsByConditional` New	`Number`	Leert die vom Prädikat gewählten Spalten, ohne die Spalten zu entfernen.
`clearRowsByConditional` New	`Number`	Leert die vom Prädikat gewählten Zeilen, ohne die Zeilen zu entfernen.
`convertRichTextToHtml`	`String`	Gibt einen Rich-Text-Zellwert als HTML aus.
`deleteColumnsByConditional` New	`Number`	Löscht die vom Prädikat gewählten Spalten.
`deleteRowsByConditional` New	`Number`	Löscht die vom Prädikat gewählten Zeilen.
`doGridRangesIntersect`	`Boolean`	Meldet, ob zwei Rasterbereiche sich in einer Zelle überschneiden.
`extractRangeFromA1Notation` New	`String \\| null`	Holt den Bereichsteil aus einer A1-Notation.
`extractSheetNameFromA1Notation`	`String \\| null`	Holt den Blattnamen aus einer A1-Notation.
`getColumnIndexByLetter`	`Number \\| null`	Wandelt einen Spaltenbuchstaben in seinen nullbasierten Index um.
`getColumnLetterByIndex`	`String`	Wandelt einen nullbasierten Spaltenindex in seinen Buchstaben um.
`getColumnLetterByPosition`	`String`	Wandelt eine einsbasierte Spaltenposition in ihren Buchstaben um.
`getColumnPositionByLetter`	`Number \\| null`	Wandelt einen Spaltenbuchstaben in seine einsbasierte Position um.
`getNamedRangeByName` New	`NamedRange \\| null`	Findet einen benannten Bereich anhand seines Namens.
`getSchema` New	`SheetSchema \\| null`	Gibt das Schema eines Blattes zurück, gespeichert oder aus dem Inhalt abgeleitet.
`getSheetById`	`Sheet` \\| null	Findet ein Blatt anhand seiner Id.
`getSheetByIndex`	`Sheet` \\| null	Findet ein Blatt anhand seiner Position in der Tabelle.
`getValues` New	`Array`	Liest die Zeilen eines Blattes, gefiltert, abgebildet und seitenweise, in einem Aufruf.
`highlightHtml`	`String`	Färbt das HTML in einem Bereich wie Quellcode ein.
`insertSchema` New	`Sheet`	Hinterlegt ein Schema auf einem Blatt und wendet an, was es beschreibt.
`isCellGridRange`	`Boolean`	Prüft, ob ein Wert ein Einzelzellbereich ist.
`isGridRangeContainedIn`	`Boolean`	Prüft, ob ein Rasterbereich vollständig in einem anderen liegt.
`isGridRangeSameDimensions`	`Boolean`	Prüft, ob zwei Rasterbereiche gleich hoch und gleich breit sind.
`isRange`	`Boolean`	Prüft, ob ein Wert ein Bereich ist.
`isRichTextValue`	`Boolean`	Prüft, ob ein Wert ein Rich-Text-Wert ist.
`isSheet`	`Boolean`	Prüft, ob ein Wert ein Blatt ist.
`isSpreadsheet`	`Boolean`	Prüft, ob ein Wert eine Tabelle ist.
`isTextStyle`	`Boolean`	Prüft, ob ein Wert ein Textstil ist.
`isValidSheetId`	`Boolean`	Prüft, ob ein Wert eine Blatt-Id ist.
`isValidSheetName`	`Boolean`	Prüft, ob ein Wert ein Blattname ist.
`isValidSpreadsheetId`	`Boolean`	Prüft, ob ein Wert eine Tabellen-Id ist.
`nonCellGridRange` New	`Boolean`	Prüft, ob ein Wert nicht ein Einzelzellbereich ist.
`nonGridRangeContainedIn` New	`Boolean`	Prüft, ob ein Rasterbereich nicht vollständig in einem anderen liegt.
`nonGridRangeSameDimensions` New	`Boolean`	Prüft, ob zwei Rasterbereiche sich in Höhe oder Breite unterscheiden.
`nonRange`	`Boolean`	Prüft, ob ein Wert nicht ein Bereich ist.
`nonRichTextValue` New	`Boolean`	Prüft, ob ein Wert nicht ein Rich-Text-Wert ist.
`nonSheet`	`Boolean`	Prüft, ob ein Wert nicht ein Blatt ist.
`nonSpreadsheet` New	`Boolean`	Prüft, ob ein Wert nicht eine Tabelle ist.
`nonTextStyle` New	`Boolean`	Prüft, ob ein Wert nicht ein Textstil ist.
`nonValidSheetId` New	`Boolean`	Prüft, ob ein Wert nicht eine Blatt-Id ist.
`nonValidSheetName` New	`Boolean`	Prüft, ob ein Wert nicht ein Blattname ist.
`nonValidSpreadsheetId` New	`Boolean`	Prüft, ob ein Wert nicht eine Tabellen-Id ist.
`parseA1Notation` New	`GridRange`	Liest A1-Notation in einen Rasterbereich.
`parseA1Notations` New	`GridRange[]`	Liest eine durch Kommas getrennte Liste von A1-Notationen.
`prependColumn` New	`Sheet`	Fügt eine Spalte vor den Daten ein — im Blatt oder an einem Bereich.
`prependColumns` New	`Sheet`	Fügt Spalten vor den Daten ein — im Blatt oder an einem Bereich.
`prependRow`	`Sheet`	Fügt eine Zeile vor den Daten ein — im Blatt oder an einem Bereich.
`prependRows`	`Sheet`	Fügt Zeilen vor den Daten ein — im Blatt oder an einem Bereich.
`removeSchema` New	`Boolean`	Entfernt das auf einem Blatt hinterlegte Schema.
`requireCellGridRange` New	`GridRange`	Gibt den Wert als einen Einzelzellbereich zurück oder wirft.
`requireGridRangeContainedIn` New	`GridRange`	Gibt den Bereich zurück, sobald er nachweislich in einem anderen liegt, sonst wirft er.
`requireGridRangeSameDimensions` New	`void`	Gibt den Bereich zurück, sobald beide nachweislich gleich groß sind, sonst wirft er.
`requireRange`	`Range`	Gibt den Wert als einen Bereich zurück oder wirft.
`requireRichTextValue` New	`RichTextValue`	Gibt den Wert als einen Rich-Text-Wert zurück oder wirft.
`requireSheet`	`Sheet`	Gibt den Wert als ein Blatt zurück oder wirft.
`requireSpreadsheet` New	`Spreadsheet`	Gibt den Wert als eine Tabelle zurück oder wirft.
`requireTextStyle` New	`TextStyle`	Gibt den Wert als einen Textstil zurück oder wirft.
`requireValidSheetId` New	`Number`	Gibt den Wert als eine Blatt-Id zurück oder wirft.
`requireValidSheetName` New	`String`	Gibt den Wert als einen Blattnamen zurück oder wirft.
`requireValidSpreadsheetId` New	`String`	Gibt den Wert als eine Tabellen-Id zurück oder wirft.
`sortSheets`	`void`	Ordnet die Reiter einer Tabelle neu.
`toA1Notation`	`String`	Schreibt einen Rasterbereich in A1-Notation.
`updateFormulas` New	`Number`	Schreibt die Formeln eines Blattes um.
`updateSheetNameInA1Notation` New	`String`	Ersetzt den Blattnamen in einer A1-Notation und behält den Bereich.

Methoden für Google Präsentationen

Helfer für Google Slides: Folien finden und einordnen, Markdown in RichTextRun umwandeln, Suchen und Ersetzen sowie Typprüfungen für Presentation - und Slide-Objekte.

Funktion	Rückgabetyp	Kurzbeschreibung
`convertMarkdownToRichText` New	`RichTextRun[]`	Verwandelt eine kleine Teilmenge von Markdown in formatierte Textabschnitte.
`convertRichTextToMarkdown` New	`String`	Führt gestaltete Textabschnitte wieder in Markdown zurück.
`findReplaceAllTextInSlide` New	`Number`	Ersetzt jedes Vorkommen eines Textes auf einer Folie.
`getSlideByIndex` New	`Slide` \\|`null`	Findet die Folie an einer Position, in einer Präsentation oder in der aktiven.
`getSlideIndex` New	`Number \\| null`	Findet die Position einer Folie, in einer Präsentation oder in der aktiven.
`isPresentation` New	`Boolean`	Prüft, ob ein Wert eine Präsentation ist.
`isSlide` New	`Boolean`	Prüft, ob ein Wert eine Folie ist.
`isValidPresentationId` New	`Boolean`	Prüft, ob ein Wert eine Präsentations-Id ist.
`isValidSlideId` New	`Boolean`	Prüft, ob ein Wert eine Folien-Id ist.
`nonPresentation` New	`Boolean`	Prüft, ob ein Wert nicht eine Präsentation ist.
`nonSlide` New	`Boolean`	Prüft, ob ein Wert nicht eine Folie ist.
`nonValidPresentationId` New	`Boolean`	Prüft, ob ein Wert nicht eine Präsentations-Id ist.
`nonValidSlideId` New	`Boolean`	Prüft, ob ein Wert nicht eine Folien-Id ist.
`requirePresentation` New	`Presentation`	Gibt den Wert als eine Präsentation zurück oder wirft.
`requireSlide` New	`Slide`	Gibt den Wert als eine Folie zurück oder wirft.
`requireValidPresentationId` New	`String`	Gibt den Wert als eine Präsentations-Id zurück oder wirft.
`requireValidSlideId` New	`String`	Gibt den Wert als eine Folien-Id zurück oder wirft.

Netzwerkmethoden

Helfer für Netzwerkaufgaben — etwa das Prüfen von Anfrage-Token.

Funktion	Rückgabetyp	Kurzbeschreibung
`requireValidToken` New	`String`	Gibt ein Token zurück, sobald es einem erlaubten Schlüssel entspricht, sonst wirft es.

Methoden für die Oberfläche

Helfer für das, was Nutzer sehen — Typprüfungen für Ui, HtmlOutput und TextOutput — sowie Prüfungen für Abhängigkeiten: Repositories und Dienste, die Web-Apps verwenden.

Funktion	Rückgabetyp	Kurzbeschreibung
`checkMultipleAccount`	`Boolean`	Meldet, ob das Skript unter einem anderen Konto läuft als dem, das es gestartet hat.
`isHtmlOutput`	`Boolean`	Prüft, ob ein Wert ein HtmlOutput ist.
`isTextOutput`	`Boolean`	Prüft, ob ein Wert ein TextOutput ist.
`isUi`	`Boolean`	Prüft, ob ein Wert ein Ui-Objekt ist.
`nonHtmlOutput` New	`Boolean`	Prüft, ob ein Wert nicht ein HtmlOutput ist.
`nonTextOutput` New	`Boolean`	Prüft, ob ein Wert nicht ein TextOutput ist.
`nonUi` New	`Boolean`	Prüft, ob ein Wert nicht ein Ui-Objekt ist.
`requireHtmlOutput` New	`HtmlOutput`	Gibt den Wert als ein HtmlOutput zurück oder wirft.
`requireRepository` New	`T`	Gibt ein Repository zurück, sobald es nachweislich existiert, sonst wirft es.
`requireService` New	`T`	Gibt einen Dienst zurück, sobald er nachweislich existiert, sonst wirft er.
`requireTextOutput` New	`TextOutput`	Gibt den Wert als ein TextOutput zurück oder wirft.
`requireUi` New	`Ui`	Gibt den Wert als ein Ui-Objekt zurück oder wirft.

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.