Containergebundene Skripts

Ein Script ist an eine Google Tabellen-, Docs-, Präsentationen- oder 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. 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 Script erstellen

Google Docs, Google Sheets 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. 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ü more_vert > Script-Editor. Wenn Sie das Script später wieder öffnen möchten, wiederholen Sie die 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() und getActiveForm() können verknüpfte Scripts auf die übergeordnete Datei verweisen, ohne sich auf die Datei-ID zu beziehen.
• Mit getUi kö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 können Sie mit getActiveSheet(), getActiveRange() und getActiveCell() das Script das aktuelle Tabellenblatt, den ausgewählten Zellenbereich oder die ausgewählte Zelle des Nutzers ermitteln lassen. setActiveSheet(sheet) und setActiveRange(range) lassen das Skript diese Auswahl ändern.
• In Google Docs können Sie mit getActiveTab(), getCursor() und getSelection() festlegen, dass das Script den aktuellen Tab, die Position des Cursors oder den ausgewählten Text des Nutzers ermittelt. Mit setActiveTab(tabId), setCursor(position) und setSelection(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 Skript nur mit der Benutzeroberfläche für die aktuelle 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 können in Gmail, Google Tabellen, Google Docs, Google Präsentationen und Google Formulare verwendet werden. 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 Skript, das an Google Tabellen gebunden ist und die Sie direkt über eine Zelle mit der Syntax =myFunctionName() 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, 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.