REST Resource: processes

Ressource: Verarbeiten

Darstellung der Ausführung eines einzelnen Skriptprozesses, die über den Script-Editor, einen Trigger, eine Anwendung oder über die Apps Script API gestartet wurde. Dies unterscheidet sich von der Ressource Operation, 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 Skripts, das ausgeführt wird.

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 des ausführenden Nutzers für das Skript.

startTime

string (Timestamp format)

Zeitpunkt, zu dem die Ausführung gestartet wurde.

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

duration

string (Duration format)

Dauer, die für die Ausführung benötigt wurde.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. 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 über einen Add-on-Einstiegspunkt 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 über einen Einstiegspunkt für eine Web-App gestartet.
EDITOR Der Prozess wurde mit der Apps Script-IDE gestartet.
SIMPLE_TRIGGER Der Prozess wurde mit einem 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

Prozessstatus

Enums
PROCESS_STATUS_UNSPECIFIED Nicht angegebener Status.
RUNNING Der Prozess wird derzeit ausgeführt.
PAUSED Der Prozess wurde angehalten.
COMPLETED Der Vorgang ist abgeschlossen.
CANCELED Der Vorgang wurde abgebrochen.
FAILED Der Vorgang ist fehlgeschlagen.
TIMED_OUT Zeitüberschreitung beim Prozess.
UNKNOWN Prozessstatus unbekannt.
DELAYED Der Vorgang verzögert sich und es wird auf das Kontingent gewartet.

UserAccessLevel

Verschiedene Zugriffsebenen

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 Inhaber.

Methoden

list

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

listScriptProcesses

Informationen zu den durch ein Skript ausgeführten Prozessen auflisten, z. B. den Prozesstyp und den aktuellen Status.