Containergebundene Skripts

Ein Skript ist an eine Datei in Google Tabellen, Google Docs, Google Präsentationen oder Google Formulare gebunden, wenn es aus diesem Dokument erstellt wurde und nicht als eigenständiges Skript. Die Datei, an die ein gebundenes Skript angehängt ist, wird als „Container“ bezeichnet. Gebundene Skripts verhalten sich in der Regel wie eigenständige Skripts, mit der Ausnahme, dass sie nicht in Google Drive angezeigt werden. Sie können nicht von der Datei getrennt werden, an die sie gebunden sind, und erhalten einige spezielle Berechtigungen für die übergeordnete Datei.

Skripts können auch an Google Sites gebunden werden. Diese werden jedoch fast immer als Webanwendungen bereitgestellt. Skripts, die an Google Tabellen, Google Docs, Google Präsentationen oder Google Formulare gebunden sind, können ebenfalls zu Webanwendungen werden, obwohl dies ungewöhnlich ist.

Hinweis: Gebundene Skripts sind praktisch unveröffentlichte Add-ons, die nur für die Datei funktionieren, an die sie gebunden sind.

Ein gebundenes Skript erstellen

Google Docs, Google Tabellen oder Google Präsentationen

Wenn Sie ein gebundenes Skript in Google Docs, Google Tabellen oder Google Präsentationen erstellen möchten, öffnen Sie ein Dokument in Google Docs, eine Tabelle in Google Tabellen oder eine Präsentation in Google Präsentationen und klicken Sie auf Erweiterungen > Apps Script. Wenn Sie das Skript später wieder öffnen möchten, gehen Sie genauso vor oder öffnen Sie das Skript im Apps Script-Dashboard.

Google Formulare

Wenn Sie ein gebundenes Skript in Google Formulare erstellen möchten, öffnen Sie ein Formular und klicken Sie auf das Dreipunkt-Menü > Skripteditor. Wenn Sie das Skript später wieder öffnen möchten, gehen Sie genauso vor oder öffnen Sie das Skript über das Apps Script-Dashboard.

Hinweis: Das clasp-Tool kann gebundene Skripts nicht erstellen, aber sie können geklont und bearbeitet werden.

Spezielle Methoden

Gebundene Skripts können einige Methoden aufrufen, die eigenständige Skripts nicht können:

• Mit getActiveSpreadsheet(), getActiveDocument(), getActivePresentation() und getActiveForm() können gebundene Skripts auf ihre übergeordnete Datei verweisen, ohne auf die ID der Datei zu verweisen.
• Mit getUi können gebundene Skripts auf die Benutzeroberfläche ihrer übergeordneten Datei zugreifen, um benutzerdefinierte Menüs, Dialogfelder und Seitenleisten hinzuzufügen.
• In Google Tabellen können Sie anhand des Skripts getActiveSheet(), getActiveRange() und getActiveCell() das aktuelle Tabellenblatt des Nutzers, einen ausgewählten Zellenbereich oder eine ausgewählte Zelle bestimmen lassen. Mit setActiveSheet(sheet) und setActiveRange(range) kann das Skript diese Auswahl ändern.
• In Google Docs können Sie mit getCursor() und getSelection() das Skript die Position des Mauszeigers oder des ausgewählten Texts festlegen. Mit setCursor(position) und setSelection(range) können Sie das Skript diese Standorte ändern lassen.

Weitere Informationen finden Sie im Leitfaden zum Erweitern von Google-Tabellen oder im Leitfaden zum Erweitern von Google Docs.

Hinweis: Diese Methoden sind nur für gebundene Skripts verfügbar, die über den Skripteditor, Menüelemente, Dialogfelder, Seitenleisten oder Trigger ausgeführt werden. Wenn ein gebundenes Skript als Webanwendung oder über die Apps Script API ausgeführt wird, sind diese Methoden nicht verfügbar.

Benutzerdefinierte Menüs, Dialogfelder und Seitenleisten

Gebundene Skripts können Google Tabellen, Google Docs und Google Formulare anpassen, indem sie benutzerdefinierte Menüs und Dialogfelder oder Seitenleisten hinzufügen. Ein Skript kann jedoch nur mit der Benutzeroberfläche für die aktuelle Instanz einer geöffneten Datei interagieren. Das heißt, ein an ein Dokument gebundenes Skript kann die Benutzeroberfläche eines anderen Dokuments nicht beeinträchtigen.

Mit Add-ons können auch benutzerdefinierte Menüs, Dialogfelder und Seitenleisten hinzugefügt werden. Es wird empfohlen, Add-ons mit eigenständigen Skripts zu entwickeln.

Add-ons

Add-ons können in Gmail, Google Tabellen, Google Docs, Google Präsentationen und Google Formulare ausgeführt werden. Wenn Sie ein gebundenes oder eigenständiges Skript entwickelt haben und es mit der Welt teilen möchten, können Sie es mit Apps Script als Add-on veröffentlichen, damit andere Nutzer es aus dem Add-on-Store installieren können.

Trigger

Gebundene Skripts können einfache Trigger wie die spezielle Funktion onOpen() verwenden, die automatisch jedes Mal ausgeführt wird, wenn ein Nutzer, der Bearbeitungszugriff hat, eine Datei geöffnet hat. Wie alle Arten von Skripts können auch sie installierbare Trigger verwenden.

Benutzerdefinierte Funktionen

Eine benutzerdefinierte Funktion ist eine Funktion in einem Skript, die an Google Tabellen gebunden ist und die Sie mithilfe der Syntax =myFunctionName() direkt aus einer Zelle aufrufen. Benutzerdefinierte Funktionen ähneln daher Hunderten von integrierten Funktionen in Google Tabellen wie AVERAGE oder SUM, mit der Ausnahme, dass Sie das Verhalten der benutzerdefinierten Funktionen definieren.

Zugriff auf gebundene Skripts

Nur gebundene Nutzer können das gebundene Skript ausführen. Mitbearbeiter, die nur Lesezugriff haben, können den Skripteditor nicht öffnen. Wenn sie jedoch eine Kopie der übergeordneten Datei erstellen, werden sie zum Eigentümer der Kopie und können eine Kopie des Skripts ansehen und ausführen.

Alle containergebundenen Skripts verwenden die gleichen Zugriffs-, Betrachter- und Bearbeiterzugriffslisten, die für die Containerdatei definiert sind. Der Containerinhaber übernimmt die Inhaberschaft eines neuen Skriptprojekts, unabhängig davon, wer es erstellt hat.