Method: customers.reports.enumeratePrintJobs

Nhận 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

Các tham 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 gửi yêu cầu.

Tham số truy vấn

Các tham số
printerOrgUnitId

string

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

integer

Số lượng lệnh in trên trang từ 0 đến 100. Nếu pageSize không được chỉ định 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 mã này để truy xuất trang tiếp theo. Nếu bỏ qua, trang kết quả đầu tiên sẽ được trả về.

Khi phân trang, tất cả các thông 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 trong cú pháp EBNF.

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

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

  • completeTime
  • printerId
  • userId
orderBy

string

Trường được dùng để sắp xếp kết quả. Nếu bạn không chỉ định, các kết quả sẽ được sắp xếp theo thứ tự giảm dần trong trường completeTime.

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

  • tiêu đề
  • state
  • 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
}
Các trường
printJobs[]

object (PrintJob)

Danh sách 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ì không có trang tiếp theo nào.
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

Đại diện cho yêu cầu in tài liệu đã được gửi tới 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
}
Các 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, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "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, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "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ế độ Duplex.
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 được dùng để in.
userEmail

string

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

string

Mã 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 Đã in tài liệu thành công.
CANCELLED Lệnh in đã bị huỷ.
FAILED Lệnh in không thành công.

ColorMode

Chế độ màu cho 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.

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