REST Resource: processes
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Resource: Proses
Representasi satu eksekusi proses skrip yang dimulai dari editor skrip, pemicu, aplikasi, atau menggunakan Apps Script API. Hal ini berbeda dengan resource Operation
| Representasi JSON |
{
"projectName": string,
"functionName": string,
"processType": enum (ProcessType),
"processStatus": enum (ProcessStatus),
"userAccessLevel": enum (UserAccessLevel),
"startTime": string,
"duration": string
} |
| Kolom |
projectName |
string
Nama skrip yang sedang dieksekusi.
|
functionName |
string
Nama fungsi yang memulai eksekusi.
|
processType |
enum (ProcessType)
Jenis eksekusi.
|
processStatus |
enum (ProcessStatus)
Status eksekusi.
|
userAccessLevel |
enum (UserAccessLevel)
Tingkat akses pengguna yang mengeksekusi ke skrip.
|
startTime |
string (Timestamp format)
Waktu eksekusi dimulai. Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
|
duration |
string (Duration format)
Durasi eksekusi yang dihabiskan untuk eksekusi. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
|
ProcessType
Jenis proses, yang menentukan bagaimana proses dimulai.
| Enum |
PROCESS_TYPE_UNSPECIFIED |
Jenis tidak ditentukan. |
ADD_ON |
Proses ini dimulai dari titik entri add-on. |
EXECUTION_API |
Proses dimulai menggunakan Apps Script API. |
TIME_DRIVEN |
Proses dimulai dari pemicu berbasis waktu. |
TRIGGER |
Proses dimulai dari pemicu berbasis peristiwa. |
WEBAPP |
Proses ini dimulai dari titik entri aplikasi web. |
EDITOR |
Proses dimulai menggunakan Apps Script IDE. |
SIMPLE_TRIGGER |
Proses ini dimulai dari pemicu sederhana G Suite. |
BATCH_TASK |
Proses dimulai sebagai tugas dalam tugas batch. |
ProcessStatus
| Enum |
PROCESS_STATUS_UNSPECIFIED |
Status belum ditentukan. |
RUNNING |
Proses sedang berjalan. |
PAUSED |
Proses telah dijeda. |
COMPLETED |
Proses telah selesai. |
CANCELED |
Proses dibatalkan. |
FAILED |
Proses gagal. |
TIMED_OUT |
Waktu proses habis. |
UNKNOWN |
Status proses tidak diketahui. |
DELAYED |
Proses tertunda, menunggu kuota. |
UserAccessLevel
Berbagai tingkat akses pengguna.
| Enum |
USER_ACCESS_LEVEL_UNSPECIFIED |
Tingkat akses pengguna belum ditetapkan |
NONE |
Pengguna tidak memiliki akses. |
READ |
Pengguna memiliki akses hanya baca. |
WRITE |
Pengguna memiliki akses tulis. |
OWNER |
Pengguna adalah pemilik. |
Metode |
|
|
Cantumkan informasi tentang proses yang dilakukan oleh atau atas nama pengguna, seperti jenis proses dan status saat ini. |
|
|
Mencantumkan informasi tentang proses yang dijalankan oleh skrip, seperti jenis proses dan status saat ini. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]
