Method: customers.reports.countPrintJobsByUser

取得每位使用者執行的列印作業摘要。

HTTP 要求

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

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

路徑參數

參數
customer

string

必要欄位。客戶 ID 前置字串為「customers/」或「customers/my_customer」,可使用與提出要求的帳戶相關聯的客戶。

查詢參數

參數
printerOrgUnitId

string

印表機的機構單位 ID。如果指定這個值,系統只會計算透過指定機構單位的印表機啟動的列印工作。如果省略,系統會計算所有列印工作。

pageSize

integer

要傳回的結果數上限。最大值和預設值為 100。

pageToken

string

用於指定要傳回回應頁面的權杖。

filter

string

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

注意:這個篩選器不支援 OR 作業。注意:這個篩選器僅支援 >= 和 <= 比較運算子。

支援的篩選器欄位:

  • completeTime
orderBy

string

用於排序結果的欄位。如果省略此引數,結果會依「userEmail」欄位遞增排序。

支援的 orderBy 欄位:

  • userEmail
  • jobCount
  • printerCount
  • deviceCount

要求主體

要求主體必須為空白。

回應主體

回應含有摘要列印報告,適用於在要求的時間間隔內,透過指定機構單位的印表機啟動列印工作的使用者。

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

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

object (UserPrintReport)

符合要求的 UserPrintReports 清單。

nextPageToken

string

用於要求下一頁的分頁權杖。

totalSize

string (int64 format)

符合要求的使用者總數。

授權範圍

需要下列 OAuth 範圍:

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

UserPrintReport

報表 reports.countPrintJobsByUser 包含使用者的列印統計資料。包含印表機數量、用於啟動列印工作的裝置數量,以及啟動的列印工作數量。

JSON 表示法
{
  "userId": string,
  "userEmail": string,
  "jobCount": string,
  "printerCount": string,
  "deviceCount": string
}
欄位
userId

string

使用者的專屬 Directory API ID。

userEmail

string

使用者的主要電子郵件地址。

jobCount

string (int64 format)

使用者啟動的列印工作數量。

printerCount

string (int64 format)

使用者使用的印表機數量。

deviceCount

string (int64 format)

使用者用來啟動列印工作的 Chrome 裝置數。