Method: customers.reports.enumeratePrintJobs

Lấy danh sách các lệnh in.

Yêu cầu HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:enumeratePrintJobs

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

Tham số đường dẫn

Tham số
customer

string

Bắt buộc. Mã khách hàng có tiền tố "customers/" hoặc "customers/my_customer" để sử dụng khách hàng được liên kết với tài khoản đưa ra yêu cầu.

Tham số truy vấn

Thông số
printerOrgUnitId

string

Mã nhận dạng của đơn vị tổ chức cho máy in. Nếu được chỉ định, chỉ những lệnh in được gửi đến máy in từ đơn vị tổ chức được chỉ định mới được trả về.
pageSize

integer

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

string

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

Khi phân trang, tất cả các tham số khác được cung cấp cho reports.enumeratePrintJobs 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 AND theo cú pháp EBNF.

Lưu ý: Bộ lọc này không hỗ trợ các thao tác OR. Lưu ý: Chỉ các bộ so sánh >= và <= được hỗ trợ cho completeTime. Lưu ý: Chỉ hỗ trợ bộ so sánh = cho userId và printerId.

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

  • completeTime
  • printerId
  • userId
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 thứ tự giảm dần của trường completeTime.

Các trường được hỗ trợ để sắp xếp theo:

  • tiêu đề
  • tiểu bang
  • createTime
  • completeTime
  • documentPageCount
  • colorMode
  • duplexMode
  • máy in
  • userEmail

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

Phản hồi chứa danh sách các lệnh in.

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:

Biểu diễn dưới dạng JSON 
{
  "printJobs": [
    {
      object (PrintJob)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
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 bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.
totalSize

string (int64 format)

Tổng số lệnh in trùng khớp với yêu cầu.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

PrintJob

Biểu thị một 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 
{
  "id": string,
  "title": string,
  "state": enum (State),
  "createTime": string,
  "completeTime": string,
  "documentPageCount": integer,
  "colorMode": enum (ColorMode),
  "duplexMode": enum (DuplexMode),
  "copyCount": integer,
  "printerId": string,
  "printer": string,
  "userEmail": string,
  "userId": string
}
Trường
id

string

Mã nhận dạng riêng biệt của lệnh in.
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.
createTime

string (Timestamp format)

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

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
completeTime

string (Timestamp format)

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

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
documentPageCount

integer

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

enum (ColorMode)

Chế độ màu.
duplexMode

enum (DuplexMode)

Chế độ song công.
copyCount

integer

Số lượng bản sao.
printerId

string

Mã API của máy in được dùng để in.
printer

string

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

string

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

string

Mã nhận dạng Directory API duy nhất của người 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.
PRINTED Tài liệu đã được in thành công.
CANCELLED Lệnh in đã bị huỷ.
FAILED Không thực hiện được lệnh in.

ColorMode

Chế độ màu của lệnh in.

Enum
COLOR_MODE_UNSPECIFIED Không xác định.
BLACK_AND_WHITE Đen trắng.
COLOR Màu sắc.

DuplexMode

Chế độ in hai mặt của lệnh in.

Enum
DUPLEX_MODE_UNSPECIFIED Không xác định.
ONE_SIDED Một mặt.
TWO_SIDED_LONG_EDGE Lật hai mặt theo cạnh dài.
TWO_SIDED_SHORT_EDGE Lật hai mặt theo cạnh ngắn.