REST Resource: processes
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: İşlem
Komut dosyası düzenleyici, tetikleyici, uygulama veya Apps Komut Dosyası API'si kullanılarak başlatılan tek bir komut dosyası işlemi yürütmesinin temsili. Bu, yalnızca Apps Komut Dosyası API'si aracılığıyla başlatılan yürütmeleri temsil eden Operation
kaynağından farklıdır.
JSON gösterimi |
{
"projectName": string,
"functionName": string,
"processType": enum (ProcessType ),
"processStatus": enum (ProcessStatus ),
"userAccessLevel": enum (UserAccessLevel ),
"startTime": string,
"duration": string
} |
Alanlar |
projectName |
string
Yürütülen komut dosyasının adı.
|
functionName |
string
Yürütmeyi başlatan fonksiyonun adı.
|
processType |
enum (ProcessType )
Yürütme türü.
|
processStatus |
enum (ProcessStatus )
Yürütme durumu.
|
userAccessLevel |
enum (UserAccessLevel )
Yürütülen kullanıcıların komut dosyasına erişim düzeyi.
|
startTime |
string (Timestamp format)
Yürütmenin başladığı zaman. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z" .
|
duration |
string (Duration format)
Yürütme işlemi için harcanan süre. En fazla dokuz kesir basamağı olan ve "s " ile biten, saniye cinsinden süre. Örnek: "3.5s" .
|
ProcessType
Sürecin türü ve sürecin nasıl başlatıldığını tanımlar.
Sıralamalar |
PROCESS_TYPE_UNSPECIFIED |
Tür belirtilmedi. |
ADD_ON |
İşlem, bir eklenti giriş noktasından başlatıldı. |
EXECUTION_API |
Süreç, Apps Komut Dosyası API'si kullanılarak başlatıldı. |
TIME_DRIVEN |
Süreç, zamana dayalı bir tetikleyiciden başlatıldı. |
TRIGGER |
İşlem, etkinliğe dayalı bir tetikleyiciden başlatıldı. |
WEBAPP |
İşlem, bir web uygulaması giriş noktasından başlatıldı. |
EDITOR |
İşlem, Apps Komut Dosyası IDE'si kullanılarak başlatıldı. |
SIMPLE_TRIGGER |
Bu işlem basit bir G Suite tetikleyicisiyle başlatıldı. |
BATCH_TASK |
İşlem, toplu işteki bir görev olarak başlatıldı. |
ProcessStatus
Sıralamalar |
PROCESS_STATUS_UNSPECIFIED |
Belirtilmemiş durum. |
RUNNING |
İşlem şu anda çalışıyor. |
PAUSED |
İşlem duraklatıldı. |
COMPLETED |
İşlem tamamlandı. |
CANCELED |
İşlem iptal edildi. |
FAILED |
İşlem başarısız oldu. |
TIMED_OUT |
İşlem zaman aşımına uğradı. |
UNKNOWN |
İşlem durumu bilinmiyor. |
DELAYED |
İşlem geciktiği için kota bekleniyor. |
UserAccessLevel
Çeşitli kullanıcı erişim düzeyleri.
Sıralamalar |
USER_ACCESS_LEVEL_UNSPECIFIED |
Kullanıcı erişim düzeyi belirtilmedi |
NONE |
Kullanıcının erişimi yok. |
READ |
Kullanıcı salt okuma erişimine sahiptir. |
WRITE |
Kullanıcının yazma erişimi vardır. |
OWNER |
Kullanıcı sahip. |
Yöntemler |
|
Bir kullanıcı tarafından veya kullanıcı adına yapılan işlemlerle ilgili bilgileri (ör. işlem türü ve mevcut durum) listeleyin. |
|
Komut dosyasının yürütülen işlemleri hakkındaki işlem türü ve mevcut durum gibi bilgileri listeleyin. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]