Im Apps Script-Dashboard können Sie Ihre Apps Script-Projekte verwalten und überwachen. Mit dem Dashboard können Sie:
- Sie können Ihre vorhandenen Apps Script-Projekte ansehen und durchsuchen, einschließlich gebundener Skripts, die an Google Workspace-Dokumente angehängt sind.
- Neue Projekte erstellen
- Details zu Ihren Projekten ansehen, z. B. die verwendeten OAuth-Bereiche.
- Zustand und Nutzung Ihrer Skriptprojekte überwachen
- Ausführungsprotokolle für Ihre Projekte und andere Projekte ansehen, die mit den Anmeldedaten Ihres Kontos ausgeführt werden.
- Aktivieren oder deaktivieren Sie die Apps Script API, um Apps die Verwendung der API für die Interaktion mit Ihren Scriptprojekten zu erlauben oder zu untersagen.
Projekte ansehen und suchen
Im Apps Script-Dashboard werden alle Scriptprojekte aufgeführt, die Sie aufrufen oder bearbeiten können. In der linken Navigationsleiste des Dashboards werden diese Projekte in die folgenden Kategorien unterteilt:
- Markierte Projekte Projekte, die Sie überwachen.
- Meine Projekte Projekte, deren Inhaber Sie sind.
- Alle Projekte Projekte, deren Inhaber Sie sind oder für die Sie über Lese- oder Bearbeitungsberechtigungen verfügen.
- Für mich freigegeben Projekte, die Ihnen nicht gehören, aber für Sie freigegeben wurden.
- Papierkorb Projekte, die Sie aus Google Drive entfernt haben.
In den Projektlisten werden der Projektname, der Inhaber und das Datum der letzten Änderung angezeigt. Symbole neben dem Projektnamen geben an, ob es sich um ein eigenständiges oder ein gebundenes Projekt handelt.
Projektdetails ansehen
Jedes Projekt enthält eine Ansicht, in der Entwicklerdetails zum Projekt angezeigt werden. Wenn Sie die Details zu einem Projekt aufrufen möchten, klicken Sie in der Projektliste auf die entsprechende Zeile.
In der Ansicht mit den Projektdetails werden Daten und Diagramme zu Fehlerrate, Ausführungen und Nutzern des Projekts sowie die OAuth-Bereiche angezeigt, die von allen Nutzern des Projekts angefordert werden. Die Datenmesswerte sind so definiert:
- Fehlerrate. Der Prozentsatz der Ausführungen, die aufgrund nicht abgefangener Ausnahmen nicht ausgeführt werden konnten. Sie wird berechnet, indem die Anzahl der fehlgeschlagenen Ausführungen durch die Gesamtzahl der Ausführungen im definierten Zeitraum geteilt wird.
- Ausführungen: Gibt an, wie oft ein Projekt ausgeführt wurde. Weitere Informationen dazu, wie ein Projekt ausgeführt werden kann, finden Sie unter Ausführungstypen.
- Nutzer Die Anzahl der einzelnen Nutzerkonten, mit denen das Projekt im angegebenen Zeitraum mindestens einmal ausgeführt wurde. Anonyme Nutzer werden nicht erfasst und sind daher nicht in der Nutzerzahl oder in den Grafiken enthalten.
Jede Bereitstellung Ihres Projekts wird auf der Seite Projektdetails als Tab vor den Daten und Grafiken angezeigt. Wählen Sie den Tab aus, um die zugehörigen Daten für diese Bereitstellung aufzurufen. Wenn Sie ALLE auswählen, werden zusammengefasste Daten für alle Bereitstellungen des Projekts und für Ausführungen angezeigt, die von Entwicklern stammen, die das Projekt im Apps Script-Code-Editor ausführen.
Projekte, die als Add-ons veröffentlicht wurden, werden im Apps Script-Dashboard nicht als bereitgestellt angezeigt.
Projekte überwachen
Projekte als Lesezeichen speichern, indem Sie sie markieren. Wenn Sie Projekte mit einem Stern markieren, können Sie auch Statistiken und Diagramme zur zusammengefassten Nutzung und Fehlerrate aufrufen.
Wenn Sie ein Projekt markieren möchten, klicken Sie rechts neben einer Projektzeile auf das Dreipunkt-Menü > Markierung hinzufügen. Sie können ein Projekt auch mit einem Sternchen markieren, indem Sie beim Anzeigen der Projektdetails auf „Mehr“ klicken.
Wählen Sie in der linken Navigationsleiste Markierte Projekte aus, um die Projekte zu sehen, die Sie mit einem Lesezeichen versehen haben. Klicken Sie oben auf der Seite auf die Kurzübersicht Fehlerrate, Ausführungen oder Nutzer, um die zugehörigen Diagramme für alle Ihre mit Sternchen markierten Projekte der letzten 7 Tage aufzurufen.
Wenn Sie die Markierung eines Projekts entfernen möchten, klicken Sie in der entsprechenden Projektzeile auf das Dreipunkt-Menü und wählen Sie Markierung entfernen aus.
Ausführungen verwalten
Im Apps Script-Dashboard können Sie einzelne Ausführungen von Apps Script-Projektfunktionen ansehen und verwalten. Eine vollständige Liste der letzten Ausführungen finden Sie, wenn Sie im linken Navigationsbereich Meine Ausführungen auswählen.
Im Bereich Meine Ausführungen wird ein Log aller vorherigen und laufenden Ausführungen für Projekte angezeigt, für die Sie Inhaber, Bearbeiter oder Betrachter sind. Diese Liste kann auch Funktionsausführungen in Projekten enthalten, auf die Sie keinen Zugriff haben, wenn sie in Ihrem Namen ausgeführt werden, z. B. Add-ons, die Sie installiert und ausgeführt haben. In der Ausführungsliste wird nur die erste Funktion angezeigt, die zum Starten der Ausführung aufgerufen wird. Es werden nicht alle Funktionen angezeigt, die während der Ausführung aufgerufen wurden.
Mit den Filtern oben in der Ansicht können Sie festlegen, welche Art von Ausführung im Log erfasst wird. Jede Zeile des Protokolls steht für eine einzelne Ausführung. In den Spalten Startzeit, Dauer und Status werden die entsprechenden Informationen zu dieser Ausführung angezeigt.
In der Spalte Funktion wird der Name der Funktion angezeigt, die die Ausführung initiiert hat. In dieser Spalte ist kein Name angegeben, wenn Sie keinen Zugriff auf das entsprechende Skriptprojekt der Ausführung haben, es aber in Ihrem Namen ausgeführt wurde.
In der Spalte Typ wird angezeigt, wodurch die Ausführung ausgelöst wurde. Zu den Werten gehören:
- Add-on hinzufügen Die Ausführung erfolgte über ein Add-on.
- Execution API Die Ausführung wurde durch einen Aufruf der Apps Script API ausgelöst.
- Zeitbezogen: Die Ausführung wurde durch ein Zeitereignis ausgelöst.
- Trigger Die Ausführung wurde durch eine Triggerquelle ausgelöst.
- Web-App Die Ausführung stammt von einer bereitgestellten Webanwendung.
- Bearbeiter Die Ausführung wurde im Apps Script-Editor gestartet.
Ausführungen beenden
Lang andauernde Ausführungen, die gerade laufen, werden durch den Status „Wird ausgeführt“ gekennzeichnet. Wenn Sie diese Ausführungen beenden möchten, klicken Sie rechts neben der Projektzeile auf das Dreipunkt-Menü > Beenden.
Einstellungen
Passen Sie die Dashboard-Einstellungen an, indem Sie im linken Navigationsbereich Einstellungen auswählen.
Im Bereich Einstellungen befindet sich ein Schalter für die Apps Script API. So können Sie der API Zugriff auf Ihre Skriptprojekte gewähren.
Klicken Sie im Bereich Einstellungen auf das Label Google Apps Script API, um auf diese Ein/Aus-Schaltfläche zuzugreifen. Daraufhin wird ein neues Feld mit Warntext und einem Ein/Aus-Schalter geöffnet. Der Zugriff auf Ihre Scriptprojekte ist standardmäßig deaktiviert, um die Sicherheit zu erhöhen. Sobald Sie den Zugriff gewähren, kann jede von Ihnen autorisierte Drittanbieteranwendung die API verwenden, um Ihre Skripts und Deployments zu ändern. Sie können diese Zugriffsberechtigung jederzeit in den Einstellungen widerrufen.
Weitere Informationen finden Sie im Leitfaden zum Zugriff auf die Apps Script API.