Method: customers.reports.enumeratePrintJobs

取得列印工作清單。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customer

string

必要欄位。客戶 ID 開頭為「customers/」或「customers/my_customer」使用與提出要求之帳戶相關聯的客戶。

查詢參數

參數
printerOrgUnitId

string

印表機的機構單位 ID。指定後，系統只會傳回傳送到指定機構單位的印表機提交的列印工作。
pageSize

integer

頁面中的列印工作數量，介於 0 至 100 (含 0 和 100) 之間 (如未指定 pageSize 或為 0，則大小為 50)。
pageToken

string

接收自前一個 reports.enumeratePrintJobs 呼叫的網頁權杖。提供此項目即可擷取後續網頁。如果省略此標記，系統會傳回第一頁的結果。

進行分頁時，提供至 reports.enumeratePrintJobs 的所有其他參數須與提供網頁權杖的呼叫相符。
filter

string

篩選結果的查詢字串，以及採用 EBNF 語法的「AND」分隔欄位。

注意：這個篩選器不支援 OR 作業。注意：completeTime 僅支援 >= 和 <= 比較子。注意：只有 = 支援 userId 和 printerId 的比較子。

支援的篩選器欄位：

  • completeTime
  • printerId
  • userId
orderBy

string

用來排序結果的欄位。如未指定，結果將按 completeTime 欄位的遞減順序排序。

支援的欄位順序：

  • title
  • 州
  • createTime
  • completeTime
  • documentPageCount
  • colorMode
  • duplexMode
  • 印表機
  • userEmail

要求主體

要求主體必須為空白。

回應主體

包含列印工作清單的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "printJobs": [
    {
      object (PrintJob)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
欄位
printJobs[]

object (PrintJob)

要求的列印工作清單。
nextPageToken

string

權杖，可用於後續要求以擷取下一頁。如果省略這個欄位，就不會有後續頁面。
totalSize

string (int64 format)

符合要求的列印工作總數。

授權範圍

需要下列 OAuth 範圍：

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

PrintJob

代表已提交文件的印表機列印要求。

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
}
欄位
id

string

列印工作的專屬 ID。
title

string

文件的標題。
state

enum (State)

工作的最終狀態。
createTime

string (Timestamp format)

列印工作建立時間戳記。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
completeTime

string (Timestamp format)

列印工作完成時間戳記。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
documentPageCount

integer

文件的頁數。
colorMode

enum (ColorMode)

色彩模式。
duplexMode

enum (DuplexMode)

雙面模式，
copyCount

integer

份數。
printerId

string

列印用印表機的 API ID。
printer

string

用於列印的印表機名稱。
userEmail

string

提交列印工作的使用者主要電子郵件地址。
userId

string

提交列印工作的使用者專屬 Directory API ID。

州

列印工作的狀態。

列舉
STATE_UNSPECIFIED 列印工作處於未指定的狀態。
PRINTED 文件已成功列印。
CANCELLED 列印工作已取消。
FAILED 列印工作失敗。

ColorMode

列印工作顏色模式。

列舉
COLOR_MODE_UNSPECIFIED 未指明
BLACK_AND_WHITE 黑色和白色。
COLOR 顏色。

DuplexMode

列印工作雙面模式。

列舉
DUPLEX_MODE_UNSPECIFIED 未指明
ONE_SIDED 單面。
TWO_SIDED_LONG_EDGE 在長邊翻面的雙面翻轉效果。
TWO_SIDED_SHORT_EDGE 在短邊翻面的雙面翻轉效果。