Method: processes.list

프로세스 유형 및 현재 상태와 같이 사용자가 하거나 사용자를 대신하여 수행하는 프로세스에 관한 정보를 나열합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
userProcessFilter

object (ListUserProcessesFilter)

목록 결과를 제한하는 데 사용되는 필터입니다. 필터 기준과 일치하는 프로세스만 반환됩니다.

pageSize

integer

결과 페이지당 반환되는 최대 프로세스 수입니다. 기본값은 50입니다.

pageToken

string

다음 페이지에서 이전 목록 요청을 계속하기 위한 토큰입니다. 이 값은 이전 응답의 nextPageToken 값으로 설정해야 합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

Process 리소스 목록에 대한 응답입니다.

JSON 표현
{
  "processes": [
    {
      object (Process)
    }
  ],
  "nextPageToken": string
}
필드
processes[]

object (Process)

요청 매개변수와 일치하는 프로세스의 목록입니다.

nextPageToken

string

다음 결과 페이지의 토큰입니다. 비어 있으면 더 이상 남은 페이지가 없습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListUserProcessesFilter

나열할 프로세스를 추가로 지정하는 데 사용되는 필터입니다. 지정된 모든 조건과 일치하는 프로세스만 반환됩니다.

JSON 표현
{
  "scriptId": string,
  "deploymentId": string,
  "projectName": string,
  "functionName": string,
  "startTime": string,
  "endTime": string,
  "types": [
    enum (ProcessType)
  ],
  "statuses": [
    enum (ProcessStatus)
  ],
  "userAccessLevels": [
    enum (UserAccessLevel)
  ]
}
필드
scriptId

string

반환되는 프로세스를 특정 스크립트 ID가 있는 프로젝트에서 발생한 프로세스로 제한하는 데 사용되는 선택적 필드입니다.

deploymentId

string

반환되는 프로세스를 특정 배포 ID가 있는 프로젝트에서 시작된 프로세스로 제한하는 데 사용되는 선택적 필드입니다.

projectName

string

반환되는 프로세스를 프로젝트 이름에 특정 문자열이 포함된 프로젝트에서 시작된 프로세스로 제한하는 데 사용되는 선택적 필드입니다.

functionName

string

반환되는 프로세스를 지정된 함수 이름의 스크립트 함수에서 발생한 프로세스로 제한하는 데 사용되는 선택적 필드입니다.

startTime

string (Timestamp format)

반환되는 프로세스를 지정된 타임스탬프 또는 그 이후에 시작된 프로세스로 제한하는 데 사용되는 선택적 필드입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

endTime

string (Timestamp format)

반환되는 프로세스를 지정된 타임스탬프 또는 그 이전에 완료된 프로세스로 제한하는 데 사용되는 선택적 필드입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

types[]

enum (ProcessType)

반환되는 프로세스를 지정된 프로세스 유형 중 하나가 있는 프로세스로 제한하는 데 사용되는 선택적 필드입니다.

statuses[]

enum (ProcessStatus)

반환되는 프로세스를 지정된 프로세스 상태 중 하나가 있는 프로세스로 제한하는 데 사용되는 선택적 필드입니다.

userAccessLevels[]

enum (UserAccessLevel)

반환되는 프로세스를 지정된 사용자 액세스 수준 중 하나가 있는 프로세스로 제한하는 데 사용되는 선택적 필드입니다.