Diese Seite wurde von der Cloud Translation API übersetzt.

Script Service

Dieser Dienst bietet Zugriff auf Skript-Trigger und die Veröffentlichung von Skripts.

Klassen

Name	Kurzbeschreibung
`AuthMode`	Eine Aufzählung, die angibt, welche Kategorien autorisierter Dienste Apps Script über eine ausgelöste Funktion ausführen kann.
`AuthorizationInfo`	Ein Objekt, das prüft, ob der Nutzer die Autorisierung für die erforderlichen Bereiche des Skripts erteilt hat.
`AuthorizationStatus`	Eine Aufzählung, die den Autorisierungsstatus eines Skripts angibt.
`CalendarTriggerBuilder`	Builder für Kalender-Trigger.
`ClockTriggerBuilder`	Ein Builder für Uhrzeittrigger.
`DocumentTriggerBuilder`	Ein Builder für Dokument-Trigger.
`EventType`	Eine Aufzählung, die den Typ des ausgelösten Ereignisses angibt.
`FormTriggerBuilder`	Ein Builder für Formular-Trigger.
`InstallationSource`	Eine Enumeration, die angibt, wie das Skript als Add-on für den aktuellen Nutzer installiert wurde.
`ScriptApp`	Auf Skriptveröffentlichungen und ‑trigger zugreifen und diese bearbeiten.
`Service`	Auf die Skriptveröffentlichung zugreifen und sie bearbeiten.
`SpreadsheetTriggerBuilder`	Builder für Tabellen-Trigger.
`StateTokenBuilder`	Ermöglicht es Scripts, Status-Tokens zu erstellen, die in Callback-APIs (z. B. OAuth-Abläufen) verwendet werden können.
`Trigger`	Ein Skript-Trigger.
`TriggerBuilder`	Ein generischer Builder für Skript-Trigger.
`TriggerSource`	Eine Aufzählung, die die Quelle des Ereignisses angibt, das den Trigger auslöst.

`AuthMode`

Attribute

Attribut	Typ	Beschreibung
`NONE`	`Enum`	Ein Modus, der den Zugriff auf Dienste, für die eine Autorisierung erforderlich ist, nicht zulässt.
`CUSTOM_FUNCTION`	`Enum`	Ein Modus, der den Zugriff auf eine begrenzte Teilmenge von Diensten zur Verwendung in benutzerdefinierten Tabellenkalkulationsfunktionen ermöglicht.
`LIMITED`	`Enum`	Ein Modus, der den Zugriff auf eine begrenzte Teilmenge von Diensten ermöglicht.
`FULL`	`Enum`	Ein Modus, der den Zugriff auf alle Dienste ermöglicht, für die eine Autorisierung erforderlich ist.

`AuthorizationInfo`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getAuthorizationStatus()`	`AuthorizationStatus`	Ruft einen Wert ab, der angibt, ob der Nutzer dieses Skript autorisieren muss, um einen oder mehrere Dienste zu verwenden (z. B. `ScriptApp.AuthorizationStatus.REQUIRED`).
`getAuthorizationUrl()`	`String\|null`	Ruft die Autorisierungs-URL ab, mit der Zugriff auf das Skript gewährt werden kann.
`getAuthorizedScopes()`	`String[]\|null`	Ruft eine Liste der autorisierten Bereiche für das Skript ab.

`AuthorizationStatus`

Attribute

Attribut	Typ	Beschreibung
`REQUIRED`	`Enum`	Der Nutzer muss dieses Skript autorisieren, einen oder mehrere Dienste zu verwenden.
`NOT_REQUIRED`	`Enum`	Der Nutzer hat diesem Skript alle derzeit erforderlichen Autorisierungen erteilt.

`CalendarTriggerBuilder`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`create()`	`Trigger`	Erstellt den Trigger und gibt ihn zurück.
`onEventUpdated()`	`CalendarTriggerBuilder`	Gibt einen Trigger an, der ausgelöst wird, wenn ein Kalendereintrag erstellt, aktualisiert oder gelöscht wird.

`ClockTriggerBuilder`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`after(durationMilliseconds)`	`ClockTriggerBuilder`	Gibt die Mindestdauer in Millisekunden nach der aktuellen Zeit an, nach der der Trigger ausgeführt wird.
`at(date)`	`ClockTriggerBuilder`	Gibt an, wann der Trigger ausgeführt wird.
`atDate(year, month, day)`	`ClockTriggerBuilder`	Gibt an, dass der Trigger am angegebenen Datum ausgelöst wird, standardmäßig gegen Mitternacht (+/- 15 Minuten).
`atHour(hour)`	`ClockTriggerBuilder`	Gibt die Stunde an, zu der der Trigger ausgeführt wird.
`create()`	`Trigger`	Erstellt den Trigger.
`everyDays(n)`	`ClockTriggerBuilder`	Gibt an, dass der Trigger alle `n` Tage ausgeführt werden soll.
`everyHours(n)`	`ClockTriggerBuilder`	Gibt an, dass der Trigger alle `n` Stunden ausgeführt werden soll.
`everyMinutes(n)`	`ClockTriggerBuilder`	Gibt an, dass der Trigger alle `n` Minuten ausgeführt werden soll.
`everyWeeks(n)`	`ClockTriggerBuilder`	Gibt an, dass der Trigger alle `n` Wochen ausgeführt werden soll.
`inTimezone(timezone)`	`ClockTriggerBuilder`	Gibt die Zeitzone für die angegebenen Datums-/Uhrzeitangaben an, zu denen der Trigger ausgeführt wird.
`nearMinute(minute)`	`ClockTriggerBuilder`	Gibt die Minute an, zu der der Trigger ausgeführt wird (plus oder minus 15 Minuten).
`onMonthDay(day)`	`ClockTriggerBuilder`	Gibt das Datum im Monat an, an dem der Trigger ausgeführt wird.
`onWeekDay(day)`	`ClockTriggerBuilder`	Gibt den Wochentag an, an dem der Trigger ausgeführt wird.

`DocumentTriggerBuilder`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`create()`	`Trigger`	Erstellt den neuen Trigger und gibt ihn zurück.
`onOpen()`	`DocumentTriggerBuilder`	Gibt einen Trigger an, der ausgelöst wird, wenn das Dokument geöffnet wird.

`EventType`

Attribute

Attribut	Typ	Beschreibung
`CLOCK`	`Enum`	Der Trigger wird ausgelöst, sobald das zeitgesteuerte Ereignis einen bestimmten Zeitpunkt erreicht.
`ON_OPEN`	`Enum`	Der Trigger wird ausgelöst, sobald der Nutzer die Google Docs-, Google Sheets- oder Google Forms-Datei öffnet.
`ON_EDIT`	`Enum`	Der Trigger wird ausgelöst, sobald der Nutzer die Google-Tabelle bearbeitet, z. B. indem er einen neuen Wert in eine Zelle eingibt. Das gilt als Bearbeitung und nicht als Änderung.
`ON_FORM_SUBMIT`	`Enum`	Der Trigger wird ausgelöst, sobald der Nutzer auf ein Google-Formular antwortet.
`ON_CHANGE`	`Enum`	Der Trigger wird ausgelöst, sobald der Nutzer die Google-Tabelle ändert, z. B. durch Hinzufügen einer Zeile (was als Änderung und nicht als Bearbeitung gilt).
`ON_EVENT_UPDATED`	`Enum`	Der Trigger wird ausgelöst, sobald ein Termin im angegebenen Google-Kalender erstellt, aktualisiert oder gelöscht wird.

`FormTriggerBuilder`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`create()`	`Trigger`	Erstellt den neuen Trigger und gibt ihn zurück.
`onFormSubmit()`	`FormTriggerBuilder`	Gibt einen Trigger an, der ausgelöst wird, wenn eine Antwort für das Formular gesendet wird.
`onOpen()`	`FormTriggerBuilder`	Gibt einen Trigger an, der ausgelöst wird, wenn die Bearbeitungsansicht des Formulars geöffnet wird.

`InstallationSource`

Attribute

Attribut	Typ	Beschreibung
`APPS_MARKETPLACE_DOMAIN_ADD_ON`	`Enum`	Das Add‑on wurde vom Administrator für die Domain des Nutzers installiert.
`NONE`	`Enum`	Das Skript wird nicht als Add-on ausgeführt.
`WEB_STORE_ADD_ON`	`Enum`	Das Add-on wurde vom Nutzer über den Chrome Web Store installiert.

`ScriptApp`

Attribute

Attribut	Typ	Beschreibung
`AuthMode`	`AuthMode`	Eine Aufzählung, die angibt, welche Kategorien autorisierter Dienste Apps Script über eine ausgelöste Funktion ausführen kann.
`AuthorizationStatus`	`AuthorizationStatus`	Eine Aufzählung, die den Autorisierungsstatus eines Skripts angibt.
`EventType`	`EventType`	Eine Aufzählung, die den Typ des ausgelösten Ereignisses angibt.
`InstallationSource`	`InstallationSource`	Eine Aufzählung, die angibt, wie das Skript als Add-on für den Nutzer installiert wurde.
`TriggerSource`	`TriggerSource`	Eine Aufzählung, die die Quelle des Ereignisses angibt, das den Trigger auslöst.
`WeekDay`	`Weekday`	Eine Aufzählung, die die Wochentage darstellt.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`deleteTrigger(trigger)`	`void`	Entfernt den angegebenen Trigger, sodass er nicht mehr ausgeführt wird.
`getAuthorizationInfo(authMode)`	`AuthorizationInfo`	Ruft ein Objekt ab, mit dem geprüft wird, ob der Nutzer die Autorisierung für alle Skriptanforderungen erteilt hat.
`getAuthorizationInfo(authMode, oAuthScopes)`	`AuthorizationInfo`	Ruft ein Objekt ab, das prüft, ob der Nutzer die Autorisierung für die angeforderten Bereiche erteilt hat.
`getIdentityToken()`	`String\|null`	Ruft ein OpenID Connect-Identitätstoken für den effektiven Nutzer ab, wenn der Bereich `openid` gewährt wurde.
`getInstallationSource()`	`InstallationSource`	Gibt einen Enumerationswert zurück, der angibt, wie das Skript als Add-on für den aktuellen Nutzer installiert wurde. Das kann z. B. sein, dass der Nutzer es selbst über den Chrome Web Store installiert hat oder dass ein Domainadministrator es für alle Nutzer installiert hat.
`getOAuthToken()`	`String`	Ruft das OAuth 2.0-Zugriffstoken für den effektiven Nutzer ab.
`getProjectTriggers()`	`Trigger[]`	Ruft alle installierbaren Trigger ab, die dem aktuellen Projekt und dem aktuellen Nutzer zugeordnet sind.
`getScriptId()`	`String`	Ruft die eindeutige ID des Skriptprojekts ab.
`getService()`	`Service`	Ruft ein Objekt ab, mit dem das Veröffentlichen des Skripts als Web-App gesteuert wird.
`getUserTriggers(document)`	`Trigger[]`	Ruft alle installierbaren Trigger ab, die diesem Nutzer im angegebenen Dokument gehören, nur für dieses Skript oder Add-on.
`getUserTriggers(form)`	`Trigger[]`	Ruft alle installierbaren Trigger ab, die diesem Nutzer im angegebenen Formular für dieses Skript oder Add-on gehören.
`getUserTriggers(spreadsheet)`	`Trigger[]`	Ruft alle installierbaren Trigger ab, die diesem Nutzer in der angegebenen Tabelle für dieses Skript oder Add-on gehören.
`invalidateAuth()`	`void`	Macht die Autorisierung ungültig, die der effektive Nutzer zum Ausführen des aktuellen Skripts hat.
`newStateToken()`	`StateTokenBuilder`	Erstellt einen Builder für ein Status-Token, das in einer Callback-API (z. B. einem OAuth-Ablauf) verwendet werden kann.
`newTrigger(functionName)`	`TriggerBuilder`	Startet den Prozess zum Erstellen eines installierbaren Triggers, der beim Auslösen eine bestimmte Funktion aufruft.
`requireAllScopes(authMode)`	`void`	Prüft, ob der Nutzer die Einwilligung für alle vom Skript angeforderten Bereiche erteilt hat.
`requireScopes(authMode, oAuthScopes)`	`void`	Prüft, ob der Nutzer die Einwilligung für die angeforderten Bereiche erteilt hat.

`Service`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getUrl()`	`String`	Gibt die URL der Web-App zurück, wenn sie bereitgestellt wurde. Andernfalls wird `null` zurückgegeben.
`isEnabled()`	`Boolean`	Gibt `true` zurück, wenn das Skript als Web-App zugänglich ist.

`SpreadsheetTriggerBuilder`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`create()`	`Trigger`	Erstellt den Trigger und gibt ihn zurück.
`onChange()`	`SpreadsheetTriggerBuilder`	Gibt einen Trigger an, der ausgelöst wird, wenn sich der Inhalt oder die Struktur der Tabelle ändert.
`onEdit()`	`SpreadsheetTriggerBuilder`	Gibt einen Trigger an, der ausgelöst wird, wenn die Tabelle bearbeitet wird.
`onFormSubmit()`	`SpreadsheetTriggerBuilder`	Gibt einen Trigger an, der ausgelöst wird, wenn ein Formular in der Tabelle eingereicht wird.
`onOpen()`	`SpreadsheetTriggerBuilder`	Gibt einen Trigger an, der ausgelöst wird, wenn die Tabelle geöffnet wird.

`StateTokenBuilder`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`createToken()`	`String`	Erstellt eine verschlüsselte Stringdarstellung des Status-Tokens.
`withArgument(name, value)`	`StateTokenBuilder`	Fügt dem Token ein Argument hinzu.
`withMethod(method)`	`StateTokenBuilder`	Legt eine Callback-Funktion fest.
`withTimeout(seconds)`	`StateTokenBuilder`	Legt die Dauer in Sekunden fest, für die das Token gültig ist.

`Trigger`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getEventType()`	`EventType`	Gibt den Ereignistyp zurück, bei dem der Trigger ausgelöst wird.
`getHandlerFunction()`	`String`	Gibt die Funktion zurück, die aufgerufen wird, wenn der Trigger ausgelöst wird.
`getTriggerSource()`	`TriggerSource`	Gibt die Quelle der Ereignisse zurück, die das Auslösen des Triggers verursachen.
`getTriggerSourceId()`	`String`	Gibt die ID zurück, die für die Quelle spezifisch ist.
`getUniqueId()`	`String`	Gibt eine eindeutige Kennung zurück, mit der sich Trigger voneinander unterscheiden lassen.

`TriggerBuilder`

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`forDocument(document)`	`DocumentTriggerBuilder`	Erstellt ein `DocumentTriggerBuilder`, das mit dem angegebenen Dokument verknüpft ist, und gibt es zurück.
`forDocument(key)`	`DocumentTriggerBuilder`	Erstellt ein `DocumentTriggerBuilder`, das mit dem Dokument mit der angegebenen ID verknüpft ist, und gibt es zurück.
`forForm(form)`	`FormTriggerBuilder`	Erstellt ein `FormTriggerBuilder`, das mit dem angegebenen Formular verknüpft ist, und gibt es zurück.
`forForm(key)`	`FormTriggerBuilder`	Erstellt ein `FormTriggerBuilder`, das mit dem Formular mit der angegebenen ID verknüpft ist, und gibt es zurück.
`forSpreadsheet(sheet)`	`SpreadsheetTriggerBuilder`	Erstellt ein `SpreadsheetTriggerBuilder`, das mit der angegebenen Tabelle verknüpft ist, und gibt es zurück.
`forSpreadsheet(key)`	`SpreadsheetTriggerBuilder`	Erstellt ein `SpreadsheetTriggerBuilder`, das mit der Tabelle mit der angegebenen ID verknüpft ist, und gibt es zurück.
`forUserCalendar(emailId)`	`CalendarTriggerBuilder`	Gibt einen Builder zum Erstellen von Kalendertriggern zurück.
`timeBased()`	`ClockTriggerBuilder`	Erstellt ein `ClockTriggerBuilder` zum Erstellen zeitbasierter Trigger und gibt es zurück.

`TriggerSource`

Attribute

Attribut	Typ	Beschreibung
`SPREADSHEETS`	`Enum`	Google Sheets löst den Trigger aus.
`CLOCK`	`Enum`	Ein zeitgesteuertes Ereignis löst den Trigger aus.
`FORMS`	`Enum`	Google Formulare löst den Trigger aus.
`DOCUMENTS`	`Enum`	Google Docs löst den Trigger aus.
`CALENDAR`	`Enum`	Google Kalender löst den Trigger aus.

Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.

Zuletzt aktualisiert: 2025-12-11 (UTC).

Blog
Google Workspace Developers-Blog lesen
Stack Overflow
Eine Frage unter dem Tag „google-apps-script“ stellen
Codebeispiele
Sehen Sie sich unsere Codebeispiele an oder kopieren Sie sie, um eigene zu erstellen
Videos
Apps Script-Anleitungen ansehen