Containergebundene Skripts

Ein Skript ist an eine Datei in Google Sheets, 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. Sie werden jedoch nicht in Google Drive angezeigt, 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 Skripts werden jedoch fast immer als Webanwendungen bereitgestellt. Skripts, die an Google Sheets, Google Docs, Google Präsentationen oder Google Formulare gebunden sind, können auch zu Webanwendungen werden. Das ist jedoch unüblich.

Gebundene Skripts sind im Grunde nicht veröffentlichte Google Workspace-Add‑ons, die nur für die Datei funktionieren, an die sie gebunden sind.

Gebundenes Skript erstellen

Sie können gebundene Skripts in Google Docs, Google Sheets, Google Präsentationen und Google Formulare erstellen.

Google Docs, Google Sheets oder Google Präsentationen

Wenn Sie ein gebundenes Skript in Google Docs, Google Sheets oder Google Präsentationen erstellen möchten, öffnen Sie ein Dokument in Google Docs, eine Tabelle in Google Sheets 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 Mehr > Script-Editor. Wenn Sie das Skript später wieder öffnen möchten, gehen Sie genauso vor oder öffnen Sie es über das Apps Script-Dashboard.

Mit dem clasp Tool können keine gebundenen Skripts erstellt, aber es kann geklont und bearbeitet werden.

Spezielle Methoden

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

getActiveSpreadsheet, getActiveDocument, getActivePresentation, und getActiveForm ermöglichen gebundenen Skripts, auf ihre übergeordnete Datei zu verweisen, ohne die Datei-ID zu verwenden.
getUi ermöglicht gebundenen Skripts den Zugriff auf die Benutzeroberfläche ihrer übergeordneten Datei, um benutzerdefinierte Menüs, Dialogfelder und Seitenleisten hinzuzufügen.
In Google Sheets können Sie mit getActiveSheet, getActiveRangeund getActiveCell das aktuelle Tabellenblatt, den ausgewählten Zellbereich oder die ausgewählte Zelle des Nutzers ermitteln. setActiveSheet und setActiveRange können Sie diese Auswahl ändern.
In Google Docs können Sie mit getActiveTab, getCursor und getSelection das aktuelle Tabellenblatt, die Cursorposition oder den ausgewählten Text des Nutzers ermitteln. setActiveTab, setCursor und setSelection können Sie diese Auswahl ändern.

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

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

Benutzerdefinierte Menüs, Dialogfelder und Seitenleisten

Gebundene Skripts können Google Sheets, Google Docs und Google Formulare anpassen, indem sie benutzerdefinierte Menüs und Dialogfelder oder Seitenleisten hinzufügen. Ein Skript kann nur mit der Benutzeroberfläche der aktuellen Instanz einer geöffneten Datei interagieren. Ein Skript, das an ein Dokument gebunden ist, kann die Benutzeroberfläche eines anderen Dokuments nicht beeinflussen.

Trigger

Gebundene Skripts können einfache Trigger wie die spezielle onOpen Funktion verwenden, die automatisch ausgeführt wird, wenn eine Datei von einem Nutzer mit Bearbeitungszugriff geöffnet wird. Wie alle Arten von Skripts können sie auch installierbare Trigger verwenden.

Benutzerdefinierte Funktionen

Eine benutzerdefinierte Funktion ist eine Funktion in einem Skript, das an Google Sheets gebunden ist. Sie wird direkt aus einer Zelle mit der Syntax =myFunctionName() aufgerufen. Benutzerdefinierte Funktionen ähneln den Hunderten von integrierten Funktionen in Google Sheets wie AVERAGE oder SUM. Sie definieren jedoch das Verhalten der benutzerdefinierten Funktion.

Zugriff auf gebundene Skripts

Nur Nutzer mit der Berechtigung zum Bearbeiten eines Containers können das zugehörige gebundene Skript ausführen. Nutzer mit nur Lesezugriff können den Script-Editor nicht öffnen. Wenn sie eine Kopie der Containerdatei erstellen, werden sie zum Eigentümer der Kopie und können eine Kopie des Skripts sehen und ausführen.

Informationen zum Freigeben der Containerdatei eines Skripts finden Sie unter Dateien aus Google Drive freigeben.

Alle an Container gebundenen Skripts verwenden dieselbe Zugriffsliste für Eigentümer, Betrachter und Bearbeitungszugriff, die für die Containerdatei definiert ist. Der Containereigentümer wird unabhängig davon, wer das Skript erstellt hat, zum Eigentümer eines neuen Skriptprojekts.