REST Resource: processes

Ressource: Prozess

Darstellung einer einzelnen Skriptausführung, die über den Script-Editor, einen Trigger, eine Anwendung oder die Apps Script API gestartet wurde. Dies unterscheidet sich von der Operation-Ressource, die nur Ausführungen darstellt, die über die Apps Script API gestartet wurden.

JSON-Darstellung
{
  "projectName": string,
  "functionName": string,
  "processType": enum (ProcessType),
  "processStatus": enum (ProcessStatus),
  "userAccessLevel": enum (UserAccessLevel),
  "startTime": string,
  "duration": string
}
Felder
projectName

string

Name des ausgeführten Skripts.

functionName

string

Name der Funktion, mit der die Ausführung gestartet wurde.

processType

enum (ProcessType)

Der Ausführungstyp.

processStatus

enum (ProcessStatus)

Der Ausführungsstatus.

userAccessLevel

enum (UserAccessLevel)

Die Zugriffsebene der ausführenden Nutzer für das Skript.

startTime

string (Timestamp format)

Zeitpunkt, zu dem die Ausführung gestartet wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

duration

string (Duration format)

Dauer der Ausführung für die Ausführung.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

ProcessType

Die Art des Prozesses, der definiert, wie der Prozess gestartet wurde.

Enums
PROCESS_TYPE_UNSPECIFIED Nicht definierter Typ.
ADD_ON Der Prozess wurde von einem Add-on-Einstiegspunkt aus gestartet.
EXECUTION_API Der Prozess wurde mit der Apps Script API gestartet.
TIME_DRIVEN Der Prozess wurde über einen zeitbasierten Trigger gestartet.
TRIGGER Der Prozess wurde über einen ereignisbasierten Trigger gestartet.
WEBAPP Der Prozess wurde von einem Einstiegspunkt für die Web-App aus gestartet.
EDITOR Der Prozess wurde mit der Apps Script-IDE gestartet.
SIMPLE_TRIGGER Der Prozess wurde über einen einfachen G Suite-Trigger gestartet.
MENU Der Prozess wurde über einen G Suite-Menüpunkt gestartet.
BATCH_TASK Der Prozess wurde als Aufgabe in einem Batchjob gestartet.

ProcessStatus

Der Prozessstatus.

Enums
PROCESS_STATUS_UNSPECIFIED Unbekannter Status.
RUNNING Der Prozess wird gerade ausgeführt.
PAUSED Der Prozess wurde pausiert.
COMPLETED Der Vorgang ist abgeschlossen.
CANCELED Der Vorgang wurde abgebrochen.
FAILED Der Vorgang ist fehlgeschlagen.
TIMED_OUT Zeitüberschreitung beim Vorgang.
UNKNOWN Prozessstatus unbekannt.
DELAYED Der Prozess verzögert sich. Es wird auf ein Kontingent gewartet.

UserAccessLevel

Die verschiedenen Zugriffsebenen für Nutzer.

Enums
USER_ACCESS_LEVEL_UNSPECIFIED Nutzerzugriffsebene nicht angegeben
NONE Der Nutzer hat keinen Zugriff.
READ Der Nutzer hat nur Lesezugriff.
WRITE Der Nutzer hat Schreibzugriff.
OWNER Der Nutzer ist ein Inhaber.

Methoden

list

Informationen zu Prozessen auflisten, die von oder im Auftrag eines Nutzers durchgeführt wurden, z. B. Prozesstyp und aktueller Status.

listScriptProcesses

Listet Informationen zu den ausgeführten Prozessen eines Skripts auf, z. B. Prozesstyp und aktuellen Status.