REST Resource: processes
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: 프로세스
스크립트 편집기, 트리거, 애플리케이션 또는 Apps Script API를 사용하여 시작된 단일 스크립트 프로세스 실행을 나타냅니다. Apps Script API를 통해 시작된 실행만 나타내는 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 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
|
duration |
string (Duration format)
실행에 사용된 기간입니다. 소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
|
ProcessType
프로세스가 시작된 방법을 정의하는 프로세스 유형입니다.
| 열거형 |
PROCESS_TYPE_UNSPECIFIED |
알 수 없는 유형. |
ADD_ON |
이 프로세스는 부가기능 진입점에서 시작되었습니다. |
EXECUTION_API |
이 프로세스는 Apps Script API를 사용하여 시작되었습니다. |
TIME_DRIVEN |
프로세스가 시간 기반 트리거에서 시작되었습니다. |
TRIGGER |
프로세스가 이벤트 기반 트리거에서 시작되었습니다. |
WEBAPP |
프로세스가 웹 앱 진입점에서 시작되었습니다. |
EDITOR |
이 프로세스는 Apps Script IDE를 사용하여 시작되었습니다. |
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 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 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. |"]]
