Containergebundene Skripts

Ein Script ist an eine Google-Tabelle, ein Google-Dokument, eine Google-Präsentation oder ein Google-Formular gebunden, wenn es aus diesem Dokument 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 folgenden Ausnahmen: Sie werden nicht in Google Drive angezeigt, können nicht von der Datei getrennt werden, an die sie gebunden sind, und haben einige besondere Berechtigungen für die übergeordnete Datei.

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

Hinweis :Gebundene Scripts sind im Grunde nicht veröffentlichte Add-ons, die nur für die Datei funktionieren, an die sie gebunden sind.

Gebundenes Skript erstellen

Google Docs, Google Sheets oder Google Präsentationen

Wenn Sie ein gebundenes Skript in Google Docs, Sheets oder 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.

Google Formulare

Wenn Sie ein gebundenes Skript in Google Formulare erstellen möchten, öffnen Sie ein Formular und klicken Sie auf das Dreipunkt-Menü  > Scripteditor. Wenn Sie das Skript später wieder öffnen möchten, gehen Sie genauso vor oder öffnen Sie es über das Apps Script-Dashboard.

Hinweis :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 verfügbar 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 Sheets können Sie mit getActiveSheet(), getActiveRange() und getActiveCell() festlegen, dass das Script die aktuelle Tabelle, den ausgewählten Zellenbereich oder die ausgewählte einzelne Zelle des Nutzers ermittelt. setActiveSheet(sheet) und setActiveRange(range) ermöglichen es dem Script, diese Auswahl zu ändern.
• In Google Docs können Sie mit getActiveTab(), getCursor() und getSelection() festlegen, dass das Skript den aktuellen Tab des Nutzers, die Position des Cursors des Nutzers oder den ausgewählten Text ermittelt. Mit setActiveTab(tabId), setCursor(position) und setSelection(range) kann das Skript diese Auswahl ändern.

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

Hinweis :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 Webanwendung oder über die Apps Script API ausgeführt wird, sind diese Methoden nicht verfügbar.

Benutzerdefinierte Menüs, Dialogfelder und Seitenleisten

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

Mit Add-ons können auch benutzerdefinierte Menüs, Dialogfelder und Seitenleisten hinzugefügt werden. Wir empfehlen, Add-ons mit eigenständigen Skripts zu entwickeln.

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 Tabellen gebundenen Skript, die Sie direkt aus einer Zelle mit der Syntax =myFunctionName() aufrufen. Benutzerdefinierte Funktionen ähneln also 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 Lesezugriff können den Scripteditor nicht öffnen. Wenn sie jedoch eine Kopie der Containerdatei erstellen, werden sie zum Inhaber der Kopie und können eine Kopie des Scripts sehen und ausführen.

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

Alle containergebundenen Skripts verwenden dieselbe Liste mit Zugriffsberechtigungen für Inhaber, Betrachter und Mitbearbeiter, die für die Containerdatei definiert ist. Der Containerinhaber übernimmt die Inhaberschaft eines neuen Skriptprojekts, unabhängig davon, wer es erstellt hat.