Method: admin.chrome.v1.customers.chrome.printers.printJobs.list

인쇄 작업을 나열합니다.

HTTP 요청

GET https://admin.googleapis.com/admin/chrome/v1/{parent=customers/*/chrome/printers/*}/printJobs

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 이 인쇄 작업 컬렉션을 소유한 상위 요소입니다. 형식: customer/{customer-id}/chrome/printers/{printer-id} 모든 프린터의 인쇄 작업을 나열하려면 프린터 ID를 -로 설정할 수 있습니다.

쿼리 매개변수

매개변수
pageSize

integer

페이지의 인쇄 작업 수(0~100 포함)입니다. pageSize를 지정하지 않거나 0으로 지정하면 크기가 50이 됩니다.
pageToken

string

이전 printJobs.list 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 생략하면 결과의 첫 번째 페이지가 반환됩니다.

페이지를 매길 때 printJobs.list에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.
filter

string

결과를 필터링할 쿼리 문자열 및 EBNF 구문의 AND 필드

이 필터에서는 OR 연산이 지원되지 않습니다. completionTime에는 >= 및 <= 비교 연산자만 지원됩니다. userEmail 및 orgUnitId에만 지원되는 비교 연산자입니다. userEmail 또는 orgUnitId로 필터링은 {printer-id}이 '-'인 경우에만 지원됩니다. orgUnitId은 상위 프린터의 orgUnitId 필드를 나타냅니다.

지원되는 필터 필드는 다음과 같습니다.

  • completionTime
  • orgUnitId
  • userEmail
orderBy

string

결과를 정렬하는 데 사용되는 필드입니다. 지정하지 않으면 결과가 completionTime를 기준으로 정렬됩니다.

필드별 지원되는 순서:

  • device
  • pageCount
  • creationTime
  • completionTime
  • status
  • printer
  • userEmail
  • title
  • color
  • duplex

요청 본문

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

응답 본문

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

인쇄 작업 목록이 포함된 응답입니다.

JSON 표현 
{
  "printJobs": [
    {
      object (PrintJob)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
필드
printJobs[]

object (PrintJob)

요청된 인쇄 작업 목록입니다.
nextPageToken

string

후속 요청에서 다음 페이지를 검색하는 데 사용할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.
totalSize

integer

총 검색결과 수입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/admin.chrome.printers
  • https://www.googleapis.com/auth/admin.chrome.printers.readonly

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

인쇄 작업

PrintJob은 프린터로 제출된 문서를 인쇄하기 위한 요청을 나타냅니다.

JSON 표현 
{
  "name": string,
  "title": string,
  "state": enum (State),
  "creationTime": string,
  "completionTime": string,
  "pageCount": integer,
  "color": enum (ColorMode),
  "duplex": enum (DuplexMode),
  "mediaSize": {
    object (MediaSize)
  },
  "copyCount": integer,
  "printerId": string,
  "printer": string,
  "userId": string,
  "userEmail": string,
  "deviceId": string
}
필드
name

string

인쇄 작업의 리소스 이름입니다. 형식: customers/{customer-id}/printers/{printer-id}/printJobs/{print-job-id}
title

string

문서의 제목입니다.
state

enum (State)

작업의 최종 상태입니다.
creationTime

string (Timestamp format)

인쇄 작업 생성 타임스탬프

RFC3339 UTC 'Zulu' 형식의 타임스탬프(나노초 해상도 및 최대 9자리 소수) 예: "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z".
completionTime

string (Timestamp format)

인쇄 작업 완료 타임스탬프

RFC3339 UTC 'Zulu' 형식의 타임스탬프(나노초 해상도 및 최대 9자리 소수) 예: "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z".
pageCount

integer

문서의 페이지 수입니다.
color

enum (ColorMode)

색상 모드
duplex

enum (DuplexMode)

듀플렉스 모드입니다.
mediaSize

object (MediaSize)

인쇄 작업 미디어 크기
copyCount

integer

사본 수
printerId

string

프린터 API ID입니다.
printer

string

인쇄에 사용된 프린터의 이름입니다.
userId

string

인쇄 작업을 제출한 사용자의 고유한 Directory API ID입니다.
userEmail

string

인쇄 작업을 제출한 사용자의 기본 이메일 주소입니다.
deviceId

string

인쇄 작업을 제출하는 데 사용된 기기의 고유한 Directory API ID입니다.

상태

인쇄 작업의 상태입니다.

열거형
STATE_UNSPECIFIED 인쇄 작업이 지정되지 않은 상태입니다.
STATE_PRINTED 문서가 인쇄되었습니다.
STATE_CANCELED 인쇄 작업이 취소되었습니다.
STATE_FAILED 인쇄 작업에 실패했습니다.

색상 모드

인쇄 작업 컬러 모드

열거형
COLOR_MODE_UNSPECIFIED 지정되지 않았습니다.
COLOR_MODE_BLACK_AND_WHITE 흑백
COLOR_MODE_COLORED 컬러

듀플렉스 모드

인쇄 작업 양면 모드입니다.

열거형
DUPLEX_MODE_UNSPECIFIED 지정되지 않았습니다.
DUPLEX_MODE_ONE_SIDED 단측
DUPLEX_MODE_TWO_SIDED_LONG_EDGE 양면이 긴 가장자리를 넘기기
DUPLEX_MODE_TWO_SIDED_SHORT_EDGE 짧은 면이 양면 전환.

미디어 크기

인쇄 작업 미디어 크기

JSON 표현 
{
  "width": integer,
  "height": integer,
  "vendorId": string
}
필드
width

integer

너비 (마이크로미터)
height

integer

높이 (마이크로미터)
vendorId

string

공급업체 제공 ID(예: iso_a3_297x420mm 또는 na_index-3x5_3x5in) 가능한 값은 media IPP 속성의 값입니다. 자세한 내용은 IPP 등록을 참고하세요.