Method: processes.list

Enumera la 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 mostrados por página de resultados. La configuración predeterminada es 50.

pageToken

string

El token para continuar con una solicitud de lista anterior en la página siguiente. Esto debe configurarse 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 de la página siguiente de resultados. Si está vacía, 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.

Filtro de usuarios de listas

El filtro que se utiliza para especificar con más detalle qué procesos enumerar. 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 que se muestran a aquellos que se originan en proyectos con un ID de secuencia de comandos específico.

deploymentId

string

Campo opcional que se utiliza 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 utiliza para limitar los procesos mostrados a aquellos que se originan a partir de 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 especificada.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos decimales. 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 determinada o antes.

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

types[]

enum (ProcessType)

Campo opcional que se utiliza 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 utiliza para limitar los procesos mostrados a aquellos que tengan uno de los estados de proceso especificados.

userAccessLevels[]

enum (UserAccessLevel)

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