REST Resource: processes
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المرجع: العملية
تمثيل لعملية تنفيذ واحدة للنصوص البرمجية تم بدؤها من مُحرِّر النصوص البرمجية، أو مُشغِّل، أو تطبيق، أو باستخدام واجهة برمجة التطبيقات لبرمجة التطبيقات. ويختلف هذا المورد عن مورد Operation
| تمثيل JSON |
{
"projectName": string,
"functionName": string,
"processType": enum (ProcessType),
"processStatus": enum (ProcessStatus),
"userAccessLevel": enum (UserAccessLevel),
"startTime": string,
"duration": string
} |
| الحقول |
projectName |
string
اسم النص البرمجي الذي يتم تنفيذه.
|
functionName |
string
اسم الدالة التي بدأت عملية التنفيذ
|
processType |
enum (ProcessType)
نوع عمليات التنفيذ
|
processStatus |
enum (ProcessStatus)
حالة عمليات التنفيذ.
|
userAccessLevel |
enum (UserAccessLevel)
مستوى وصول المستخدمين الذين يتم تنفيذه إلى النص البرمجي
|
startTime |
string (Timestamp format)
وقت بدء التنفيذ طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
|
duration |
string (Duration format)
المدة التي استغرقها التنفيذ في التنفيذ. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"
|
ProcessType
نوع العملية الذي يحدد كيفية بدء العملية.
| عمليات التعداد |
PROCESS_TYPE_UNSPECIFIED |
نوع غير محدَّد. |
ADD_ON |
تم بدء العملية من نقطة دخول إضافية. |
EXECUTION_API |
تم بدء العملية باستخدام واجهة برمجة التطبيقات لبرمجة التطبيقات. |
TIME_DRIVEN |
بدأت العملية من مشغّل مستند إلى الوقت. |
TRIGGER |
تم بدء العملية من عامل تشغيل مستند إلى الأحداث. |
WEBAPP |
بدأت العملية من نقطة دخول لتطبيق الويب. |
EDITOR |
تم بدء هذه العملية باستخدام بيئة التطوير المتكاملة لبرمجة التطبيقات. |
SIMPLE_TRIGGER |
بدأت العملية من مشغِّل بسيط في G Suite. |
BATCH_TASK |
بدأت العملية كمهمة في مجموعة. |
ProcessStatus
| عمليات التعداد |
PROCESS_STATUS_UNSPECIFIED |
حالة غير محدّدة |
RUNNING |
هذه العملية قيد التشغيل حاليًا. |
PAUSED |
تم إيقاف العملية مؤقتًا. |
COMPLETED |
اكتملت العملية. |
CANCELED |
تم إلغاء العملية. |
FAILED |
تعذّر إتمام العملية. |
TIMED_OUT |
انتهت مهلة العملية. |
UNKNOWN |
حالة العملية غير معروفة. |
DELAYED |
يتم تأخير العملية، وهي بانتظار الحصة. |
UserAccessLevel
مستويات وصول المستخدم المختلفة.
| عمليات التعداد |
USER_ACCESS_LEVEL_UNSPECIFIED |
لم يتم تحديد مستوى وصول المستخدم. |
NONE |
لا يملك المستخدِم إذن الوصول. |
READ |
يتوفّر لدى المستخدم إذن بالقراءة فقط. |
WRITE |
لدى المستخدم إذن وصول للكتابة. |
OWNER |
يكون المستخدِم مالكًا. |
الطُرق |
|
|
إدراج معلومات عن العمليات التي يجريها المستخدم أو نيابةً عنه، مثل نوع العملية والحالة الحالية |
|
|
سرد معلومات عن العمليات التي تم تنفيذها للنص البرمجي، مثل نوع العملية والحالة الحالية |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
