Im Apps Script-Dashboard können Sie Ihre Apps Script-Projekte verwalten und beobachten. Mit dem Dashboard können Sie Folgendes tun:
- Sie können Ihre vorhandenen Apps Script-Projekte aufrufen und nach ihnen suchen, einschließlich gebundener Scripts, die anGoogle Workspace -Dokumente angehängt sind.
- Neue Projekte erstellen
- Sie können Details zu Ihren Projekten aufrufen, z. B. die verwendeten OAuth-Bereiche.
- Integrität und Nutzung Ihrer Scriptprojekte überwachen
- Sie können Ausführungsprotokolle für Ihre Projekte und andere Projekte aufrufen, die mit den Anmeldedaten Ihres Kontos ausgeführt werden.
- Aktivieren oder deaktivieren Sie die Apps Script API, um zuzulassen oder zu verhindern, dass Apps die API verwenden, um mit Ihren Script-Projekten zu interagieren.
Projekte ansehen und nach Projekten suchen
Im Apps Script-Dashboard werden alle Script-Projekte aufgelistet, die Sie sich ansehen oder bearbeiten können. Im linken Navigationsbereich des Dashboards sind 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 Berechtigungen zum Ansehen oder Bearbeiten haben.
- Für mich freigegeben Projekte, deren Inhaber Sie nicht sind, die aber für Sie freigegeben wurden.
- Papierkorb Projekte, die Sie aus Google Drive entfernt haben.
Die Projektlisten enthalten den Projektnamen, den Inhaber und das Datum der letzten Änderung. Die 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 mit Entwicklerdetails zum Projekt. Wenn Sie die Details zu einem Projekt aufrufen möchten, klicken Sie in der Projektliste auf die entsprechende Zeile.
Die Projektdetails enthalten Daten und Grafiken zu Fehlerrate, Ausführungen und Nutzern sowie OAuth-Bereiche, die von Endnutzern angefordert wurden, die das Projekt verwenden. Die Datenmesswerte sind so definiert:
- Fehlerrate. Der Prozentsatz der Ausführungen, die aufgrund von nicht abgefangenen Ausnahmen fehlgeschlagen sind. Er wird berechnet, indem die Anzahl der fehlgeschlagenen Ausführungen durch die Gesamtzahl der Ausführungen im angegebenen 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 Nutzer (Konten), die das Projekt im angegebenen Zeitraum einmal oder mehrmals ausgeführt haben. Anonyme Nutzer werden nicht erfasst und spiegeln sich daher nicht in der Nutzeranzahl oder in den Diagrammen wider.
Jede Bereitstellung Ihres Projekts wird auf der Seite Projektdetails als Tab über den Daten und Diagrammen angezeigt. Sie können den Tab auswählen, um die zugehörigen Daten für diese Bereitstellung aufzurufen. Wenn Sie ALLE auswählen, werden zusammengefasste Daten für alle Bereitstellungen und Ausführungen des Projekts angezeigt, die dadurch entstehen, dass Entwickler das Projekt im Apps Script-Code-Editor ausführen.
Projekte beobachten
Möglicherweise haben Sie Zugriff auf deutlich mehr Apps Script-Projekte, als Sie regelmäßig verwenden oder verwalten. Sie können Projekte mit einem Stern markieren, um sie als Lesezeichen zu speichern und so leichter darauf zuzugreifen. Wenn Sie Projekte mit einem Stern markieren, können Sie auch zusammengefasste Statistiken und Diagramme zur Nutzung und Fehlerrate dieser Projekte ansehen.
Wenn Sie ein Projekt mit einem Stern markieren möchten, klicken Sie rechts neben einer Projektzeile auf das Dreipunkt-Menü > Stern hinzufügen. Du kannst ein Projekt auch markieren, indem du in den Projektdetails auf das Dreipunkt-Menü klickst.
In der linken Navigationsleiste können Sie Gemarkierte Projekte auswählen, um die Projekte aufzurufen, die Sie als Lesezeichen gespeichert 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 markierten Projekte der letzten sieben Tage aufzurufen.
Sie können ein Sternchen aus einem Projekt entfernen, indem Sie in der Projektzeile auf das Dreipunkt-Menü klicken und Stern entfernen auswählen.
Ausführungen verwalten
Im Apps Script-Dashboard können Sie einzelne Ausführungen von Apps Script-Projektfunktionen ansehen und verwalten. Ein vollständiges Protokoll der letzten Ausführungen finden Sie im linken Navigationsbereich unter Meine Ausführungen.
Im Bereich Meine Ausführungen wird standardmäßig ein Protokoll aller bisherigen und derzeit 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 anfängliche Funktion angezeigt, die zum Starten der Ausführung aufgerufen wird. Es werden nicht alle Funktionen angezeigt, die während dieser Ausführung aufgerufen wurden.
Mit den Filtern oben in der Ansicht können Sie festlegen, welche Art von Ausführung im Log protokolliert wird. Jede Zeile des Logs steht für eine einzelne Ausführung. In den Spalten Startzeit, Dauer und Status finden Sie die entsprechenden Informationen zu dieser Ausführung.
In der Spalte Funktion wird der Name der Funktion angezeigt, die die Ausführung initiiert hat. In dieser Spalte ist kein Name zu sehen, wenn Sie keinen Zugriff auf das entsprechende Scriptprojekt der Ausführung haben, es aber in Ihrem Namen ausgeführt wurde.
In der Spalte Typ sehen Sie, was die Ausführung ausgelöst hat. Zu den Werten gehören:
- Add-on Die Ausführung stammt von einem Add-on.
- Execution API Die Ausführung stammte von einem Aufruf der Apps Script API.
- Zeitlich gesteuert Die Ausführung wurde durch ein Zeitereignis verursacht.
- Trigger Die Ausführung stammt aus einer Triggerquelle.
- Web-App Die Ausführung stammt aus einer bereitgestellten Webanwendung.
- Bearbeiter Die Ausführung stammt aus dem Apps Script-Editor.
Ausführungen beenden
Lang andauernde Ausführungen, die gerade ausgeführt werden, haben den Status „Wird ausgeführt“. Wenn Sie diese Ausführungen beenden möchten, klicken Sie rechts neben der Projektzeile auf das Dreipunkt-Menü > Beenden.
Einstellungen
Sie können die Dashboard-Einstellungen anpassen, indem Sie im linken Navigationsbereich Einstellungen auswählen.
Im Bereich Einstellungen gibt es eine Ein/Aus-Schaltfläche für die Apps Script API. So können Sie der API Zugriff auf Ihre Script-Projekte gewähren.
Klicken Sie dazu im Bereich Einstellungen auf das Label Google Apps Script API. Daraufhin wird ein neuer Bereich mit Warntext und einem Ein-/Aus-Schalter geöffnet. Der Zugriff auf Ihre Scriptprojekte ist standardmäßig ausgeschaltet, um die Sicherheit zu erhöhen. Sobald Sie den Zugriff gewährt haben, kann jede von Ihnen autorisierte Drittanbieteranwendung Ihre Scripts und Bereitstellungen mithilfe der API ändern. Sie können diesen Zugriff jederzeit in den Einstellungen widerrufen.
Weitere Informationen finden Sie im Leitfaden zum Zugriff auf die Apps Script API.