Im Apps Script-Dashboard können Sie Ihre Apps Script-Projekte verwalten und überwachen. Sie können das Dashboard für folgende Aufgaben verwenden:
- Hier können Sie sich Ihre vorhandenen Apps Script-Projekte ansehen und danach suchen, einschließlich gebundener Skripts, die anGoogle Workspace -Dokumente angehängt sind.
- Neue Projekte erstellen
- Rufen Sie Details zu Ihren Projekten auf, z. B. die verwendeten OAuth-Bereiche.
- Status und Nutzung Ihrer Skriptprojekte überwachen
- Sehen Sie sich Ausführungslogs für Ihre und andere Projekte an, die mit den Anmeldedaten Ihres Kontos ausgeführt werden.
- Aktivieren oder deaktivieren Sie die Apps Script API, um zuzulassen oder zu verhindern, dass Anwendungen die API verwenden, um mit Ihren Skriptprojekten zu interagieren.
Projekte ansehen und suchen
Im Apps Script-Dashboard sind alle Skriptprojekte aufgelistet, die Sie ansehen oder bearbeiten können. In der linken Navigationsleiste des Dashboards sind diese Projekte in folgende Kategorien unterteilt:
- Markierte Projekte: Projekte, die Sie monitoring
- Meine Projekte. Projekte, deren Inhaber Sie sind.
- Alle Projekte: Projekte, deren Inhaber Sie sind oder für die Sie Lese- oder Bearbeitungsberechtigungen haben.
- 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
Die Projektlisten enthalten den Projektnamen, den Inhaber und das Datum der letzten Änderung. Die Symbole neben dem Projektnamen geben an, ob das Projekt ein eigenständiges Projekt oder ein gebundenes Projekt ist.
Projektdetails ansehen
Jedes Projekt enthält eine Ansicht, in der Entwicklerdetails zum Projekt angezeigt werden. Klicken Sie auf die Zeile in der Projektliste, um die Details zu einem Projekt aufzurufen.
In der Projektdetailansicht werden Daten zu Fehlerraten, Ausführungen und Nutzer zum Projekt sowie zu den OAuth-Bereichen angezeigt, die von Endnutzern angefordert wurden, die das Projekt verwenden. Die Datenmesswerte sind so definiert:
- Fehlerrate: Der Prozentsatz der Ausführungen, die aufgrund nicht erfasster Ausnahmen nicht ausgeführt werden konnten. Er wird berechnet, indem die Anzahl der fehlgeschlagenen Ausführungen durch die Gesamtzahl der Ausführungen im festgelegten Zeitraum geteilt wird.
- Ausführungen. Die Häufigkeit, mit der ein Projekt ausgeführt oder ausgeführt wurde. Weitere Informationen zur Ausführung eines Projekts finden Sie unter Ausführungstypen.
- Nutzer: Die Anzahl der einzelnen Nutzer (Konten), die das Projekt im angegebenen Zeitraum mindestens einmal ausgeführt haben. Anonyme Nutzer werden nicht erfasst und daher nicht in der Nutzeranzahl oder den Grafiken widergespiegelt.
Jede Bereitstellung Ihres Projekts wird auf der Seite Projektdetails als Tab über den Daten und Grafiken angezeigt. Sie können den Tab auswählen, um die zugehörigen Daten für diese Bereitstellung zu sehen. Wenn Sie ALLE auswählen, werden aggregierte Daten für alle Bereitstellungen des Projekts und aus Ausführungen angezeigt, die von Entwicklern stammen, die das Projekt über den Apps Script-Codeeditor ausführen.
Projekte überwachen
Möglicherweise haben Sie Zugriff auf deutlich mehr Apps Script-Projekte, als Sie regelmäßig verwenden oder verwalten. Sie können Projekte markieren, um sie als Lesezeichen zu speichern. Durch das Markieren von Projekten können Sie außerdem Nutzungs- und Fehlerratenstatistiken und Grafiken zu diesen Projekten überwachen.
Wenn Sie ein Projekt markieren möchten, klicken Sie rechts in einer Projektzeile auf das Dreipunkt-Menü > Markierung hinzufügen. Sie können ein Projekt auch markieren, indem Sie in den Projektdetails auf das Dreipunkt-Menü klicken.
Wenn Sie im linken Navigationsbereich Markierte Projekte auswählen, sehen Sie die Projekte, 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 Grafiken für alle markierten Projekte der letzten 7 Tage aufzurufen.
Sie können eine Markierung aus einem Projekt entfernen, indem Sie in der entsprechenden Projektzeile auf das Dreipunkt-Menü klicken und Markierung 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 Log der letzten Ausführungen finden Sie, indem Sie im linken Navigationsbereich das Element My Executions auswählen.
Im Bereich My Executions (Meine Ausführungen) wird standardmäßig ein Log aller früheren 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). Die Ausführungsliste enthält nur die ursprüngliche Funktion, 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 steuern, welche Art von Ausführung im Log angezeigt wird. Jede Zeile des Logs 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. Wenn Sie keinen Zugriff auf das entsprechende Skriptprojekt der Ausführung haben, es aber in Ihrem Namen ausgeführt wurde, ist in dieser Spalte kein Name vorhanden.
In der Spalte Typ wird angezeigt, wodurch die Ausführung gestartet wurde. Zu den Werten gehören:
- Add-on: Die Ausführung stammt aus einem Add-on.
- Execution API: Die Ausführung stammt aus einem Aufruf der Apps Script API.
- Time Driven (Zeitgesteuert). Die Ausführung wurde durch ein Zeitereignis verursacht.
- Trigger Die Ausführung stammt aus einer Triggerquelle.
- Web-App: Die Ausführung stammt von einer bereitgestellten Webanwendung.
- Bearbeiter: Die Ausführung stammt aus dem Apps Script-Editor.
Ausführungen beenden
Laufende Ausführungen mit langer Ausführungszeit sind am Status „Wird ausgeführt“ zu erkennen. 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 finden Sie eine Ein-/Aus-Schaltfläche für die Apps Script API. Dadurch können Sie der API Zugriff auf Ihre Skriptprojekte gewähren.
Sie können auf diese Ein-/Aus-Schaltfläche zugreifen, indem Sie im Bereich Einstellungen auf das Label Google Apps Script API klicken. Dadurch wird ein neues Feld mit einem Warntext und einer Ein-/Aus-Schaltfläche geöffnet. Der Zugriff auf Ihre Skriptprojekte ist aus Sicherheitsgründen standardmäßig deaktiviert. Nachdem Sie den Zugriff gewährt haben, kann jede autorisierte Drittanwendung die API verwenden, um Ihre Skripts und Bereitstellungen zu ändern. Sie können diese Zugriffsberechtigung jederzeit in den Einstellungen widerrufen.
Weitere Informationen finden Sie im Zugriffsleitfaden für die Apps Script API.