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

Lệnh in danh sách.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
parent

string

Bắt buộc. Công ty mẹ sở hữu bộ sưu tập các lệnh in này. Định dạng: customer/{customer-id}/chrome/printers/{printer-id} Mã máy in có thể là - để liệt kê các lệnh in trên tất cả máy in.

Tham số truy vấn

Các tham số
pageSize

integer

Số lượng lệnh in trong trang từ 0 đến 100, nếu pageSize không được chỉ định hoặc bằng 0, thì kích thước là 50.
pageToken

string

Một mã thông báo trang nhận được từ một lệnh gọi printJobs.list trước đó. Hãy cung cấp thông tin này để truy xuất trang tiếp theo. Nếu bỏ qua thì trang kết quả đầu tiên sẽ được trả về.

Khi phân trang, tất cả thông số khác được cung cấp cho printJobs.list phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
filter

string

Chuỗi truy vấn để lọc kết quả, các trường được phân tách bằng VÀ trong cú pháp EBNF.

Không hỗ trợ toán tử OR trong bộ lọc này. Chỉ hỗ trợ trình so sánh >= và <= so sánh cho completionTime. Chỉ = trình so sánh được hỗ trợ cho userEmail và orgUnitId. Bộ lọc theo userEmail hoặc orgUnitId chỉ được hỗ trợ khi {printer-id} là '-'. orgUnitId đề cập đến trường orgUnitId của máy in mẹ.

Các trường bộ lọc được hỗ trợ:

  • completionTime
  • orgUnitId
  • userEmail
orderBy

string

Trường dùng để sắp xếp kết quả. Nếu bạn không chỉ định, kết quả sẽ được sắp xếp theo completionTime.

Thứ tự được hỗ trợ theo trường:

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

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Câu trả lời chứa danh sách các lệnh in.

Biểu diễn dưới dạng JSON 
{
  "printJobs": [
    {
      object (PrintJob)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Các trường
printJobs[]

object (PrintJob)

Danh sách các lệnh in được yêu cầu.
nextPageToken

string

Một mã thông báo có thể được dùng trong yêu cầu tiếp theo để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua, thì sẽ không có trang nào tiếp theo.
totalSize

integer

Tổng số kết quả.

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

Lệnh in

PrintJob thể hiện yêu cầu in tài liệu đã được gửi đến máy in.

Biểu diễn dưới dạng 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
}
Các trường
name

string

Tên tài nguyên của lệnh in. Định dạng customers/{customer-id}/printers/{printer-id}/printJobs/{print-job-id}
title

string

Tiêu đề của tài liệu.
state

enum (State)

Trạng thái cuối cùng của công việc.
creationTime

string (Timestamp format)

Dấu thời gian tạo lệnh in.

Dấu thời gian ở định dạng "RFC" RFC3339 UTC, với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
completionTime

string (Timestamp format)

Dấu thời gian hoàn thành lệnh in.

Dấu thời gian ở định dạng "RFC" RFC3339 UTC, với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
pageCount

integer

Số trang trong tài liệu.
color

enum (ColorMode)

Chế độ màu.
duplex

enum (DuplexMode)

Chế độ Duplex.
mediaSize

object (MediaSize)

Kích thước phương tiện của lệnh in.
copyCount

integer

Số bản sao.
printerId

string

Mã API máy in.
printer

string

Tên của máy in dùng để in.
userId

string

Mã Directory API duy nhất của người dùng đã gửi lệnh in.
userEmail

string

Địa chỉ email chính của người dùng đã gửi lệnh in.
deviceId

string

Mã Directory API duy nhất của thiết bị đã được dùng để gửi lệnh in.

Tiểu bang

Trạng thái của lệnh in.

Enum
STATE_UNSPECIFIED Lệnh in đang ở trạng thái không xác định.
STATE_PRINTED Đã in tài liệu thành công.
STATE_CANCELED Lệnh in đã bị hủy.
STATE_FAILED Không in được.

Chế độ màu

Chế độ màu in.

Enum
COLOR_MODE_UNSPECIFIED Không xác định.
COLOR_MODE_BLACK_AND_WHITE Đen và trắng.
COLOR_MODE_COLORED Có màu.

Chế độ Duplex

In chế độ Duplex.

Enum
DUPLEX_MODE_UNSPECIFIED Không xác định.
DUPLEX_MODE_ONE_SIDED Một mặt.
DUPLEX_MODE_TWO_SIDED_LONG_EDGE Lật hai mặt trên cạnh dài.
DUPLEX_MODE_TWO_SIDED_SHORT_EDGE Lật hai mặt trên cạnh ngắn.

Kích thước Media

Kích thước phương tiện của lệnh in.

Biểu diễn dưới dạng JSON 
{
  "width": integer,
  "height": integer,
  "vendorId": string
}
Các trường
width

integer

Chiều rộng (tính bằng micromet).
height

integer

Chiều cao (tính bằng micromet).
vendorId

string

Mã do nhà cung cấp cung cấp – ví dụ: iso_a3_297x420mm hoặc na_index-3x5_3x5in. Các giá trị có thể là giá trị của thuộc tính IPP media. Để biết thêm thông tin, hãy xem phần Đăng ký IPP.