Method: processes.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Répertorier les informations sur les processus créés par ou au nom d'un utilisateur, telles que le type de processus et l'état actuel.
Requête HTTP
GET https://script.googleapis.com/v1/processes
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de requête
Paramètres |
userProcessFilter |
object (ListUserProcessesFilter )
Filtre utilisé pour limiter les résultats de la liste. seuls les processus correspondant
aux critères de filtrage sont renvoyés.
|
pageSize |
integer
Nombre maximal de processus renvoyés par page de résultats. La valeur par défaut est 50.
|
pageToken |
string
Jeton permettant de poursuivre une requête de liste précédente sur la page suivante. Il doit être défini sur la valeur de nextPageToken issue d'une réponse précédente.
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Réponse avec la liste des ressources Process
.
Représentation JSON |
{
"processes": [
{
object (Process )
}
],
"nextPageToken": string
} |
Champs |
processes[] |
object (Process )
Liste des processus correspondant aux paramètres de requête.
|
nextPageToken |
string
Jeton pour la page de résultats suivante. Si ce champ est vide, il ne reste aucune page.
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/script.processes
Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
ListUserProcessesFilter
Filtre utilisé pour spécifier plus précisément les processus à répertorier. Seuls les processus qui correspondent à toutes les conditions spécifiées sont renvoyés.
Représentation JSON |
{
"scriptId": string,
"deploymentId": string,
"projectName": string,
"functionName": string,
"startTime": string,
"endTime": string,
"types": [
enum (ProcessType )
],
"statuses": [
enum (ProcessStatus )
],
"userAccessLevels": [
enum (UserAccessLevel )
]
} |
Champs |
scriptId |
string
Champ facultatif utilisé pour limiter les processus renvoyés à ceux provenant de projets avec un ID de script spécifique.
|
deploymentId |
string
Champ facultatif utilisé pour limiter les processus renvoyés à ceux provenant de projets associés à un ID de déploiement spécifique.
|
projectName |
string
Champ facultatif utilisé pour limiter les processus renvoyés à ceux provenant de projets dont les noms de projet contiennent une chaîne spécifique.
|
functionName |
string
Champ facultatif utilisé pour limiter les processus renvoyés à ceux provenant d'une fonction de script ayant le nom de fonction donné.
|
startTime |
string (Timestamp format)
Champ facultatif utilisé pour limiter les processus renvoyés à ceux qui ont démarré le ou après l'horodatage donné. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z" .
|
endTime |
string (Timestamp format)
Champ facultatif utilisé pour limiter les processus renvoyés à ceux qui se sont terminés le ou avant l'horodatage donné. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z" .
|
types[] |
enum (ProcessType )
Champ facultatif utilisé pour limiter les processus renvoyés à ceux ayant l'un des types de processus spécifiés.
|
statuses[] |
enum (ProcessStatus )
Champ facultatif permettant de limiter les processus renvoyés à ceux ayant l'un des états de processus spécifiés.
|
userAccessLevels[] |
enum (UserAccessLevel )
Champ facultatif utilisé pour limiter les processus renvoyés à ceux ayant l'un des niveaux d'accès utilisateur spécifiés.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]