Method: processes.list

Detalla información sobre los procesos realizados por un usuario o en su nombre, como el tipo de proceso y el estado actual.

Solicitud HTTP

GET https://script.googleapis.com/v1/processes

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
userProcessFilter

object (ListUserProcessesFilter)

Un filtro que se usa para limitar los resultados de la lista; solo se muestran los procesos que coinciden con los criterios de filtro.

pageSize

integer

La cantidad máxima de procesos que se muestran por página de resultados. La configuración predeterminada es 50.

pageToken

string

El token para continuar una solicitud de lista anterior en la página siguiente. Se debe establecer en el valor de nextPageToken de una respuesta anterior.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Respuesta con la lista de recursos Process.

Representación JSON
{
  "processes": [
    {
      object (Process)
    }
  ],
  "nextPageToken": string
}
Campos
processes[]

object (Process)

Lista de procesos que coinciden con los parámetros de solicitud.

nextPageToken

string

Token para la siguiente página de resultados. Si está vacío, no quedan más páginas.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/script.processes

Para obtener más información, consulta la Descripción general de OAuth 2.0.

ListUserProcessesFilter

Es el filtro que se usa para especificar aún más los procesos que se enumerarán. Solo se muestran los procesos que coinciden con todas las condiciones especificadas.

Representación JSON
{
  "scriptId": string,
  "deploymentId": string,
  "projectName": string,
  "functionName": string,
  "startTime": string,
  "endTime": string,
  "types": [
    enum (ProcessType)
  ],
  "statuses": [
    enum (ProcessStatus)
  ],
  "userAccessLevels": [
    enum (UserAccessLevel)
  ]
}
Campos
scriptId

string

Campo opcional que se usa para limitar los procesos mostrados a aquellos que se originan en proyectos con un ID de secuencia de comandos específico.

deploymentId

string

Campo opcional que se usa para limitar los procesos mostrados a aquellos que se originan en proyectos con un ID de implementación específico.

projectName

string

Campo opcional que se usa para limitar los procesos mostrados a aquellos que se originan en proyectos con nombres de proyecto que contienen una string específica.

functionName

string

Campo opcional que se usa para limitar los procesos mostrados a aquellos que se originan en una función de secuencia de comandos con el nombre de función dado.

startTime

string (Timestamp format)

Campo opcional que se usa para limitar los procesos mostrados a aquellos que se iniciaron a partir de la marca de tiempo determinada.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Campo opcional que se usa para limitar los procesos mostrados a aquellos que se completaron en la marca de tiempo dada o antes.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

types[]

enum (ProcessType)

Campo opcional que se usa para limitar los procesos que se muestran a aquellos que tienen uno de los tipos de procesos especificados.

statuses[]

enum (ProcessStatus)

Campo opcional que se usa para limitar los procesos mostrados a aquellos que tienen uno de los estados de proceso especificados.

userAccessLevels[]

enum (UserAccessLevel)

Campo opcional que se usa para limitar los procesos mostrados a aquellos que tienen uno de los niveles de acceso de usuario especificados.