Das Apps Script-Dashboard

Ü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
  • Sie können Details zu Ihren Projekten aufrufen, z. B. die verwendeten OAuth-Bereiche.
  • Überwachen Sie den Zustand und die Nutzung Ihrer Scriptprojekte.
  • 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 suchen

Im Apps Script-Dashboard werden alle Skriptprojekte aufgelistet, die Sie aufrufen 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, 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 es sich um ein eigenständiges oder ein gebundenes Projekt handelt.

Projektdetails ansehen

Jedes Projekt enthält eine Ansicht mit Entwicklerdetails zum Projekt. Klicken Sie in der Projektliste auf die Zeile, um die Details zu einem Projekt aufzurufen.

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 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 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 Als Favoriten markierte 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 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. 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 wird angezeigt, was die Ausführung ausgelöst hat. Zu den Werten gehören:

  • Add-on (Add-on) Die Ausführung stammt von einem Add-on.
  • Execution API Die Ausführung stammte von 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.
  • Webapp 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, werden durch den Status „Läuft“ angezeigt. 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 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 dazu im Bereich Einstellungen auf das Label Google Apps Script API. Dadurch wird ein neues Feld mit Warntext und einem Umschalter geöffnet. Der Zugriff auf Ihre Skriptprojekte ist aus Sicherheitsgründen standardmäßig deaktiviert. 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.