Ein Skript ist an eine Datei in Google Tabellen, Google Docs, Google Präsentationen oder Google Formulare 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. Der einzige Unterschied besteht darin, dass sie nicht in Google Drive angezeigt werden und nicht von der Datei getrennt werden können, an die sie gebunden sind. Außerdem erhalten sie einige besondere Berechtigungen gegenüber der übergeordneten Datei.
Skripts können auch an Google Sites gebunden werden. Diese Skripts werden jedoch fast immer als Webanwendungen bereitgestellt. Skripts, die mit Google Tabellen, Google Docs, Google Präsentationen oder Google Formulare verknüpft sind, können ebenfalls zu Webanwendungen werden. Dies ist jedoch ungewöhnlich.
Gebundenes Skript erstellen
Google Docs, Google Tabellen oder Google Präsentationen
Wenn Sie in Google Docs, Google Tabellen oder Google Präsentationen ein gebundenes Skript 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. Um das Skript später wieder zu öffnen, gehen Sie genauso vor oder öffnen das Skript über das Apps Script-Dashboard.
Google Formulare
Um ein gebundenes Skript in Google Formulare zu erstellen, ö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 das Skript über das Apps Script-Dashboard.
Spezielle Methoden
Mit gebundenen Skripts können einige Methoden aufgerufen werden, was für eigenständige Skripts nicht möglich ist:
- Mit
getActiveSpreadsheet(),getActiveDocument(),getActivePresentation()undgetActiveForm()können gebundene Skripts auf ihre übergeordnete Datei verweisen, ohne auf die ID der Datei zu verweisen. - Mit
getUikönnen gebundene Skripts auf die Benutzeroberfläche für die übergeordnete Datei zugreifen, um benutzerdefinierte Menüs, Dialogfelder und Seitenleisten hinzuzufügen. - In Google Tabellen lassen Sie mit
getActiveSheet(),getActiveRange()undgetActiveCell()das aktuelle Tabellenblatt, den ausgewählten Zellenbereich oder die ausgewählte einzelne Zelle des Nutzers ermitteln.setActiveSheet(sheet)undsetActiveRange(range)lassen das Skript diese Auswahl ändern. - In Google Docs lassen sich mit
getCursor()undgetSelection()die Position des Cursors des Nutzers oder des ausgewählten Texts durch das Skript bestimmen.setCursor(position)undsetSelection(range)lassen das Skript diese Speicherorte ändern.
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, Google Docs und Google Formulare anpassen, indem Sie benutzerdefinierte Menüs und Dialogfelder oder Seitenleisten hinzufügen. Beachten Sie jedoch, dass ein Skript nur mit der Benutzeroberfläche für die aktuelle Instanz einer geöffneten Datei interagieren kann. Das heißt, ein an ein Dokument gebundenes Skript kann sich nicht auf die Benutzeroberfläche eines anderen Dokuments auswirken.
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 allgemein zugänglich machen möchten, können Sie es mit Apps Script als Add-on publish, damit andere Nutzer es aus dem Add-on-Store installieren können.
Trigger
Gebundene Skripts können einfache Trigger wie die spezielle onOpen()-Funktion verwenden, die automatisch ausgeführt wird, wenn ein Nutzer mit Bearbeitungszugriff eine Datei öffnet. Wie alle Skripttypen können auch installierbare Trigger verwendet werden.
Benutzerdefinierte Funktionen
Eine benutzerdefinierte Funktion ist eine an Google Tabellen gebundene Funktion in einem Skript, die Sie mit der Syntax =myFunctionName() direkt aus einer Zelle aufrufen. 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 mit der Berechtigung zum Bearbeiten eines Containers können das gebundene Skript ausführen. Mitbearbeiter, die nur Lesezugriff haben, können den Skripteditor nicht öffnen. Wenn sie jedoch eine Kopie der Containerdatei erstellen, werden sie zum Eigentümer der Kopie und können eine Kopie des Skripts ansehen und ausführen.
Informationen zum Freigeben der Containerdatei eines Skripts finden Sie unter Dateien in Google Drive freigeben.