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)

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