Method: processes.list
संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
किसी उपयोगकर्ता ने जो प्रोसेस शुरू की है या उसकी ओर से कौनसी प्रोसेस की गई है उसकी जानकारी दें. जैसे, प्रोसेस का टाइप और मौजूदा स्थिति.
एचटीटीपी अनुरोध
GET https://script.googleapis.com/v1/processes
यह यूआरएल 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)
वैकल्पिक फ़ील्ड, लौटाए गए उन प्रोसेस को सीमित करता है जो दिए गए टाइमस्टैंप पर या उसके बाद शुरू हुई थीं. आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z" .
|
endTime |
string (Timestamp format)
यह फ़ील्ड ज़रूरी नहीं है. इसका इस्तेमाल, लौटाए गए उन प्रोसेस को सीमित करने के लिए किया जाता है जो दिए गए टाइमस्टैंप पर या उससे पहले पूरी हुई थीं. आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z" .
|
types[] |
enum (ProcessType )
वैकल्पिक फ़ील्ड, लौटाए गए प्रोसेस को उन प्रोसेस तक सीमित करता है जिनमें कोई एक प्रोसेस टाइप हो.
|
statuses[] |
enum (ProcessStatus )
वैकल्पिक फ़ील्ड, जिसका इस्तेमाल लौटाए जाने वाले प्रोसेस को उन प्रोसेस तक सीमित करने के लिए किया जाता है जिनकी प्रोसेस की खास स्थितियों में से कोई एक हो.
|
userAccessLevels[] |
enum (UserAccessLevel )
वैकल्पिक फ़ील्ड, लौटाए गए प्रोसेस को सिर्फ़ उन प्रोसेस को सीमित करने के लिए इस्तेमाल किया जाता है जिनके पास कोई खास उपयोगकर्ता ऐक्सेस लेवल होता है.
|
जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को Creative Commons Attribution 4.0 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.
आखिरी बार 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. |"]]