Method: processes.list

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.