Containergebundene Skripts

Ein Script ist an eine Datei in Google Sheets, Google Docs, Google Präsentationen oder Google Formulare gebunden, wenn es aus diesem Dokument heraus und nicht als eigenständiges Script 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 einige spezielle Berechtigungen für die übergeordnete Datei erhalten.

Skripts können auch an Google Sites gebunden werden, werden aber fast immer als Web-Apps bereitgestellt. An Tabellen, Docs, Präsentationen oder Formulare gebundene Skripts können auch Webanwendungen werden, obwohl dies ungewöhnlich ist.

Gebundene Skripts sind im Grunde unverö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 Docs, eine Tabelle in Sheets oder eine Präsentation in 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.

Formulare

Wenn Sie ein gebundenes Skript in Google Formulare erstellen möchten, öffnen Sie ein Formular und klicken Sie auf das Dreipunkt-Menü more_vert > Skripteditor. 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 Tool clasp können keine gebundenen Skripts erstellt werden, aber sie können geklont und bearbeitet werden.

Spezielle Methoden

Gebundene Skripts können einige Methoden aufrufen, die in eigenständigen Skripts nicht möglich sind:

• getActiveSpreadsheet, getActiveDocument, getActivePresentation> und getActiveForm ermöglichen es, dass gebundene Skripts auf ihre übergeordnete Datei verweisen, ohne die ID der Datei anzugeben.
• Mit getUi können gebundene Skripts auf die Benutzeroberfläche der übergeordneten Datei zugreifen, um benutzerdefinierte Menüs, Dialogfelder und Seitenleisten hinzuzufügen.
• In Google Tabellen können Sie mit getActiveSheet, getActiveRange und getActiveCell das aktuelle Tabellenblatt, den ausgewählten Zellenbereich oder die ausgewählte einzelne Zelle des Nutzers vom Script ermitteln lassen. setActiveSheet und setActiveRange ermöglichen es dem Script, diese Auswahl zu ändern.
• In Docs, getActiveTab, getCursor und getSelection kann das Skript den aktuellen Tab des Nutzers, die Position des Cursors des Nutzers oder den ausgewählten Text ermitteln. setActiveTab, setCursor> und setSelection ermöglichen es dem Skript, diese Auswahl zu ändern.

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

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

Benutzerdefinierte Menüs, Dialogfelder und Seitenleisten

Mit gebundenen Skripts können Sie Sheets, Docs und Formulare anpassen, indem Sie benutzerdefinierte Menüs und Dialogfelder oder Seitenleisten hinzufügen. Ein Skript kann nur mit der Benutzeroberfläche für die aktuelle 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 Funktion onOpen 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 an Google Sheets gebundenen Script, die Sie direkt aus einer Zelle mit der Syntax =myFunctionName() aufrufen. Benutzerdefinierte Funktionen ähneln den Hunderten von integrierten Funktionen in Google Tabellen wie AVERAGE oder SUM. Der Unterschied besteht darin, dass Sie das Verhalten der benutzerdefinierten Funktion definieren.

Zugriff auf gebundene Skripts

Nur Nutzer mit der Berechtigung zum Bearbeiten eines Containers können das zugehörige gebundene Skript ausführen. Mitbearbeiter 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 aufrufen und ausführen.

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

Für alle containergebundenen Skripts wird dieselbe Zugriffsliste für Inhaber, Betrachter und Mitbearbeiter verwendet, die für die Containerdatei definiert ist. Der Containerinhaber übernimmt die Inhaberschaft eines neuen Skriptprojekts, unabhängig davon, wer es erstellt hat.