Ein Skript ist an eine Google Tabellen-, Google Docs-, Google Präsentationen- oder Google Formulare-Datei gebunden, wenn es aus diesem Dokument und nicht als eigenständiges Skript erstellt wurde. Die Datei, an die ein gebundenes Skript angehängt ist, wird als „Container“ bezeichnet. Gebundene Skripts verhalten sich im Allgemeinen wie eigenständige Skripts, mit der Ausnahme, dass sie nicht in Google Drive angezeigt werden, nicht von der Datei getrennt werden können, an die sie gebunden sind, und sie erhalten einige Sonderberechtigungen für die übergeordnete Datei.
Skripts können auch an Google Sites gebunden werden. Diese Skripts werden jedoch fast immer als Webanwendungen bereitgestellt. Aus Skripten, die an Google Tabellen, Docs, Präsentationen oder Formulare gebunden sind, können auch Webanwendungen werden. Dies kommt jedoch selten vor.
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 es über das 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. Um das Skript später wieder zu öffnen, gehen Sie genauso vor oder öffnen Sie es über das Apps Script-Dashboard.
Spezielle Methoden
Gebundene Skripts können einige Methoden aufrufen, die eigenständige Skripts nicht können:
- Mit
getActiveSpreadsheet()
,getActiveDocument()
,getActivePresentation()
undgetActiveForm()
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 für ihre übergeordnete Datei zugreifen, um benutzerdefinierte Menüs, Dialogfelder und Seitenleisten hinzuzufügen. - In Google Tabellen kann das Skript mit
getActiveSheet()
,getActiveRange()
undgetActiveCell()
das aktuelle Tabellenblatt des Nutzers, den ausgewählten Zellenbereich oder die ausgewählte einzelne Zelle bestimmen. MitsetActiveSheet(sheet)
undsetActiveRange(range)
kann das Skript diese Auswahl ändern. - In Google Docs kann das Skript mit
getCursor()
undgetSelection()
die Position des Nutzercursors oder des ausgewählten Textes bestimmen. MitsetCursor(position)
undsetSelection(range)
können diese Speicherorte vom Skript geändert werden.
Weitere Informationen finden Sie im Leitfaden zum Erweitern von Google Tabellen oder im Leitfaden zum Erweitern von Google Docs.
Benutzerdefinierte Menüs, Dialogfelder und Seitenleisten
Mit gebundenen Skripts können Sie Google Tabellen, Docs und 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 Skript, das an ein Dokument gebunden ist, kann sich nicht auf die Benutzeroberfläche eines anderen Dokuments auswirken.
Add-ons
Add-ons werden in Gmail, Google Tabellen, Google Docs, Google Präsentationen und Google Formulare ausgeführt. Wenn Sie ein gebundenes oder eigenständiges Skript entwickelt haben und es mit der ganzen Welt teilen möchten, können Sie es mit Apps Script als Add-on publish. So können andere Nutzer es aus dem Add-on-Store installieren.
Trigger
Gebundene Skripts können einfache Trigger wie die spezielle Funktion onOpen()
verwenden, die automatisch ausgeführt wird, wenn eine Datei von einem Nutzer mit Bearbeitungszugriff geöffnet wird. Wie alle Skripttypen 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 mit der Syntax =myFunctionName()
direkt aus einer Zelle aufgerufen wird. Benutzerdefinierte Funktionen ähneln daher den Hunderten von integrierten Funktionen in Google Tabellen wie AVERAGE
oder SUM
, mit der Ausnahme, dass Sie das Verhalten der benutzerdefinierten Funktion definieren.
Zugriff auf gebundene Skripts
Nur Nutzer, die die Berechtigung zum Bearbeiten eines Containers haben, können das zugehörige gebundene Script ausführen. Mitbearbeiter, die nur Lesezugriff haben, können den Skripteditor nicht öffnen. Wenn sie jedoch eine Kopie der Containerdatei erstellen, werden sie zum Inhaber der Kopie und können eine Kopie des Skripts sehen und ausführen.
Informationen zum Freigeben der Containerdatei eines Skripts finden Sie unter Dateien in Google Drive freigeben.