Ein Script ist an eine Google Tabellen-, Google Docs-, Google Präsentationen- oder Google Formulare-Datei gebunden, falls es die aus diesem Dokument erstellt wurden und nicht als eigenständiges Skript. Die Datei, an die ein gebundenes Skript angehängt ist, wird als „Container“ bezeichnet. Gebundene Skripts verhalten sich nicht in Google Drive angezeigt werden, können sie nicht von der Datei getrennt werden. an die sie gebunden sind, und erhalten einige besondere Berechtigungen für die übergeordnete Datei.
Beachten Sie, dass Skripts auch an Google Sites gebunden werden können. Diese Skripts sind jedoch Sie werden fast immer als Web-Apps bereitgestellt. Skripte die mit Google Tabellen, Google Docs, Google Präsentationen oder Google Formulare verknüpft sind, können ebenfalls zu Web-Apps werden. ist dies eher ungewöhnlich.
Gebundenes Skript erstellen
Google Docs, Google Tabellen oder Google Präsentationen
Um ein gebundenes Skript in Google Docs, Google Tabellen oder Google Präsentationen zu erstellen, öffnen Sie ein Dokument in Google Docs, eine Tabelle in Google Tabellen oder eine Präsentation in Google Präsentationen Erweiterungen > Apps Script. Um das Skript erneut in wiederholen Sie den Vorgang oder öffnen Sie das Skript im Apps Script-Dashboard
Google Formulare
Um ein gebundenes Skript in Google Formulare zu erstellen, öffnen Sie ein Formular und klicken Sie auf das Dreipunkt-Menü > Skript Editor. Um das Skript im wiederholen Sie den Vorgang oder öffnen Sie das Skript im Apps Script-Dashboard
Spezielle Methoden
Mit gebundenen Skripts können einige Methoden aufgerufen werden, was für eigenständige Skripts nicht möglich ist:
getActiveSpreadsheet()
,getActiveDocument()
getActivePresentation()
undgetActiveForm()
können gebundene Skripts auf ihre übergeordnete Datei verweisen, ohne auf den Datei-ID.- Mit
getUi
können Sie gebundene Skripts greifen auf die Benutzeroberfläche für ihre übergeordnete Datei zu, um sie hinzuzufügen. benutzerdefinierten Menüs, Dialogfeldern und Seitenleisten. - In Google Tabellen:
getActiveSheet()
getActiveRange()
undgetActiveCell()
lassen Sie das Skript das aktuelle Tabellenblatt des Nutzers, den ausgewählten Zellenbereich oder Zelle ausgewählt.setActiveSheet(sheet)
undsetActiveRange(range)
diese Auswahl durch das Skript ändern. - In Google Docs:
getActiveTab()
getCursor()
undgetSelection()
das Skript den aktuellen Tab des Nutzers, die Position der oder ausgewählten Text.setActiveTab(tabId)
,setCursor(position)
undsetSelection(range)
diese Auswahl durch das Skript ändern.
Weitere Informationen finden Sie in der Leitfaden zur Erweiterung von Google Tabellen oder den Leitfaden zur Erweiterung von Google Docs.
Benutzerdefinierte Menüs, Dialogfelder und Seitenleisten
Mit gebundenen Skripts können Sie Google Tabellen, Google Docs und Google Formulare anpassen, indem Sie benutzerdefinierten Menüs und Dialogfelder oder Seitenleisten. Denken Sie daran, Ein Skript kann jedoch nur mit der Benutzeroberfläche aktuelle Instanz einer geöffneten Datei Das heißt, ein an ein Dokument gebundenes Skript kann sich nicht auf die Benutzeroberfläche eines anderen Dokuments auswirken.
Add-ons
Add-ons können in Gmail, Google Tabellen, Google Docs, Google Präsentationen und Google Formulare. Wenn Sie eine Grenze oder eigenständig mit der Welt teilen möchten, können Sie mit Apps Script veröffentlichen Sie Ihr Skript als , damit andere Nutzer es aus dem Add-on-Store installieren können.
Trigger
Gebundene Skripts können einfache Trigger verwenden
wie z. B. die onOpen()
-Funktion, die automatisch ausgeführt wird,
wird von einem Nutzer mit Bearbeitungszugriff geöffnet. Wie alle Skripttypen können sie
Verwenden Sie außerdem installierbare Trigger.
Benutzerdefinierte Funktionen
Eine benutzerdefinierte Funktion ist eine Funktion in einem
an Google Tabellen gebundene Skript, das Sie direkt aus einer Zelle mithilfe der
=myFunctionName()
. Benutzerdefinierte Funktionen ähneln daher den Hunderten von
integrierte Funktionen in Google Tabellen
wie AVERAGE
oder
SUM
mit der Ausnahme, dass Sie
das Verhalten der benutzerdefinierten Funktion.
Zugriff auf gebundene Skripts
Nur Nutzer mit der Berechtigung zum Bearbeiten eines Containers können das gebundene Skript ausführen. Mitbearbeiter, die nur Lesezugriff haben, können das Skript nicht öffnen Editor erstellt. Wenn er jedoch eine Kopie der Containerdatei erstellt, wird er zur Eigentümer der Kopie und kann eine Kopie des Skripts sehen und ausführen.
Weitere Informationen dazu, wie Sie die Containerdatei eines Skripts freigeben, finden Sie unter Dateien freigeben von Google Drive