Über das Apps Script-Dashboard können Sie Ihre Apps Script-Projekte verwalten und überwachen. Mit dem Dashboard können Sie Folgendes tun:
- Vorhandene Apps Script-Projekte aufrufen und nach ihnen suchen, einschließlich gebundener Skripts, die anGoogle Workspace -Dokumente angehängt sind
- Neue Projekte erstellen
- Sehen Sie sich Details zu Ihren Projekten an, z. B. die verwendeten OAuth-Bereiche.
- Überwachen Sie den Zustand und die Nutzung Ihrer Skriptprojekte.
- Sehen Sie sich die Ausführungsprotokolle für Ihre Projekte 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 Apps über die API mit Ihren Skriptprojekten interagieren.
Projekte ansehen und suchen
Im Apps Script-Dashboard werden alle Skriptprojekte aufgelistet, die Sie aufrufen oder bearbeiten können. Im linken Navigationsbereich des Dashboards werden diese Projekte in die folgenden 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 können. Klicken Sie zur Anzeige der Details zu einem Projekt auf die entsprechende Zeile in der Projektliste.
Die Projektdetailansicht zeigt Daten und Diagramme zu Fehlerrate, Ausführungen und Nutzer zum Projekt sowie die OAuth-Bereiche, die von jedem Endnutzer angefordert werden, der das Projekt verwendet. Die Datenmesswerte sind wie folgt definiert:
- Fehlerrate: Der Prozentsatz der Ausführungen, die aufgrund nicht erfasster Ausnahmen nicht ausgeführt werden konnten. Zur Berechnung dieses Werts wird die Anzahl der fehlgeschlagenen Ausführungen geteilt durch die Gesamtzahl der Ausführungen im definierten Zeitraum.
- Ausführungen. Die Häufigkeit, mit der ein Projekt „ausgeführt“ oder 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 mindestens einmal ausgeführt haben. Anonyme Nutzer werden nicht erfasst und daher nicht in der Nutzeranzahl oder in den Grafiken berücksichtigt.
Jede Bereitstellung Ihres Projekts wird auf der Seite Projektdetails über den Daten und Grafiken als Tab 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 von 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. Wenn Sie Projekte als Lesezeichen speichern möchten, können Sie sie markieren. Durch Markieren von Projekten können Sie außerdem zusammengefasste Nutzungs- und Fehlerratenstatistiken sowie Diagramme zu diesen Projekten überwachen.
Klicken Sie zum Markieren eines Projekts rechts neben einer Projektzeile auf das Dreipunkt-Menü > Markierung hinzufügen. Sie können ein Projekt auch markieren, indem Sie in der Ansicht der Projektdetails auf das Dreipunkt-Menü klicken.
Im linken Navigationsbereich können Sie Markierte Projekte auswählen, um die Projekte anzuzeigen, 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 zu sehen.
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
Auf dem 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, wenn Sie im linken Navigationsbereich die Option My Executions (Meine Ausführungen) auswählen.
Im Bereich My Executions (Meine Ausführungen) wird standardmäßig ein Protokoll aller vorherigen und derzeit ausgeführten 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. von Ihnen installierte und ausgeführte Add-ons). 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 steuern, welche Art von Ausführung im Log gemeldet wird. Jede Zeile des Logs steht für eine einzelne Ausführung. Die Spalten Start Time (Startzeit), Duration (Dauer) und Status (Status) enthalten die entsprechenden Informationen zur Ausführung.
In der Spalte Funktion wird der Name der Funktion angezeigt, die die Ausführung initiiert hat. Diese Spalte enthält keinen Namen, 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, was die Ausführung ausgelöst hat. Zu den Werten gehören:
- Add-on. Die Ausführung erfolgte über ein Add-on.
- Execution API Die Ausführung erfolgte durch einen Aufruf der Apps Script API.
- Time Driven (Zeitgesteuert). Die Ausführung wurde durch ein Zeitereignis ausgelöst.
- Trigger Die Ausführung erfolgte über eine Triggerquelle.
- Web-App: Die Ausführung erfolgte über eine bereitgestellte Webanwendung.
- Bearbeiter: Die Ausführung erfolgte im Apps Script-Editor.
Ausführungen beenden
Lang andauernde Ausführungen, die gerade ausgeführt werden, werden durch den Status „Wird ausgeführt“ angezeigt. Wenn Sie diese Ausführung 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 befindet sich eine Ein/Aus-Schaltfläche für die Apps Script API. Dadurch 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. Dadurch wird ein neues Feld mit Warnung und einem Umschalter geöffnet. Der Zugriff auf Ihre Skriptprojekte ist aus Sicherheitsgründen standardmäßig deaktiviert. Nachdem Sie den Zugriff gewährt haben, kann jede von Ihnen autorisierte Drittanbieteranwendung die API verwenden, um Ihre Skripts und Bereitstellungen zu ändern. Sie können diesen Zugriff jederzeit im Bereich Einstellungen widerrufen.
Weitere Informationen finden Sie im Zugriffsleitfaden für die Apps Script API.