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

Thông số
customer

string

Bắt buộc. Mã khách hàng có tiền tố là "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 bạn chỉ định, hệ thống sẽ chỉ trả về các lệnh in được gửi đến máy in trong đơn vị tổ chức được chỉ định.

pageSize

integer

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

pageToken

string

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

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 dấu AND bằng cú pháp EBNF.

Lưu ý: Bộ lọc này không hỗ trợ phép toán OR. Lưu ý: Chỉ hỗ trợ các bộ so sánh >= và <= cho completeTime. Lưu ý: Chỉ hỗ trợ bộ so sánh = cho userIdprinterId.

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ợ theo thứ tự:

  • 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ông việc 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ã 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 tiếp theo.

totalSize

string (int64 format)

Tổng số lệnh in 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ị yêu cầu in một 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 duy nhấ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.

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

completeTime

string (Timestamp format)

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

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

documentPageCount

integer

Số trang trong tài liệu.

colorMode

enum (ColorMode)

Chế độ màu.

duplexMode

enum (DuplexMode)

Chế độ hai mặt.

copyCount

integer

Số lượng bản sao.

printerId

string

Mã API của máy in 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 công việc in.

Tiểu bang

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

Enum
STATE_UNSPECIFIED Công việc in đang ở trạng thái không xác định.
PRINTED Tài liệu đã được in thành công.
CANCELLED Đã huỷ lệnh in.
FAILED Không in được công việc.

ColorMode

Chế độ màu của công việc 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.

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