Ein Script 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 Script erstellt wurde. Die Datei, an die ein verknüpftes Script angehängt ist, wird als „Container“ bezeichnet. gebundene Scripts verhalten sich im Allgemeinen wie eigenständige Scripts, mit der Ausnahme, dass sie nicht in Google Drive angezeigt werden, nicht von der Datei getrennt werden können, mit der sie verknüpft sind, und dass sie einige spezielle Berechtigungen für die übergeordnete Datei erhalten.
Scripts können auch an Google Sites gebunden werden, werden aber fast immer als Web-Apps bereitgestellt. Scripts, die an Google Tabellen, Docs, Präsentationen oder Formulare gebunden sind, können auch zu Webanwendungen werden, was jedoch selten vorkommt.
gebundenes Script erstellen
Google Docs, Google Sheets oder Google Präsentationen
Wenn Sie ein verknüpftes Script 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 Script später wieder öffnen möchten, wiederholen Sie diese Schritte oder öffnen Sie das Script über das Apps Script-Dashboard.
Google Formulare
Wenn Sie ein verknüpftes Script in Google Forms erstellen möchten, öffnen Sie ein Formular und klicken Sie auf das Dreipunkt-Menü > Script-Editor. Wenn Sie das Script später wieder öffnen möchten, wiederholen Sie diese Schritte oder öffnen Sie es über das Apps Script-Dashboard.
Spezielle Methoden
In gebundenen Scripts können einige Methoden aufgerufen werden, die in eigenständigen Scripts nicht möglich sind:
- Mit
getActiveSpreadsheet(),getActiveDocument(),getActivePresentation()undgetActiveForm()können verknüpfte Scripts auf die übergeordnete Datei verweisen, ohne sich auf die Datei-ID zu beziehen. - Mit
getUikönnen verknüpfte Scripts auf die Benutzeroberfläche ihrer übergeordneten Datei zugreifen, um benutzerdefinierte Menüs, Dialogfelder und Seitenleisten hinzuzufügen. - In Google Tabellen können Sie mit
getActiveSheet(),getActiveRange()undgetActiveCell()festlegen, dass das Script das aktuelle Tabellenblatt, den ausgewählten Zellenbereich oder die ausgewählte Zelle des Nutzers ermittelt. MitsetActiveSheet(sheet)undsetActiveRange(range)kann das Script diese Auswahlen ändern. - In Google Docs können Sie mit
getActiveTab(),getCursor()undgetSelection()festlegen, dass das Script den aktuellen Tab, die Position des Cursors oder den ausgewählten Text des Nutzers ermittelt. MitsetActiveTab(tabId),setCursor(position)undsetSelection(range)kann das Script diese Auswahlen ä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 verknüpften Scripts 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 Script nur mit der Benutzeroberfläche der aktuellen Instanz einer geöffneten Datei interagieren kann. Das heißt, ein Skript, das an ein Dokument gebunden ist, kann die Benutzeroberfläche eines anderen Dokuments nicht beeinflussen.
Add-ons
Add-ons werden in Gmail, Google Tabellen, Google Docs, Google Präsentationen und Google Formulare ausgeführt. Wenn Sie ein verknüpftes oder eigenständiges Script entwickelt haben und es mit anderen teilen möchten, können Sie es mit Apps Script als Add-on veröffentlichen, damit andere Nutzer es im Add-on-Shop installieren können.
Trigger
Für verknüpfte Scripts können einfache Trigger wie die spezielle Funktion onOpen() verwendet werden, die automatisch ausgeführt wird, wenn eine Datei von einem Nutzer mit Bearbeitungszugriff geöffnet wird. Wie bei allen Scripttypen können auch hier installierbare Trigger verwendet werden.
Benutzerdefinierte Funktionen
Eine benutzerdefinierte Funktion ist eine Funktion in einem Script, das an Google Tabellen gebunden ist und die Sie direkt über eine Zelle mit der Syntax =myFunctionName() aufrufen. Benutzerdefinierte Funktionen ähneln also den Hunderten von vordefinierten Funktionen in Google Tabellen wie AVERAGE oder SUM, mit dem Unterschied, dass Sie das Verhalten der benutzerdefinierten Funktion selbst definieren.
Zugriff auf verknüpfte Scripts
Nur Nutzer, die berechtigt sind, einen Container zu bearbeiten, können das zugehörige Script ausführen. Mitbearbeiter mit Lesezugriff können den Script-Editor nicht öffnen. Wenn sie jedoch eine Kopie der Containerdatei erstellen, werden sie zum Eigentümer der Kopie und können eine Kopie des Scripts aufrufen und ausführen.
Informationen zum Freigeben der Containerdatei eines Scripts finden Sie unter Dateien in Google Drive freigeben.