Containergebundene Skripts

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.

Hinweis :gebundene Scripts sind Add-ons, die nicht veröffentlicht wurden und nur für die Datei funktionieren, mit der sie verknüpft sind.

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.

Hinweis :Mit dem Tool clasp können keine verknüpften Scripts erstellt, aber geklont und bearbeitet werden.

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 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() und getActiveCell() festlegen, dass das Script das aktuelle Tabellenblatt, den ausgewählten Zellenbereich oder die ausgewählte Zelle des Nutzers ermittelt. Mit setActiveSheet(sheet) und setActiveRange(range) kann das Script diese Auswahlen ä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.

Hinweis: Diese Methoden sind nur für gebundene Scripts verfügbar, die über den Script-Editor, Menüpunkte, Dialogfelder, Seitenleisten oder Trigger ausgeführt werden. Wenn ein verknüpftes Script als Webanwendung oder über die Apps Script API ausgeführt wird, sind diese Methoden nicht verfügbar.

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.

Mit Add-ons können Sie auch benutzerdefinierte Menüs, Dialogfelder und Seitenleisten hinzufügen. Wir empfehlen, Add-ons mit eigenständigen Scripts zu entwickeln.

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.

Alle containergebundenen Scripts verwenden dieselbe Zugriffsliste für Inhaber, Betrachter und Bearbeiter, die für die Containerdatei definiert ist. Der Containerinhaber übernimmt die Inhaberschaft für ein neues Scriptprojekt, unabhängig davon, wer es erstellt hat.