Method: processes.list
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
แสดงรายการข้อมูลเกี่ยวกับกระบวนการที่ดำเนินการโดยหรือในนามของผู้ใช้ เช่น ประเภทกระบวนการและสถานะปัจจุบัน
คำขอ HTTP
GET https://script.googleapis.com/v1/processes
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์การค้นหา
| พารามิเตอร์ |
userProcessFilter |
object (ListUserProcessesFilter)
ตัวกรองที่ใช้จำกัดรายการผลการค้นหา ระบบจะแสดงผลเฉพาะกระบวนการที่ตรงกับเกณฑ์ตัวกรองเท่านั้น
|
pageSize |
integer
จำนวนสูงสุดของกระบวนการที่แสดงผลต่อหน้าเว็บผลลัพธ์ ค่าเริ่มต้นคือ 50
|
pageToken |
string
โทเค็นสำหรับดำเนินการกับคำขอรายการก่อนหน้าต่อในหน้าถัดไป ควรตั้งค่านี้เป็นค่า nextPageToken จากคำตอบก่อนหน้า
|
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
ตอบกลับด้วยรายการทรัพยากร Process
| การแสดง JSON |
{
"processes": [
{
object (Process)
}
],
"nextPageToken": string
} |
| ช่อง |
processes[] |
object (Process)
รายการพารามิเตอร์คำขอที่ตรงกันของกระบวนการ
|
nextPageToken |
string
โทเค็นสำหรับหน้าถัดไป หากเว้นว่างไว้ ระบบจะไม่มีหน้าเหลืออยู่แล้ว
|
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/script.processes
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
ListUserProcessesFilter
ตัวกรองที่ใช้ระบุกระบวนการที่จะแสดงรายการเพิ่มเติม โดยจะแสดงเฉพาะกระบวนการที่ตรงกับเงื่อนไขที่ระบุทั้งหมดเท่านั้น
| การแสดง JSON |
{
"scriptId": string,
"deploymentId": string,
"projectName": string,
"functionName": string,
"startTime": string,
"endTime": string,
"types": [
enum (ProcessType)
],
"statuses": [
enum (ProcessStatus)
],
"userAccessLevels": [
enum (UserAccessLevel)
]
} |
| ช่อง |
scriptId |
string
ช่องที่ไม่บังคับซึ่งใช้เพื่อจำกัดกระบวนการแสดงผลสำหรับกระบวนการที่มาจากโปรเจ็กต์ที่มีรหัสสคริปต์เฉพาะ
|
deploymentId |
string
ช่องที่ไม่บังคับซึ่งใช้เพื่อจำกัดกระบวนการแสดงผลสำหรับกระบวนการที่มาจากโปรเจ็กต์ที่มีรหัสการทำให้ใช้งานได้ที่เจาะจง
|
projectName |
string
ช่องที่ไม่บังคับซึ่งใช้เพื่อจำกัดกระบวนการแสดงผลสำหรับกระบวนการที่มาจากโปรเจ็กต์ที่มีชื่อโปรเจ็กต์ที่มีสตริงที่ระบุ
|
functionName |
string
ช่องที่ไม่บังคับซึ่งใช้เพื่อจำกัดกระบวนการแสดงผลสำหรับกระบวนการที่มาจากฟังก์ชันสคริปต์ที่มีชื่อฟังก์ชันที่ระบุ
|
startTime |
string (Timestamp format)
ช่องที่ไม่บังคับซึ่งใช้เพื่อจำกัดกระบวนการแสดงผลที่เริ่มต้นในหรือหลังจากการประทับเวลาที่ระบุ การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
|
endTime |
string (Timestamp format)
ช่องที่ไม่บังคับซึ่งใช้เพื่อจำกัดกระบวนการที่ส่งกลับไปยังกระบวนการที่ดำเนินการเสร็จสิ้นในหรือก่อนการประทับเวลาที่ระบุ การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
|
types[] |
enum (ProcessType)
ช่องที่ไม่บังคับซึ่งใช้เพื่อจำกัดกระบวนการแสดงผลสำหรับผู้ที่มีประเภทกระบวนการที่ระบุอย่างใดอย่างหนึ่ง
|
statuses[] |
enum (ProcessStatus)
ช่องที่ไม่บังคับซึ่งใช้เพื่อจำกัดกระบวนการแสดงผลสำหรับการประมวลผลที่มีสถานะกระบวนการที่ระบุไว้อย่างใดอย่างหนึ่ง
|
userAccessLevels[] |
enum (UserAccessLevel)
ช่องที่ไม่บังคับซึ่งใช้เพื่อจำกัดกระบวนการแสดงผลสำหรับผู้ที่มีระดับการเข้าถึงของผู้ใช้ที่ระบุไว้เพียงระดับใดระดับหนึ่ง
|
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-26 UTC
[null,null,["อัปเดตล่าสุด 2025-07-26 UTC"],[[["\u003cp\u003eLists processes created by or for a user, including details like process type and status.\u003c/p\u003e\n"],["\u003cp\u003eUses the \u003ccode\u003eGET https://script.googleapis.com/v1/processes\u003c/code\u003e HTTP request, allowing filtering by various criteria such as script ID, deployment ID, and time range.\u003c/p\u003e\n"],["\u003cp\u003eResponses include a list of processes and a token for retrieving further pages of results if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/script.processes\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: processes.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListUserProcessesResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n- [ListUserProcessesFilter](#ListUserProcessesFilter)\n - [JSON representation](#ListUserProcessesFilter.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nList information about processes made by or on behalf of a user, such as process type and current status.\n\n### HTTP request\n\n`GET https://script.googleapis.com/v1/processes`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|---------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `userProcessFilter` | `object (`[ListUserProcessesFilter](/apps-script/api/reference/rest/v1/processes/list#ListUserProcessesFilter)`)` A filter used to limit the list results; only processes matching the filter criteria are returned. |\n| `pageSize` | `integer` The maximum number of returned processes per page of results. Defaults to 50. |\n| `pageToken` | `string` The token for continuing a previous list request on the next page. This should be set to the value of `nextPageToken` from a previous response. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse with the list of [Process](/apps-script/api/reference/rest/v1/processes#Process) resources.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"processes\": [ { object (/apps-script/api/reference/rest/v1/processes#Process) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------|\n| `processes[]` | `object (`[Process](/apps-script/api/reference/rest/v1/processes#Process)`)` List of processes matching request parameters. |\n| `nextPageToken` | `string` Token for the next page of results. If empty, there are no more pages remaining. |\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/script.processes`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nListUserProcessesFilter\n-----------------------\n\nFilter used to further specify which processes to list. Only processes that match all the specified conditions are returned.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"scriptId\": string, \"deploymentId\": string, \"projectName\": string, \"functionName\": string, \"startTime\": string, \"endTime\": string, \"types\": [ enum (/apps-script/api/reference/rest/v1/processes#ProcessType) ], \"statuses\": [ enum (/apps-script/api/reference/rest/v1/processes#ProcessStatus) ], \"userAccessLevels\": [ enum (/apps-script/api/reference/rest/v1/processes#UserAccessLevel) ] } ``` |\n\n| Fields ||\n|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `scriptId` | `string` Optional field used to limit returned processes to those originating from projects with a specific script ID. |\n| `deploymentId` | `string` Optional field used to limit returned processes to those originating from projects with a specific deployment ID. |\n| `projectName` | `string` Optional field used to limit returned processes to those originating from projects with project names containing a specific string. |\n| `functionName` | `string` Optional field used to limit returned processes to those originating from a script function with the given function name. |\n| `startTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Optional field used to limit returned processes to those that were started on or after the given timestamp. 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| `endTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Optional field used to limit returned processes to those that completed on or before the given timestamp. 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| `types[]` | `enum (`[ProcessType](/apps-script/api/reference/rest/v1/processes#ProcessType)`)` Optional field used to limit returned processes to those having one of the specified process types. |\n| `statuses[]` | `enum (`[ProcessStatus](/apps-script/api/reference/rest/v1/processes#ProcessStatus)`)` Optional field used to limit returned processes to those having one of the specified process statuses. |\n| `userAccessLevels[]` | `enum (`[UserAccessLevel](/apps-script/api/reference/rest/v1/processes#UserAccessLevel)`)` Optional field used to limit returned processes to those having one of the specified user access levels. |"]]
