Method: processes.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Elenca le informazioni sui processi eseguiti da o per conto di un utente, ad esempio il tipo di processo e lo stato attuale.
Richiesta HTTP
GET https://script.googleapis.com/v1/processes
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
Parametri |
userProcessFilter |
object (ListUserProcessesFilter )
Un filtro utilizzato per limitare i risultati dell'elenco. vengono restituiti solo i processi che corrispondono
ai criteri del filtro.
|
pageSize |
integer
Il numero massimo di processi restituiti per pagina di risultati. Il valore predefinito è 50.
|
pageToken |
string
Il token per continuare una richiesta di elenco precedente nella pagina successiva. Dovrebbe essere impostato sul valore nextPageToken di una risposta precedente.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Risposta con l'elenco di Process
risorse.
Rappresentazione JSON |
{
"processes": [
{
object (Process )
}
],
"nextPageToken": string
} |
Campi |
processes[] |
object (Process )
Elenco di processi corrispondenti ai parametri della richiesta.
|
nextPageToken |
string
Token per la pagina successiva dei risultati. Se è vuoto, non ci sono altre pagine rimanenti.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/script.processes
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
ListUserProcessesFilter
Filtro utilizzato per specificare ulteriormente quali processi elencare. Vengono restituiti solo i processi che soddisfano tutte le condizioni specificate.
Rappresentazione JSON |
{
"scriptId": string,
"deploymentId": string,
"projectName": string,
"functionName": string,
"startTime": string,
"endTime": string,
"types": [
enum (ProcessType )
],
"statuses": [
enum (ProcessStatus )
],
"userAccessLevels": [
enum (UserAccessLevel )
]
} |
Campi |
scriptId |
string
Campo facoltativo utilizzato per limitare i processi restituiti a quelli provenienti dai progetti con un ID script specifico.
|
deploymentId |
string
Campo facoltativo utilizzato per limitare i processi restituiti a quelli provenienti dai progetti con un ID deployment specifico.
|
projectName |
string
Campo facoltativo utilizzato per limitare i processi restituiti a quelli provenienti da progetti con nomi di progetto contenenti una stringa specifica.
|
functionName |
string
Campo facoltativo utilizzato per limitare i processi restituiti a quelli provenienti da una funzione di script con il nome della funzione specificato.
|
startTime |
string (Timestamp format)
Campo facoltativo utilizzato per limitare i processi restituiti a quelli avviati a partire dal timestamp specificato. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z" .
|
endTime |
string (Timestamp format)
Campo facoltativo utilizzato per limitare i processi restituiti a quelli completati entro il timestamp specificato. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z" .
|
types[] |
enum (ProcessType )
Campo facoltativo utilizzato per limitare i processi restituiti a quelli che presentano uno dei tipi di processi specificati.
|
statuses[] |
enum (ProcessStatus )
Campo facoltativo utilizzato per limitare i processi restituiti a quelli con uno degli stati di processo specificati.
|
userAccessLevels[] |
enum (UserAccessLevel )
Campo facoltativo utilizzato per limitare i processi restituiti a quelli che hanno uno dei livelli di accesso utente specificati.
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]