Method: processes.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Cantumkan informasi tentang proses yang dilakukan oleh atau atas nama pengguna, seperti jenis proses dan status saat ini.
Permintaan HTTP
GET https://script.googleapis.com/v1/processes
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
| Parameter |
userProcessFilter |
object (ListUserProcessesFilter)
Filter yang digunakan untuk membatasi hasil daftar; hanya proses yang cocok
dengan kriteria filter yang dikembalikan.
|
pageSize |
integer
Jumlah maksimum proses yang ditampilkan per halaman hasil. Defaultnya adalah 50.
|
pageToken |
string
Token untuk melanjutkan permintaan daftar sebelumnya di halaman berikutnya. Respons ini harus ditetapkan ke nilai nextPageToken dari respons sebelumnya.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Respons dengan daftar resource Process.
| Representasi JSON |
{
"processes": [
{
object (Process)
}
],
"nextPageToken": string
} |
| Kolom |
processes[] |
object (Process)
Daftar proses yang cocok dengan parameter permintaan.
|
nextPageToken |
string
Token untuk halaman hasil berikutnya. Jika kosong, tidak ada lagi halaman yang tersisa.
|
Cakupan Otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/script.processes
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ListUserProcessesFilter
Filter digunakan untuk menentukan lebih lanjut proses mana yang akan dicantumkan. Hanya proses yang cocok dengan semua kondisi yang ditentukan yang akan ditampilkan.
| Representasi JSON |
{
"scriptId": string,
"deploymentId": string,
"projectName": string,
"functionName": string,
"startTime": string,
"endTime": string,
"types": [
enum (ProcessType)
],
"statuses": [
enum (ProcessStatus)
],
"userAccessLevels": [
enum (UserAccessLevel)
]
} |
| Kolom |
scriptId |
string
Kolom opsional yang digunakan untuk membatasi proses yang ditampilkan ke proses yang berasal dari project dengan ID skrip tertentu.
|
deploymentId |
string
Kolom opsional yang digunakan untuk membatasi proses yang ditampilkan ke proses yang berasal dari project dengan ID deployment tertentu.
|
projectName |
string
Kolom opsional yang digunakan untuk membatasi proses yang ditampilkan ke proses yang berasal dari project dengan nama project yang berisi string tertentu.
|
functionName |
string
Kolom opsional yang digunakan untuk membatasi proses yang ditampilkan ke proses yang berasal dari fungsi skrip dengan nama fungsi yang diberikan.
|
startTime |
string (Timestamp format)
Kolom opsional yang digunakan untuk membatasi proses yang ditampilkan ke proses yang dimulai pada atau setelah stempel waktu yang diberikan. 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".
|
endTime |
string (Timestamp format)
Kolom opsional yang digunakan untuk membatasi proses yang ditampilkan ke proses yang selesai pada atau sebelum stempel waktu yang diberikan. 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".
|
types[] |
enum (ProcessType)
Kolom opsional yang digunakan untuk membatasi proses yang ditampilkan bagi proses yang memiliki salah satu jenis proses yang ditentukan.
|
statuses[] |
enum (ProcessStatus)
Kolom opsional yang digunakan untuk membatasi proses yang ditampilkan bagi proses yang memiliki salah satu status proses yang ditentukan.
|
userAccessLevels[] |
enum (UserAccessLevel)
Kolom opsional yang digunakan untuk membatasi proses yang ditampilkan bagi proses yang memiliki salah satu tingkat akses pengguna yang ditentukan.
|
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\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. |"]]
