REST Resource: processes
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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
| 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. |
BATCH_TASK |
Der Prozess wurde als Aufgabe in einem Batchjob gestartet. |
ProcessStatus
| 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 |
|
|
Informationen zu Prozessen auflisten, die von oder im Auftrag eines Nutzers durchgeführt wurden, z. B. Prozesstyp und aktueller Status. |
|
|
Listet Informationen zu den ausgeführten Prozessen eines Skripts auf, z. B. Prozesstyp und aktuellen Status. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003eThe \u003ccode\u003eProcess\u003c/code\u003e resource represents a single script execution initiated from various sources like the script editor, triggers, applications, or the Apps Script API.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eProcess\u003c/code\u003e details include project and function names, execution type, status, user access level, start time, and duration.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eProcessType\u003c/code\u003e identifies how the process was started (e.g., add-on, API, trigger, web app).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eProcessStatus\u003c/code\u003e indicates the current state of the execution (e.g., running, paused, completed, failed).\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can programmatically list processes using methods like \u003ccode\u003elist\u003c/code\u003e and \u003ccode\u003elistScriptProcesses\u003c/code\u003e to gain insights into executions.\u003c/p\u003e\n"]]],[],null,["# REST Resource: processes\n\n- [Resource: Process](#Process)\n - [JSON representation](#Process.SCHEMA_REPRESENTATION)\n- [ProcessType](#ProcessType)\n- [ProcessStatus](#ProcessStatus)\n- [UserAccessLevel](#UserAccessLevel)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Process\n-----------------\n\nRepresentation of a single script process execution that was started from the script editor, a trigger, an application, or using the Apps Script API. This is distinct from the [`Operation`](/apps-script/api/reference/rest/v1/scripts/run#body.Operation) resource, which only represents executions started via the Apps Script API.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"projectName\": string, \"functionName\": string, \"processType\": enum (/apps-script/api/reference/rest/v1/processes#ProcessType), \"processStatus\": enum (/apps-script/api/reference/rest/v1/processes#ProcessStatus), \"userAccessLevel\": enum (/apps-script/api/reference/rest/v1/processes#UserAccessLevel), \"startTime\": string, \"duration\": string } ``` |\n\n| Fields ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `projectName` | `string` Name of the script being executed. |\n| `functionName` | `string` Name of the function the started the execution. |\n| `processType` | `enum (`[ProcessType](/apps-script/api/reference/rest/v1/processes#ProcessType)`)` The executions type. |\n| `processStatus` | `enum (`[ProcessStatus](/apps-script/api/reference/rest/v1/processes#ProcessStatus)`)` The executions status. |\n| `userAccessLevel` | `enum (`[UserAccessLevel](/apps-script/api/reference/rest/v1/processes#UserAccessLevel)`)` The executing users access level to the script. |\n| `startTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Time the execution started. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `duration` | `string (`[Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration)` format)` Duration the execution spent executing. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n\nProcessType\n-----------\n\nThe type of process, which defines how the process was started.\n\n| Enums ||\n|----------------------------|--------------------------------------------------------|\n| `PROCESS_TYPE_UNSPECIFIED` | Unspecified type. |\n| `ADD_ON` | The process was started from an add-on entry point. |\n| `EXECUTION_API` | The process was started using the Apps Script API. |\n| `TIME_DRIVEN` | The process was started from a time-based trigger. |\n| `TRIGGER` | The process was started from an event-based trigger. |\n| `WEBAPP` | The process was started from a web app entry point. |\n| `EDITOR` | The process was started using the Apps Script IDE. |\n| `SIMPLE_TRIGGER` | The process was started from a G Suite simple trigger. |\n| `MENU` | The process was started from a G Suite menu item. |\n| `BATCH_TASK` | The process was started as a task in a batch job. |\n\nProcessStatus\n-------------\n\nThe process status.\n\n| Enums ||\n|------------------------------|--------------------------------------------|\n| `PROCESS_STATUS_UNSPECIFIED` | Unspecified status. |\n| `RUNNING` | The process is currently running. |\n| `PAUSED` | The process has paused. |\n| `COMPLETED` | The process has completed. |\n| `CANCELED` | The process was cancelled. |\n| `FAILED` | The process failed. |\n| `TIMED_OUT` | The process timed out. |\n| `UNKNOWN` | Process status unknown. |\n| `DELAYED` | The process is delayed, waiting for quota. |\n\nUserAccessLevel\n---------------\n\nThe various user access levels.\n\n| Enums ||\n|---------------------------------|--------------------------------|\n| `USER_ACCESS_LEVEL_UNSPECIFIED` | User access level unspecified |\n| `NONE` | The user has no access. |\n| `READ` | The user has read-only access. |\n| `WRITE` | The user has write access. |\n| `OWNER` | The user is an owner. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------|\n| ### [list](/apps-script/api/reference/rest/v1/processes/list) | List information about processes made by or on behalf of a user, such as process type and current status. |\n| ### [listScriptProcesses](/apps-script/api/reference/rest/v1/processes/listScriptProcesses) | List information about a script's executed processes, such as process type and current status. |"]]
